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Anarch 
mods/procedual_assets.diff 


This is a mod that replaces assets (images and sounds) with procedurally take more RAM. Makefile is also modified to optimize for lowest size and 
generated ones, making the game really small, but also looking a bit worse and self-compress the executable, which with the gcc compiler achieved size under 60 


1 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); Anarch 


kb. By drummyfish, released under CCO, public domain. 


diff --git a/game.h b/game.h 

index 24285cb..b8bdb20 100755 

--- a/game.h 

+++ b/game.h 

a -1685,6 +1685,8 @@ void SFG_init() 


SFG_LOG("initializing game") 
+ SFG_generateImages(); 


SFG_game.frame_= 0; 

SFG game.frameTime = 0; 

SFG game.currentRandom - 0; 
diff --git a/images.h b/images.h 
index 8f88bcc..949d929 100644 
--- a/images.h 
+++ b/images.h 
@@ -22,7 *22,7 @@ 


#define SFG TEXTURE SIZE 32 


-#define SFG TEXTURE STORE SIZE (16 + (SFG TEXTURE SIZE * SFG TEXTURE SIZE) / 2) 
+#define SFG TEXTURE STORE SIZE (SFG TEXTURE SIZE * SFG TEXTURE SIZE) 


yee 
Color index which will in textures and sprites be considered transparent. 

@@ GNU «39,39 @@ static inline uint8 t SFG getTexel(const uint8 t *texture, uint8 t x, 

üint8 t y 


return SFG PROGRAM MEMORY U8(texture + 
((SFG PROGRAM MEMORY U8(texture + 16 + (x * SFG TEXTURE SIZE + y) / 2) >> 
4 *(y*2 0))) & 0x0f)); 
return SFG PROGRAM MÉMORY U8(texture + y * SFG TEXTURE SIZE + x); 


hiya 
- 


#define SFG WALL TEXTURE COUNT 16 


-SFG PROGRAM MEMORY uint8 t 

-  SFG wallTextures[SFG WALL TEXTURE COUNT * SFG TEXTURE STORE SIZE] = 

4, 0, white wooden planks 

-4,21,5,3,20,0,2, 26, 6,18, 57,65, 1, 16, 17, 49, 0, 1, 0, 3, 32, 1, 33, 0, 161, 64, 1, 16, 64, 3, 3, 
-32,0,17,16,9,32, 1, 17, 1,161, 65, 1, 16, 78, 132, 35, 32, 0, 17,16, 7, 32, 1, 32, 17, 240, 49, 0, 
-16,57,99,87, 206, 0, 18, 16, 6, 33, 0, 16, 1, 177, 48,0, 0, 97,0, 2, 0, 0, 17, 32, 6, 32, 1,0, 1, 178, 
-48,0,0, 48,0, 2,0, 0, 17, 32, 7, 32, 17, 1,0, 178, 48, 1, 0, 49, 0, 1, 0, 0, 1, 16, 3, 32, 18, 0, 0, 194, 


-48,0,0, 48, 0, 18, 4, 64, 17, 32, 4, 35, 0, 3, 0,194, 48, 0,0, 49, 0, 34, 4,0, 17, 32, 6, 130, 50, 32, 

-40,242, 48, 1,0, 49,0, ,0, 2, 32, 12, 85, 85, 85, 85, 81, 48, 2,0, 49,0, 33, 3, 0, 2,16, 3, 32, 0, 
-32, 2, 98, 48, 1,0, 49,0, 34, 19,0, 18, 17, 3, 32,0, 32,0, 194, 48, 2,0,0, 0, 34, 3, 4, 2, 16, 3, 16, 0, 
-32, 32, 226, 48, 2, 0, 48,0, 33,19, 0, 18, 33, 3,0, 16, 32, 32, 178, 48, 1, 1, 50, 1, 34, 3, 4, 17, 16,3 
-0, 16, 32, 16, 162, 48, 1,64, 50, 1, 34, 7, 3, 1, 17, 3, 0, 16, 32, 16, 184, 2, 2, 2, 2, 48, 18, 3, 0, 0, 17, 
-3,0,17, 32, 16, 94,93, 93,89, 112,0,18, 3,0, 0, 16, 3,0, 2, 32, 16, 48, 48, 48, 3,0, 0, 17, 4,0, 0, 
-17,3,0,1, 32,16, 48, 48,0, 3, 1, 1, 18, 3,0, 0, 32, 7, 16, 1, 32, 16, 48,0, 1, 0, 1, 50, 34, 3,0, 1, 33, 
-3,16,1, 20, 32,112, 48,0, 16, 1, 49, 34, 3, 64, 16, 33, 3, 4, 2, 4, 16, 48, 49, 0, 16, 0, 49, 34,3, 64, 
-0, 32, 3,16, 1,0,0, 48, 49, 0, 16, 65, 48, 34, 3, 49, 0, 17, 3, 16, 2, 0, 0, 48, 49, 1, 32, 0, 49, 34, 3, 

-64, 0, 16, 19, 16, 2, 1,0, 113, 49, 17, 16, 0, 48, 32, 3, 0,0, 16, 19, 16, 1, 2,0, 97, 66, 17, 32, 64, 48, 
-33,19,34,2, 0,137, 16, 1, 18,0, 97, 49, 17,16, 66, 64, 32, 3, 84, 212, 105, 69, 16, 1, 17, 0, 97, 49, 
-18, 16, 50, 48, 16, 19, 51, 48, 51, 51, 16, 1, 16, 0, 98, 50, 1, 19, 66, 48, 32, 3,0, 1,0, 3,32, 1, 33,0 
-177, 49, 2,16, 66, 64, 16, 3,0, 1, 0, 7, 32, 1, 16, 1, 82, 64, 1, 16, 50, 0, 16, 35,0, 1,0, 9, 33,2, 32, 


-0,161,64,1,20,48,0,0,32 
-, // 1, Skyscraper window 

-4,5,3,6,2,81, 0,59, 48, 128, 138, 131, 66, 44, 137, 129, 16, 176, 208, 176, 44, 33,0,0, 1, 43,1 
-13, 6, 52,28,0,0,176,0, 0,12, 64,0, 17,0, 32, 0, 17, 1, 32, 13, 11, 0, 176,0, 208, 4,65, 0,0, 0, 
-34, 1,16, 1, 32, 16, 0, 23, 32,0, 2, 40, 66, 2, 194, 230, 140, 34, 208, 2, 176, 17,0, 119, 76, 66, 34, 
-34, 34, 34, 34, 34, 34, 34, 84, 34, 116, 64, 0, 72, 194, 51, 51, 51, 51, 17, 49, 51, 19, 19, 49, 51, 12, 
-34, 36, 17, 210, 49, 17, 16, 17,1, 17, 17, 16, 17, 1, 17, 42, 1, 17, 17, 2, 49, 154, 116, 244, 229, 164, 
-235,85, 49, 16, 17,14, 1, 16, 2, 69, 17, 104, 79, 117, 149, 88, 94, 137, 49, 17, 17, 36, 0, 0, 196, 69, 
-48, 137,119, 69, 84, 79, 88, 85, 49, 17, 1, 4, 92, 244, 0, 34, 0, 69, 85, 95,127, 116, 86, 89, 49, 17, 
-17,36,0,0,17,32,1,169,88, 229, 228, 74, 85, 85, 49, 19, 1, 4,0, 0,0, 2, 49, 90, 153, 85, 85, 169, 
-95,85, 49,16, 17, 4, 2, 0,0, 39, 48, 68, 85, 233, 138, 37, 133, 136, 49, 17, 17, 36,0, 32,0, 4, 17 
-122, 150, 84, 133, 250, 136, 136, 49, 1, 17, 10, 0,0, 0, 44, 48, 35, 51, 51, 51, 51, 51, 35, 49, 17, 1, 
-66,0,13,0, 4, 17, 51, 3, 211, 3, 3, 35, 2, 49, 17, 17, 34, 0, 0,0, 37, 49, 167, 42, 70, 106, 69, 102, 
-102,49,0,17,36, 2, 34, 68, 244, 48, 39, 119, 79, 69, 150, 102, 102, 49, 17, 17, 68, 64, 34, 16, 76, 
-49,119,2,127,120,102,102,102,49,17,19,5,0, 1,1, 74, 49, 114, 119, 4, 152, 102, 104, 102 
-49,17,17,75,0,0, 208, 28, 49, 119, 39, 116, 248, 104, 134, 102, 49, 16, 17, 34, 0, 0, 0, 10, 17, 39, 
-114, 37,169, 104, 136, 86, 49, 16, 17, 4,0,0, 1, 43, 49, 114, 126, 232, 74, 102, 104, 134, 49,1, 0, 
-34,0, 32,0, 116,17, 119,122, 102,88, 102, 102, 102, 49, 16, 17, 66,0,0, 1, 36, 49, 17, 17, 17, 17, 
-37,17,17,1,1,1,64,0,0, 32, 184, 49, 17, 49, 17, 17, 19, 51, 17, 17, 17, 19, 178, 0, 34, 44, 66, 34, 
-71,39, 34, 180, 36, 66, 34, 2, 32, 32, 192,17, 19,66, 192, 0, 16, 176, 66, 34, 34, 34, 200, 36, 34, 
-34,36, 68, 44, 221, 192, 0, 0, 10, 32, 0, 16, 1, 34, 16, 16,0, 11, 0, 16, 13, 64, 0, 0, 10, 0,0, 0, 1, 34, 

0,11,33,0, 17,0, 112,0, 1, 17,113, 16,0 
7/5 pink high-tech wall 


-160,17,17,17,17,34,34, 32, 34, 42, 34, 170, 2, 42, 42, 170, 170, 17 , 17, 17, 17, 34, 34, 34, 36, 
-34, 160, 36, 32, 160, 160, 42,10, 49, 17, 17, 17, 34, 34, 34, 42, 34, 0,0, 0, 0, 0,0, 4, 49, 49, 17, 17, 
-34, 34, 2, 10, 36, 32, 17, 17, 81, 17, 81, 23,59, 59, 59, 17,0,0,0,0, 2,0, 84, 84, 06, 0, 0, 0, 59, 59 
-49, 19, 102,102, 102, 102, 96, 32, 20, 86, 0, 102, 102, 102, 145, 59, 59,19, 34, 34, 34, 36, 96, 32, 
-21,86,5,85,85,23,59,59, 49, 19, 34, 34, 34, 42, 96, 64, 21, 86, 5, 85, 69, 71, 145, 155, 49, 49, 
-34, 34, 66, 37, 96, 128, 84, 86, 5, 85, 91, 23, 49, 49, 49, 19, 34, 34, 0,0, 0,0, 0,0, 4, 84, 69,87, 
-145, 155, 49, 49,34, 38, 6, 102, 102, 102, 102, 96, 68, 84, 84, 23, 145, 145, 145, 51, 34, 38, 2, 37, 
-88, 32, 68, 69,69, 85, 85, 71, 49,145, 49, 51, 40, 134, 2, 34, 130, 64, 21, 69, 85, 84, 21, 23, 145, 
-145, 147,51, 36, 38, 4, 68, 68, 64, 84, 85, 85, 84, 20, 71, 145, 145, 49, 51, 37, 38, 2, 66, 68, 32, 69, 
-85,85, 85, 69, 87, 145, 145, 147, 51, 40, 134, 5, 84, 72, 64, 20, 65, 69, 68, 20, 71, 145, 193, 147, 
-51, 36, 70, 2, 72,136, 112, 68, 65, 20, 84, 20, 87, 145, 145, 51, 57, 40, 134, 8, 133, 132, 32, 84, 84, 
-17,84, 68, 87,105, 147, 147, 51, 40, 134, 8, 88, 136, 112, 21, 17, 17, 68, 17, 23, 147, 51, 51, 51, 
-36, 134, 4, 133, 136, 112, 81, 17, 17, 68, 65, 87, 147, 147, 51, 57, 40, 134, 0, 0,0, 0,0, 0, 65, 20, 
-68, 71, 147,57, 147, 57, 39, 120, 102, 102, 102, 102, 102, 102, 1, 17, 84, 71, 153, 51, 57, 57, 40, 
-119, 135, 119, 96, 112, 17, 22, 1, 17,68, 183, 147, 57, 51, 51, 37, 120, 135, 120, 96, 112, 177, 22, 
-1,17,17,87,153, 147,57, 57,337,136, 136, 135, 96, 32, 65, 22,1, 20, 91, 71, 60, 57, 57, 57,0,0, 
-0,0, 96, 112, 84, 22, 96, 0, 0,0, 57,57, 60,57, 102, 102,102, 102, 104, 128, 75, 181, 102, 102, 
-102, 102, 60, 57, 51, 60, 39, 119, 135, 119, 120, 112, 180, 84, 180, 181, 75, 183, 57, 60, 57,57, 34, 
-136, 135,215, 231,116, 119,119, 119, 119, 119, 119, 60, 51, 60,60, 37,120, 135, 114, 119, 135, 
-125, 120, 116, 212, 68, 114, 60, 60, 57, 57, 34, 117, 136, 135, 135, 120, 132, 136, 136, 136, 136, 
-71,57,57,57,153 

// 3, partly mossy concrete wall 


"E 

-4,3,5, 36, 20,37, 76,12, 11,19, 77,130, 13, 35, 2, 0, 2,0, 0, 80, 32,0, 0, 1,5, 37, 1,64, 4,25, 19 
-145, 0, 32, 96, 32,0, 16, 48, 24, 115, 48, 65, 53, 48, 16, 113, 11, 2, 0, 0, 0, 0, 0,0, 152, 3, 48, 49, | 
-48,51,19,1,17,0,32,16, 48,0, 16,0,8,0, 0,1, 67,0, 23,19, 17, 2,0, 5, 48,0, 16,0, 24, 115, 65, 
-118,85,67,16,06,17,2,0,18,0,0,0,0,6,4,0,0, 67,48, 19, 145, 17,0, 0, 3, 80, 80,0, 0, 1, 3, 80, 
-19,5,83,16,9,1,2,0,210,0,0,16,0,1, 148,3, 1, 48, 51,16, 17, 17, 19,0,16, 48,0, 16,0, 24,5 
-64,113,51,5,49,1,11,2,0,0, 34,0, 0, 0,8, 85, 3, 1,67, 84, 3, 112, 17,0, 36, 5, 4, 32, 96,0, 8, 4, 
-4,8,52,83, 16,17, 1, 34, 0, 2, 32,0,0, 7,1, 3, 32, 49, 8, 51, 119, 49, 113, 4, 32, 96, 66, 0,0,0, 7, 
-5,84,1, 51, 67, 112, 0, 30, 2, 32, 98, 32, 10, 0,0, 8, 68, 32,64, 5, 3, 49,0, 14, 2, 2, 96, 0,0, 96,0, 
-6,5,80, 49, 48, 51, 112, 1, 27,0, 32, 2,0, 1, 96,0, 1, 51,0, 1, 3,51, 27,0, 27, 2,0, 96, 32,0,0,6 

-8,0, 48, 3,5, 48, 208, 24, 1, 2, 32, 98, 4, 52, 0,0,6, 4, 36, 3,0, 51, 0, 16, 17, 34,194, 96, 34, 0, 96, 
-0,6,50, 48, 1, 83,67, 144,0, 8,0, 42, 2, 36, 0, 0, 162, 8, 5, 32, 65, 64, 48, 23, 1, 1, 2, 32, 100, 34, 
-6,0,12,8,68, 50, 1,0, 3, 16, 112, 1, 36, 34, 2, 0, 0,0, 0, 8,0, 0,0, 48,0, 23, 7,17, 2, 42, 4, 82, 42, 
-0,0,8, 5,64, 64, 35, 0, 135,0, 1, 2,64, 98, 44, 6, 0, 32, 8, 48, 48, 1, 85,0, 17,0, 49, 2, 32,3, 2,0 

-4,0, 8,5, 64, 0,0, 4, 0, 112, 1, 4, 34, 98, 2, 6, 98, 32, 8, 85, 36, 48, 67,5, 1,0, 11, 2, 32,98, 192, 
-160,4,52,8, 4,0, 1,4, 0,0, 112, 113, 2, 194, 2,0, 0,0, 2, 1,5, 85, 64, 211, 4, 48, 0, 1, 2, 32,0, 42, 
-0,21,4,8,64, 68, 45, 4, 48, 0, 23, 27, 2, 32, 96,0, 0, 16,0, 1,5, 80,0, 85, 3, 16,0, 1, 2, 194,0, 0, 
-0,16, 48, 17, 84,85, 0, 48, 64, 144, 25, 17, 0, 32, 96, 0,0, 0, 64, 13, 3, 68, 0, 5, 48, 16,0, 17 


, // 4, wooden chess pattern 
-20,12, 11, 21,2, 43,19, 73, 1, 83, 81, 10, 9, 34, 42, 65, 86, 82, 91, 85, 89, 249, 149, 153, 66, 34, 
-40, 34, 34, 114, 34, 36, 0, 0, 0, 48, 48, 35, 0, 2, 33, 18, 39, 17, 17, 66, 17, 18, 0, 0, 5, 48, 3, 96, 3, 
-50, 33, 34, 40, 33, 33, 113, 17, 18, 96, 0, 6, 48, 3, 99, 3, 50, 33, 34, 23, 33, 18, 129, 17, 18, 80, 3, 5, 
-48, 3, 99, 8,54, 33, 33, 23, 18, 17, 114, 17, 18, 80, 0, 5, 48, 3, 09,0, 54, 33, 34, 20, 34, 33, 114, 33, 
-18, 80, 0, 2, 48, 51, 163, 3, 54, 65, 34, 20, 34, 33, 65, 33, 18, 80, 3, 2, 48, 0, 163, 0, 54, 33, 34, 20, 
-34,17, 66, 33, 18,0, 0, 2, 3,0, 67,0, 53, 177, 34, 20, 34, 17, 130, 33, 18, 0,0, 2, 51,0, 211, 0,5, 
-33, 34, 36, 34, 17, 114, 18, 18, 80, 0, 6, 3,0, 99,0, 53, 33, 34, 20, 18, 33, 113, 17, 18,0, 3, 2, 48, 3 
-99, 0,6, 65, 33, 20,18, 33, 65, 17, 18, 0,0, 2,0, 0, 96, 0, 6, 34, 34, 20, 17, 33, 129,17, 18,0,0, 5, 
-0,0,99, 0, 1, 33, 34, 36, 17, 33, 130, 17, 18, 3, 3, 53, 48, 0, 35, 0, 6, 65, 17, 20, 17, 17, 66, 17, 18, 
-80, 85, 86, 5, 85, 224, 85, 85, 68, 68, 72, 66, 68, 132, 68, 36, 66, 34, 20, 34, 34, 66, 34, 36, 96, 0, 5, 
-5,80, 80,85, 82, 65, 34, 20, 33, 34, 65, 18, 18, 3, 3, 53, 48, 3, 83,0, 5, 65, 34, 20, 18, 34, 65, 18, 
-34,51, 51, 54, 51, 3, 80, 5, 5,66, 34, 20, 18, 34, 65, 18, 18, 51, 51, 53, 51, 3, 80, 5, 5, 66, 34, 20, 
-17,33,65,17,18,0, 51, 54, 51, 3, 80, 5, 5, 65, 34, 20, 17, 17, 65, 17, 34, 51, 51, 53, 51, 3, 80, 0, 0, 
-65, 34, 20, 17, 17, 65, 17, 18, 0, 51, 54, 48, 51, 80, 0, 0, 66, 34, 20, 17, 18, 65, 17, 18, 3, 51, 54, 48, 
-51,80,5,5,65, 34, 20, 17, 33,65, 17,18, 3, 51, 54, 51, 51, 32,0, 5,65, 34, 20, 17, 33, 65, 17, 18, 
-3,51, 54, 51,51, 80,1, 5,65, 34, 20, 17, 33, 65, 34, 34, 3, 51, 59, 48, 51, 80,5, 85, 65, 34, 20, 17, 
-17,66, 34, 36, 3, 51, 52, 48, 3, 83, 1, 5, 65, 34, 20, 17, 17, 68, 17, 20, 3, 51, 54, 48, 48, 35, 48, 5, 
-65, 33, 20, 34, 17, 66, 17,18, 3,0, 52, 51, 51, 35, 48, 5, 65, 33, 20, 17, 17, 65, 18, 18, 3, 51, 54, 51, 
-0, 35, 48,5, 32, 80, 106, 0, 80, 101, 6, 2, 85, 85, 92, 86, 86, 160, 5, 82 

-, // 5, red brick wall 

-13,5,6, 21,93, 101, 4, 100, 11, 7, 19, 3, 106, 178, 0,0, 33, 17, 22, 37, 48, 8, 33, 3, 54, 33,64, 0, 1, 
-20,5,70,37,0,88, 37, 85, 88, 32, 64, 4, 17, 64, 0, 65, 20, 0, 70, 32, 51, 56, 37, 85, 8, 33,0, 4, 17, 
-83,51,81,20,96, 70, 32,3, 52, 38, 51, 8, 33, 3, 4, 18, 83, 51, 81, 20, 85, 70, 38, 6, 4, 32, 51, 8, 33 
-3,4, 18,64, 51, 81, 20, 85, 69, 38,0, 4, 38, 3, 52, 33, 83, 5, 17, 67, 51, 81, 20, 101, 70, 38, 0, 4, 38, 
-83,4,17,83,0, 17, 67, 51, 81, 20, 101, 68, 38, 0, 4, 38, 69, 68, 17, 86, 80, 18, 69, 85, 65, 36, 101, 
-68, 32, 85, 4, 34, 17, 17, 33, 86, 83, 18, 18, 34, 34, 36, 0, 88, 33,0, 4, 34, 34, 18, 33, 83, 0, 18, 17, 
-17,17,36,0,84, 35, 3,56, 34, 64, 76,17, 83, 48, 98, 112,0, 119, 36, 0, 68, 35,0, 4, 34, 133, 4, 18, 
-8,48,58,115,0, 17, 36,0, 85, 33, 0, 4, 34, 133, 100, 17, 81, 48, 98, 112, 0, 1, 36, 0, 86, 35, 0, 8, 
-33,165, 68,17, 67, 53, 98, 113, 0, 1, 36, 85, 86, 35,0, 4, 33, 69, 106, 17, 64, 53, 98, 112, 0, 1, 20, 
-85, 86, 35,0, 4, 33, 133, 68, 17, 64, 53, 18, 112, 0, 1, 20, 5, 86, 35, 0, 4, 33, 166, 84, 17, 64, 53, 18, 
-112,0, 1, 20, 5, 86, 35, 3, 4, 33, 69, 10, 17, 80,53, 18, 112, 0, 1, 36, 85, 86, 35,0, 52, 34, 69, 100, 
-33, 83, 5, 18, 112,0, 113, 40, 5, 84, 33, 64, 8, 32, 69, 4, 33, 69, 68, 18, 112, 0, 1, 36, 0, 22, 33,0, 4, 
-33, 0,52, 17,34, 34, 18, 112, 0, 1, 34, 34, 145, 34, 41, 146, 33, 0, 4, 17, 17, 17, 18, 113, 17, 1, 36, 
-99, 22, 38, 80, 49, 33, 69, 4, 32, 0, 4,98, 112, 17, 17, 36, 51, 6, 32, 80, 4, 33, 69, 106, 35, 3, 53, 98, 
-112, 0,17, 36,51, 6, 33, 3,52, 33,69, 72, 35, 51, 53, 18, 16,0, 17, 37, 51,6, 33, 3, 52, 17, 69, 84 
-85,51,53,98, 112,0, 17, 37, 51, 6, 33, 1, 52, 17, 69, 100, 35, 51, 48, 98, 113, 17, 17, 21, 3, 6, 35, 
-8,52,17,67,4,35, 51, 48, 98, 112, 0, 17, 16, 51, 6, 35, 3, 53, 17, 69, 100, 33, 49, 19, 97, 112, 0, 
-17,37,51, 6, 35,3, 4, 17, 212, 4, 33, 3, 51, 98, 1, 0, 1, 36, 3, 6, 35, 3, 52, 18, 34, 34, 33, 3, 48, 177, 
-34,153, 146, 36, 51, 54, 33, 3, 52, 34, 49, 17, 33, 3, 48, 98, 70, 102, 17, 36,0, 6 

-, // 6, grass-covered concrete wall, tiles with Skyscraper window 


-36, 37, 43, 35, 4, 3, 107 , 34, 131, 50, 42, 5, 106, 110, 114, 26, 3, 131,51, 128,58, 52,0, 5,84, 56, 
-84, 2,0, 48, 66,0, 48, 128, 5,5, 10, 112, 0, 68,0, 48, 85, 68, 4, 144, 32, 1,6, 32, 17,0, 7, 116, 80, 
-0,85, 153, 86, 13,0, 1,0,0, 16, 1, 1,0, 54,115, 3, 160, 110, 234, 55, 1, 208, 40, 1, 0, 170, 96, 0, 
-39, 115,51,51, 144, 0,51, 144,0, 0, 16,0, 2, 17, 16, 17, 208, 11, 187, 20, 0, 2, 43, 64, 32, 17, 16, 
-0,44,17,1,0,16,3,1,0, 2,0, 3,64, 0,0, 32, 32, 0, 1,16, 17,0, 1,3, 2, 96, 32,37, 64, 0,2, 0,2 
-35,17,16,1,1,0,0, 34, 128, 52, 0, 1, 16, 16, 32, 0, 32, 1, 0, 0,0, 16, 8,0, 2,2, 2, 2,0, 32, 2, 32, 0, 
, 


-34, 1,19, 48, 5, 96,0, 2, 0, 32,0, 17, 1, 2, 0, 16, 1, 18, 16, 65, 16, 0, 32,0, 1, 2, 2, 4, 0, 8, 32, 2, 
-39, 18,4, 1, 32,0, 208,0,0, 0, 1, 16, 0, 2, 0, 0, 18, 19, 48, 0, 16, 13, 0, 1, 0, 32, 18,16, 0, 0,0, 16, 
-1,0,0,16,65,16,0,0, 33, 1,16, 0, 54, 0, 38,0, 6, 64,0, 129,0, 0,0,0,1,0,0,0,9,63,50,2, 2,8 
-2, 35,6, 18,0, 17,0, 1, 17, 96, 0, 5, 80, 32, 0, 0, 0, 0, 18, 69, 80, 0, 1, 16, 48, 1, 0, 32, 153, 206, 32, 
-2,2, 32,17, 4, 64, 96, 32,0, 17,0, 224, 0, 131,64, 0, 0,0, 1, 0, 4, 8,0,0, 16, 16, 1,18, 96,0,2,2, 
-0,34, 32, 2, 0, 0,5,0, 0, 96, 2,0, 32,0, 2,0, 2,0, 17,0,0, 0, 85, 34, 32, 0, 0, 0, 0,0, 2,0, 1, 16, 48, 
-0,33,2,68,0, 2, 2,0, 16,0, 32, 32, 32, 38, 1, 32,0, 0, 34, 6, 0,0, 48, 3, 0, 8,0, 0, 0, 18, 16,0, 0 

-98,0, 32,0, 0,0, 33, 32,0, 52,0, 17, 17, 0, 0,0, 33, 32, 0,0, 4, 49, 18,0, 2,16, 2, 1, 66, 0, 98, 2, 0, 
-0,0,34,06,17, 1,0, 0,0, 17,0, 17, 33, 2,0, 12, 126, 199, 112, 39, 0, 16, 6, 21,0, 16, 16, 0, 16, 32, 
-32, 167, 51, 68,62, 172, 151,113, 0, 0, 2,0, 1, 17, 48, 16, 16, 48, 69, 4, 51, 64, 64,0, 16, 8, 96, 27, 
-16,16,16,62,57,149,0,4, 51,0, 1, 4, 7, 80, 2,0, 17, 1, 51, 8, 52, 0, 68, 0, 32, 0, 4, 68, 36, 16, 32 


-, // 1, Steel door 

-4,80,3, 17,5,59,6, 69, 58,50, 60,2, 68, 74, 70, 67, 1, 17, 17, 17, 17, 17, 17, 17, 17, 17, 17, 17, 
-17,17,17,17,22, 102, 70, 102, 70, 102, 70, 102, 70, 100, 102, 100, 102, 100, 102, 97, 16,0,0,0, 
-0,0,0,0,0,0,0,0,0,0,0,1,16, 0, 32,0, 32,0, 32,0, 32, 2,0,2,0,2,0, 1, 19, 189, 187, 221, 189 
-219, 219, 219, 187, 187, 187, 219, 189, 189, 189, 177, 17, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 
-51, 51,51, 49, 19, 136, 136, 136, 133, 133, 85, 95, 34, 34, 44, 47, 34, 194, 34, 40, 19, 136, 34, 34, 
-84,2,34,34, 34, 32, 34, 32, 2, 2,2, 34, 19, 130, 40, 140, 136, 192, 197, 192, 112, 112, 64, 0,0, 7, 
-4,7,19,146, 136, 200, 92, 80, 122, 90, 160,0, 64, 0, 7,0, 4,0, 19, 146, 149, 136, 200, 84, 122, 
-262,0,0,64,0,0, 7, 14,0, 19, 146, 153, 153, 197, 94, 170, 80, 112, 0, 64,0, 112, 0, 4, 0, 19, 146, 
-37,156,133,112,5,0,0, 224, 224, 0, 112, 112, 4, 0, 19, 146, 153, 153, 87, 160, 0, 7, 160, 0, 64,0, 
-0,0, 4, 4,19, 146, 149, 41, 149, 4, 7, 80, 160, 10, 71,0, 0, 7, 4, 0, 19, 146, 153, 146, 87,0, 170, 87, 
-0,7,64,0,7,0,4, 4,19, 146, 89, 204, 87, 4, 167, 80, 7,0, 224, 0,0, 0, 4,0, 19, 146, 153, 156, 90 
-160, 122,80, 0, 14,64,0, 0, 112, 116, 4, 19, 146, 149, 155, 85, 116, 170, 192, 0, 112, 64, 112, 0, 0, 
-4,0, 19,146, 41, 92, 138, 84,122, 90, 0, 0, 71,0, 7,0, 4, 4, 19, 146, 153, 204, 80, 126, 90, 202, 
-224,0,64,0, 0,0, 4,0, 19, 146, 143, 85, 32, 4, 170, 90, 160, 0, 71,0, 7, 7,14, 0, 19, 130, 136, 140, 
-128, 116, 122,202, 112,10, 64,0, 112, 0, 4, O, 19,130, 40, 200, 92, 14, 170, 80, 0, 170, 74, 112,0, 
-112, 116, 0, 19, 136, 34, 34, 34, 2, 2, 0, 0, 32, 34, 34, 34, 34, 2, 34, 10, 136, 136, 136, 133, 34, 85, 
-85,85, 37,194, 47, 34, 242, 34, 34, 17, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 49, 27, 
-189, 221, 187, 219, 219, 219, 187,221, 187, 187, 221, 189, 189, 189, 177, 22, 102, 70, 102, 70, 
-102, 70,102, 70, 102, 70, 100, 102, 100, 102, 97, 16,0, 0,0,0,0,0,0,0,0,0, 0,0,0,0, 1,16,0 
-82,6,32,0,52,0,32,0,32,2,0,2,0,1, 1, 17, 17, 17, 17, 17, 17, 17, A7, 17, A7, 17, 17, 47, 17, 17 
-, // 8, white skull on blue 

-6,5, 4,59, 60, 62, 218, 14, 3, 13, 85, 139, 74, 63, 12, 15, 17, 17, 17, 17, 17, 18, 147, 69, 72, 17, 17, 
-17,17, 17, 17, 17, 16, 16, 1, 1, 16, 18, 35, 51, 50, 17, 1, 1, 16, 16, 1, 17, 16,0, 0, 0,0, 18, 36 
-82,16,16,0,0,0,0,17,0,0,0,0, 0,18, 37,51, 82,17,0,0,0,0,0,1,16,0,0,0, 0,18, 35, 179, 
-50,17,16,0,0,0,0,1,0,0,0,0,0, 18, 35, 51,66, 17,16,0,0,0,0, 17, 16,0,0,0, 1, 226, 37, 67, 
-84, 40, 17, 0,0, 0,0, 1,0, 0, 0, 17, 42, 34, 85, 83, 85, 67, 33, 16,0, 0,0, 17, 0,0, 1, 18, 34, 51, 34, 
-34, 68, 75, 98, 129, 16,0, 0, 17, 16,0, 17, 162, 51,130, 34, 34, 38, 198, 52, 66, 129,0, 1, 17, 17 
-17,42, 36, 98, 33, 17, 17, 34, 51, 51, 68, 98, 33, 17, 17, 130, 34, 36, 68, 33, 17, 17, 23, 121, 34, 52, 
-68, 51, 66, 34, 34, 68, 84, 53, 85, 33, 0, 0, 121, 151, 34, 37, 85, 67, 69, 221, 51, 51, 68, 52, 02, 16, 
-0, 0,126, 151, 18, 34, 133, 91, 69, 84, 99, 51, 107, 52, 66, 0,16, 16, 247, 119, 17, 34, 40, 60, 67, 
-51,68, 83, 99, 51, 50, 1,1, 17,0, 1, 33, 18, 40, 51, 51, 52, 85, 75, 52, 52, 66,0, 17, 17,0, 1, 383,18 
-40, 51, 68, 51, 69, 51, 84, 53, 82, 1, 0, 16, 247, 119, 17, 34, 40, 70, 69, 51, 51, 85, 84, 52, 82, 16,0, 
-0, 126, 151, 18, 34, 132, 70, 69, 84, 99, 85, 68, 52, 52, 33, 0, 0, 121, 151, 34, 36, 52, 60, 52, 85, 51, 
-130,34,35, 107, 33, 17, 17, 23, 121, 34, 99, 107, 195, 66, 34, 34, 17, 17, 42, 102, 98, 33, 17, 17, 
-34,54, 102, 102, 98,33, 17, 17, 16,0, 17, 162, 68,130, 34, 34, 36, 76, 102, 98, 33,0, 1, 17,0,0,1 
-18, 35,69, 34, 34, 85, 67, 194, 161, 16, 0, 0, 17, 16, 0, 0, 17, 42, 35, 69,67, 68, 75, 33, 16,0, 0,0, 
-17,0,0,0,0,1, 226, 35,99, 54, 42, 17,0, 0, 0,0, 1,0, 0, 0, 0,0, 18, 35, 51, 66, 17, 16,0,0,0,0, 
-17,16,0,0,0,0,18, 37, 51, 82, 17, 16,0, 0,0, 0, 1,0, 0,0, 0,0, 18, 45, 51, 66, 17,0, 0,0,0,0,1, 
-16,0,0,6,0,18, 36, 99, 50, 16, 16, 0, 0, 0,0, 17, 16, 16, 1, 1, 16, 18, 35, 68, 50, 17, 16, 16, 16, 16 
-1,17, 17,17, 17, 17, 17, 18, 148, 85,88, 17, 17, 17, 17, 7, 17,1 
-, // 9, red lava with stones 

-3,4, 12, 11,83, 94, 102, 92, 91, 14, 93, 15, 19, 20, 100, 0, 3, 82, 2, 83, 32, 67,84, 1, 17, 17, 16, 5, 
-82,17,20,0,2, 48,0, 67, 117,118, 36, 0, 33, 33, 0,5, 33, 17,17, 19, 69, 64, 17, 20, 67, 86, 82, 36, 
-17/1,6,53,1,17, 17,64, 56, 1, 17,17, 0, 130, 50, 117, 131, 64, 4, 39,0, 17, 17, 0, 32, 1, 17, 17, 3, 
-82, 4, 68, 39, 85, 34, 98, 36, 16, 0, 3,0, 0, 1, 16, 3, 82, 1, 16, 0, 35, 53, 106, 83, 51, 51, 54, 85, 68, 
-36,3,53, 32, 49, 17, 16, 0, 54, 34, 66, 35, 37, 86, 67, 85, 85, 34, 38, 66, 1, 17, 17,0, 82, 64, 64,0, 
-3, 101,0, 32,3, 34,102, 103,65, 1, 17, 3, 84, 1, 17,0, 3, 83, 18, 17, 0, 67, 34, 68, 85, 52,0, 69, 48 
-17,17,19, 69,6,17,17, 20, 3,112,0, 2, 53,51, 114, 1, 17, 17, 16, 69, 65, 17, 17, 16, 3, 80, 3, 0, 4, 
-46, 98, 64, 17, 17, 32, 115, 1, 17, 18, 0, 53, 64, 17, 17, 16, 50, 86, 34, 0,0, 0, 35, 1,0, 0, 0, 37, 65, 
-17,17,17,2,34,119, 85, 67, 66, 34, 0, 51, 130, 50, 98, 64, 17, 17, 17, 2, 35, 68, 51, 85, 102, 98, 
-35,51, 50, 86, 102, 35, 34, 2, 16, 3, 132, 0,0, 4, 34, 82, 35, 20, 0, 66, 85, 39, 120, 34, 4, 2, 80,1 
-17,4,53,52,0, 17,4, 3,83,64, 2, 37, 81,69, 16, 77,17, 16, 69, 16,0, 18, 16, 0, 84, 16, 0, 67, 66, 
-38, 49, 17,17, 32,53, 32, 17,17, 17,0, 82,0, 33, 16, 3, 102, 32,0, 0, 4, 84,0, 18, 17, 17,0, 84,1, 
-17,17,4,182,98,64,0,3, 84,1, 17, 17, 17,0, 83, 1, 17, 17, 4, 99, 37, 83, 50, 50, 32, 0, 33, 17, 16, 
-0,83,1,17,33,2, 36,0, 34, 114, 118, 84, 16, 17, 0, 0, 3, 83, 1, 17, 16, 67, 49, 1, 16, 4, 38, 103, 51 
-64, 84, 68, 53, 32,0, 17,0, 55, 32, 17, 17, 0, 39, 50, 39, 85, 37, 82, 166, 98,36,16,64, 34, 1, 17, ” 
-17,16,55,32,0,36,0,4,54, 34,117, 66, 51, 84, 1, 17, 17, 16, 82, 0,0, 2, 17, 4, 39, 64, 18, 82, 
-118,98,64, 1, 17, 4, 84,16, 17, 17, 18, 4, 84, 4, 0, 20, 53, 102, 82, 32, 0, 4, 84, 0, 33, 17, 16,2, 32, 
-1,17, 64, 39, 51,69, 85, 117, 53,156, 65, 1, 18, 50, 38, 36, 17, 17, 16, 34,0, 0, 20, 67,102, 101, 
-145,51,51,130, 101, 101, 32, 17, 4, 84, 1, 17, 53, 16, 38, 148, 19, 56, 56 

-, // 10, transparent window 

-175,4,5,3,59,13, 49,60, 74, 62, 61,50, 83, 2, 69,12, 17, 17, 33, 17, 81, 17, 17, 33, 17, 17,17, 
-17,18, 34,32, 17, 59, 17, 17, 17, 17, 17, 11, 17,17, 17, 177, 17, 18, 34, 82, 33, 51, 51, 51, 51, 51, 
-51, 51, 51, 51, 51, 59, 81, 18, 34, 33, 17, 49, 182, 102, 102, 102, 102, 102, 102, 102, 107, 18, 33, 
-18,34, 34, 33, 51,0, 0,0, 0, 116, 16, 0, 0, 10, 50, 37, 18, 34, 34, 33, 51, 0,0, 0, 0, 116, 16, 0,0, 10, 
-50, 17,18, 34, 21, 33, 51, 0,0, 0, 0, 84, 16, 0, 0, 10, 50, 33, 17, 243, 51, 52, 51, 0, 0,0, 0, 20, 16,0, 
-0, 10, 50, 145, 18, 17, 17, 21,51, 0,0, 0,0, 20, 32, 0,0, 10, 50, 149, 18, 49, 81, 17,51,0,0,0,0 
-146,112,0,0, 1,50, 37, 82,17, 113, 17, 51, 18, 51, 140, 140, 71, 72, 140, 136, 200, 50, 37, 82, 49, 
-17, 225, 51,18, 68, 68, 68, 121, 116, 68, 68, 71, 50, 33, 82,18, 18, 17, 51,0, 0, 0, 0, 212, 208, 0,0, 
-12,50,17,18,37,34,17,51,0,0,0, 0, 20,16, 0, 0, 9, 50, 17, 18, 18, 37, 30, 51, 0,0, 0,0, 116, 32, 
-0,0, 2,50, 145, 18, 34, 34, 33, 51,0, 0,0, 0, 116, 16,0, 0, 2, 50, 37, 18, 34, 18, 17, 51,0,0,0,0 
-116, 16,0, 0, 16, 50, 145, 18, 37, 33, 18, 51, 0, 0, 0, 0, 116, 16, 0,0, 10, 57, 145, 82, 35, 18, 225, 
-51,0,0,0,0, 20, 16, 0,0, 10, 57,145, 18, 18, 17, 21, 51,0, 0, 0, 0, 212, 208, 0, 0,13, 50, 149, 18, 
-87,18,17,51,18,68,68, 68, 121, 116, 68, 68, 71, 50, 37, 18, 34, 33, 17, 51, 18, 60, 200, 140, 71, 
-76, 136,136, 200, 50, 37, 18, 34, 81, 30, 51,0, 0,0, 0, 244, 16, 0, 0, 1, 50, 149, 18, 34, 33, 17, 51, 
-0,0,0,0,20, 32,0,0, 10, 50, 33, 18, 18, 17, 17, 51, 0, 0, 0, 0, 116, 32, 0, 0, 2, 50, 33, 17, 243, 51, 
-52,51,0,0,0,0, 20,16,0,0, 10, 50, 17, 18, 17, 17, 17, 51, 0,0, 0, 0,84, 16, 0, 0, 10, 50, 33, 82, 
-17,33,31,51,0,0,0,0, 116, 16, 0,0, 2, 50, 33, 18, 17, 17, 17, 49, 182, 102, 102, 102, 102, 102, 
-102,102,107,34,81, 18, 37, 17, 17, 19, 50, 34, 34, 34, 34, 34, 34, 34, 34, 35, 81, 18, 34, 17, 17 
-59, 34, 34, 34, 34, 34, 34, 34, 34, 84, 181, 17, 18, 18, 81, 21, 17, 17, 17, 17, 33, 17, 17, 17, 21, 17, 
-17,17, 18, 34,34, 18 

, //_11, white steel blocks 


D 


-6,5,7,4,3,85, 71, 78,0,0,0,0,0,0,0,0,68, 68, 68, 68, 68, 68, 68, 68, 68, 68, 68, 68, 68, 68, 68 
-68, 51,54, 51, 51,51,51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 52, 34, 0, 34, 34, 2, 34, 34, 34, 84, 34,’ 
-0, 34, 34, 34,0, 17,0, 17,0, 0,0, 1, 16,0, 0, 0, 0,0, 1, 16, 17, 17,0, 20,0, 0,0,0,0,0,0,0,0,0,4, 
-64,0,17,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0, 17,17, 17, 17, 17, 17, 17,17, 81, 17, 17 , 17, 17, 17, 
-17,17,17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, 17,1, 17, 16,0, 0,0,0,0,0,0,0,0,0,0,0,17,0 
-0,1,1,0,0,6,6,6,06,06,6,6,0,0,17, 34,0, 34, 0, 34, 34, 34, 34, 84, 34, 34, 34, 82, 2, 34, 17,0, 
-17,0,1,16,0,0,0,0,0,17,0,0,0,0,17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,0,0,0,0,1,0, 
-0,0,0,0,0,0,16,0,17,17,17,17,17, 81, 17, 22,0, 0,0,1,17,1,17,17,17,19,0, 0,0, 0,0, 2,0, 
-0,0,1,0,0,0, 0,113, 21,16,0,0,0,0,2,0,0,0,1,0,0,0,0,0,19,0,0,0,0,0,2,0,0,0,1,0,0 
-0,0, 1, 17, 34, 34, 32, 2, 34, 34, 0, 0, 0, 2, 34, 34, 0, 34,0,17,0,0,0,0,0,17,0,0,0,0,0,1,16, 
-16,17,17,0,16,06,0,0,0,0,0,0,0,0,0,0,0,0, 17,0, 17,0, 1,0,0,0,0,0,0,0,0,0,06,0, 17, 17, 
-37,17, 17,17, 17,17, 81, 17, 17,17, 17,17, 17, 17,17,0,0,0,0,0,0,0,0,0,06,0,0,0,0,0, 17,1, 
-17,16,0,0,0,0,0,0,0,0, 1,0, 1, 16, 17, 0, 0,1, 1,0,0, 6, 0, 0,0, 16,0, 0, 0, 0, 17, 34, 0, 34, 0 
-84,0, 54, 34, 54, 34, 84, 34, 82, 2, 34, 17, 0, 17,1, 1, 16, 0, 0, 0, 0, 0, 17, 0, 1, 16,0, 17, 0, 20, 0,0, 
-6,0,0,0,0,0,0,0,1, 64, 1,17,0, 0, 0,0, 0, 0,0, 1,0,0,0, 0, 16,0, 17,17, 17, 17, 17, 17, 17, 17, 
-17,17, 25,17, 17,17, 17, 17,17, 19, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51, 51,51 

-, // 12 gray square-tited wall 

-4,5,3, 18,50, 6,12, 21, 85, 20, 14, 11, 19, 22, 84, 0, 17, 17, 17, 17, 17, 17, 17, 18, 17, 17, 17, 17, 
-17,17,17,20,17,3,16,8, 17, 16,0, 18, 17, 16, 1, 1, 0, 3, 16, 18, 16, 1, 16, 1,0, 49, 17, 48, 17, 1, 
-3,6,0, 17,3, 2,16, 16,0, 16,16, 24, 16, 16, 17,0, 0, 23, 16,0, 0, 2, 16, 1, 3, 17, 1, 16, 16, 18, 19, 
-0,0,0, 49,1, 1,2, 16, 48, 17,6, 17, 17,0, 0, 16, 16, 16, 119, 16,19, 0, 2,17, 16, 17, 17, 17, 26,16 
-56,17, 49,0, 19,06,0,0, 2, 16,17, 49, 17, 129, 17,16, 2,16, 3, 16,0,0,1,6,2, 16,17, 16, 1,17, ' 
-17,16,2,17,0,17,1,0,0,0,18, 17, 49, 24, 17, 17, 129, 16, 6, 16, 113, 49, 3, 16,0, 0, 98, 17, 17, 
-17,16, 49,0, 96,9, 16, 16,0, 0, 1, 49, 0, 18, 17, 17, 17, 17, 17, 16, 1,2, 81, 1,0, 32, 0, 16, 16,2, 
-17,161,129,1,0,48,0,4,16,0, 48, 16,0, 49, 1, 2,17, 17, 17, 49, 17,0, 0, 16, 16,0, 16, 16,0,0 
-48, 2,80, 17, 17, 17, 19, 17, 48,0, 16, 16,0, 0, 0, 17, 6, 2, 32, 48, 32, 6,0, 34, 32, 08, 2, 34, 34, 38, 
-2,34, 34, 34, 21, 81, 21, 85, 81, 21, 81, 86, 85, 21, 17, 17, 21, 81, 17, 27,17, 17, 16, 19,0, 48, 1, 0, 
-16,0,0,6, 48,0,0, 2, 19,17, 49,0, 17, 1, 17,2, 22,1, 0, 1, 1, 48, 0, 2, 16, 17,0, 0, 48,0, 49, 2, 80, 
-6,0,0,16, 1,48, 2, 16, 48,0, 0, 16, 16, 112,50, 16, 0, 0, 1, 0, 16, 16, 148, 17, 1, 49,0, 0, 49,0, 28 
-16,6,6, 48,5,0,0,2,16,0,3,1,0,0, 17, 18,16, 3,0, 0, 0, 0, 0, 50, 17, 113, 1, 5, 0, 0, 48, 2, 16,0, 
-0,0,0,6,0,2,16,0,0,0, 0, 48,0, 18, 16, 0,0, 0,0, 0,0, 2, 17,0, 0, 0,0, 0, 3, 2, 208, 0, 3, 0, 48, 0, 
-0,4,17,112,48,19, 16, 0,0, 18, 17,0, 0, 0,0, 0, 16, 100, 16, 17, 9, 1, 1, 16, 1, 2, 22, 0,0, 0,0, 0, 
-0,2,16, 1,0, 16, 3,0, 48,06, 16,0, 0, 0,0, 224, 0, 4,16, 48, 3, 1,0, 0, 16, 50, 16, 3,0, 48,0, 3,0 
-55,16,16,1, 16,0, 0, 0, 2, 16,16, 0, 0, 2, 2, 1, 4, 68, 66, 32, 34, 36, 34, 34, 36, 34, 36, 34, 34, 68, 
-68, 68, 68 

-, 7 13, scifi door 

-3,2,4,9,0, 74,200, 10, 75, 41, 160, 48, 120, 17, 34, 50, 68, 68, 68, 68, 68, 68, 68, 68, 70, 102 
-162; 162, 102, 102, 102, 102, 85, 85, 153,85, 85, 153, 85, 85, 85, 136, 136, 136, 136, 136, 136, 


-136, 149, 153, 153, 147, 147, 57, 55, 57, 125, 238, 88, 135, 127, 85, 119, 119, 51, 147, 51, 51, 51, 
-55, 147, 55, 215, 125, 215, 119, 119, 119, 119, 119, 68, 68, 68, 68, 68, 68, 68, 70, 102, 102, 102, 
-102, 102, 102, 102, 102,0, 0, 0, 0,0, 0,0, 5, 2, 34, 34, 34, 34, 34, 34, 34, 53, 92, 65, 85, 19, 48,0, 
-81,52,11, 160,0, 1, 18, 34, 1, 48, 83, 64, 0, 83, 16, 0, 1, 34, 1, 178, 34, 1, 2, 34, 33, 53, 84, 65,0, 
-4, 49, 80, 1, 0, 11, 160, 34, 43, 16, 2, 1, 52, 196, 49, 85, 28, 51, 51, 161, 26, 186, 16, O, 11, 17, 17, 
-161, 51,51, 51,51,51, 51, 49, 16, 1, 17, 17, 17, 17, 17, 17, 16, 53, 85, 49, 85, 19, 21,0, 34, 32,0, 
-16,0,1, 2, 34,1, 53, 5, 48,0, 83, 16, 34, 34, 34, 32, 18, 34, 1, 2,34, 17, 49, 85, 49,0, 4, 16, 34, 34, 
-34) 32, 16, 34, 43, 2, 32, 161, 51, 68, 49, 85, 28, 16, 34, 34, 34, 32, 16,0, 11, 0, 17, 0, 51, 67, 51, 
-51,51,16, 34, 34, 34, 32, 17, 17, 17, 1, 16, 34, 52, 49, 49, 17, 19, 16, 34, 34, 34, 32, 16, 0, 1,0, 17, 
-2,51,5, 48, 0, 84, 16, 34, 34, 34, 32, 18, 34, 10, 2, 1, 17, 48, 5, 49, 5, 84, 16, 34, 34, 34, 32, 16, 32, 
-10, 2, 32, 161, 48, 85, 49, 21, 28, 53, 2, 34, 34,0, 16, 0, 11, 16, 34, 17, 49, 19, 67, 68, 195, 17, 80, 
-177,16,1, 161, 171, 177, 0, 0, 177, 51, 52, 17, 51, 67, 51, 17, 16,1, 26,0, 17, 161, 17, 17, 16, 53, 
-92, 48,85, 196, 48, 0, 1, 32, 11, 18, 0, 186, 18, 34, 1, 48, 83, 48, 5, 52, 48, 0, 33, 34, 1, 18, 32, 27, 
-18,34,33,53,84, 49, 85, 68, 17, 80, 1,0, 11, 16, 0,186, 0, 2, 1, 52, 196, 51, 76, 67, 19, 51, 161, 
-26,186,17,171,161,1,17,161,0,0,0,0,0,0,0,0, 2, 34, 34, 34, 34, 34, 34, 34, 68, 68, 68, 68, 
-68, 68, 68, 102, 102, 102, 102, 102, 102, 102, 102, 102, 51, 147, 51, 51, 51, 55, 147, 125, 125, 119, 
-119,119,119,119,119,119,149,153,153, 147, 147, 121, 55, 62, 119, 238, 88, 135, 127, 85, 119, 
-119, 85, 85, 153, 85, 85, 153, 85, 85, 152, 136, 136, 136, 136, 136, 136, 136, 68, 68, 68, 68, 68, 68, 
-68, 68, 102,102, 102,102, 102, 102, 102, 102 : 

-, // 14, concrete wall, tiles’ with skyscraper window 

-5,4,3,2,6,44, 131, 66, 50, 51, 45, 81, 132, 28, 138, 1, 1, 97, 81, 193, 39, 32, 17, 17, 16, 44, 16, 
-21,17,38,5,17,17, 97, 17, 17, 23, 49, 17,0, 17, 33, 17,0, 16, 33, 21, 28, 17, 97, 17, 81, 19, 48, 
-17,17,17,34,16,1,16, 33, 1, 17, 9, 33, 17, 18, 47, 50, 18, 130, 255, 248, 34, 81, 18, 97,0, 17, 
-155, 55, 50, 34, 34, 34, 34, 54, 34, 34, 34, 34, 34,147, 49, 17, 63, 114, 68, 68, 68, 68, 0, 64, 68, 4, 


-4,64, 68, 24, 34, 35, 0, 82, 64, 0, 1, 0, 16, 0, 0, 1, 0, 16,0, 46, 16, 0,0, 18, 64, 16, 1, 17, 0,0, 13,0, 
-0,1,0, 31,16, 1,18, 59,0, 16, 0,0, 0, 0,0, 0,0,0,0, 35, 17,17, 115,59, 65,17,0,0,0,0,0,0, 0, 
-0,16,19,183, 51, 161, 34, 17, 16,0, 0,0,0,0,0,0,0,0, 35, 17, 17,0, 33, 16,0, 0,0, 0, 0,0,0, 0, 
-4, 208,19, 17, 17, 17, 18, 64, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 19, 18, 17, 17, 41, 65, 16, 0, 0,0, 0,0, 0,0, 


2 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); Anarch 


-0,0,35,17,33,17,19,0,16,0,0,0,0,0,0,0, 16,0, 30, 17,17, 17, 39,65,0,0,0,0,0,0,0,0,0 
-16,50, 17,21, 17,19,06, 21,17,0,0, 0, 0,0, 0, 0,0, 34,17, 17,17, 43, 64,0,0,0,0,0,0,0,0, 29, 
-0,35,18,34,51,51,65, 21,1,0,0,0,0,0,0,0,0,51, 49, 34,1, 55, 64, 0,0, 0,0, 0,0,0,0,0, 4, 
-27,17,16,16,62,64,16,1,0,0,0,0,0,0,0,0, 54, 17,17, 81, 7, 64,0, 160, 0, 1, 0,0, 0,0, 1,0, 
-34,17,17,17,30,0,16,16, 16,0,0,0,0, 0, 1,0, 19, 17,17, 16, 38, 64, 0,0, 160, 16, 0, 0, 0, 208, 
-16, 209, 34,17, 35,417,147, 0,16, 17,0,0, 16,0, 16, 0, 1, 0, 50, 17, 17, 16, 35, 64, 0,0, 0,0, 0,0, 
-0, 16, 16, 16, 49, 17, 17, 33, 111, 64, 0, 64, 0,0, 4, 68, 0,0, 0, 4, 98, 17, 34, 40, 50, 34, 57, 41, 34, 
-99, 35, 50, 34, 18, 33, 33, 129, 0, 4, 50, 129, 17, 1, 193, 50, 34, 34, 34, 143, 35, 34, 34, 35, 51, 39, 
-85,113, 17, 17,22, 33, 17,1, 16, 34, 1, 1, 161, 22, 17, 1, 21, 49, 17, 17, 30, 17, 17, 17, 16, 84, 17, 
-16, 16, 18, 10, 17, 16, 097, 12, 17, 22, 32, 17,0, 17, 145, 17, 16, 0, 144, 1, 17 
-, // 15, computer tech wall 
-52,59,53,220, 38, 141, 54, 143, 75, 76, 77, 61, 74, 5, 66, 95, 48,0, 0,0, 10, 17,0,0,0,0, 38,0,0, 
-0,0,51,16,0,2,1,17,17,0,0, 16, 0, 38, 0,0, 0,0, 3, 10, 0,0, 0, 17, 1, 17, 17,17, 16, 34,0, 1,0 
-0,0, 7,0,0, 0, 17, 49, 81, 33, 33, 32, 34, 48, 1, 48,0, 0, 2, 0, 0, 0, 17, 1, 1, 17, 17, 16, 38,0, 0, 0,0, 
-0,0,0,0, 83,0, 17,1, 33, 33, 35, 18, 0, 0, 80,0, 0,0, 0, 3,0,0, 17, 17, 17, 17, 16, 2, 83, 2,0, 7,0, 
-0, 85,19, 19, 3,17, 17, 33, 33, 32, 2, 17,0, 32,0,0,06,0, 48,0, 1, 16, 1, 0, 16, 0, 34, 17, 17,0, 0,0, 
-0,1,2,16,0, 24,0,80, 1,0,82, 1,12, 2,0,0, 16, 16, 5, 16,0, 1, 1,0, 9, 17, 34, 17, 30, 18,3 
-16,6,56,6,0,17, 17,17, 17,17, 34, 80, 85, 16, 32, 1,0, 2, 2, 0, 0, 17, 68, 68, 68, 68, 34, 5, 85, 1, 
-39,0,0,6,0,176,0, 17, 68, 68, 68, 68, 34, 85, 5, 1, 114, 3, 0 6, 0, 0, 10, 25, 68, 68, 68, 68, 38, 11, 
-85,1,114,3,0,6,0, 0,0, 17, 68, 68, 68, 68, 34,0, 48, 1, 2, 3, 2, 6, 0, 0,0, 17, 68, 68, 68, 68, 34, 0, 
-0,1,2,0,0, 2,112, 0,0, 17, 68, 68, 68, 68, 38, 0,0, 1, 2, 112,0, 0, 7, 112, 80, 17, 68, 68, 68, 68 
-38, 6,0, 21, 34, 0, 0,16, 32, 0,0, 19, 34, 34, 34, 34, 34, 5, 0, 80, 34, 177, 17, 227, 0, 52, 1, 17, 16, 
-3,1,1,50,19, 51,224, 32, 24, 128, 17, 32, 16, 1, 16, 1, 0, 16, 16, 2, 51, 28, 50, 32, 8, 16, 1, 0, 80, 
-0,21,0,0,16, 1,146, 51,137,6,0, 1,0, 1, 16, 0, 17, 17,0, 0, 17, 16, 34,17, 144, 32, 0, 3,0, 0, 17, 
-0,1,1,13,240,3, 17, 35, 24,0,0, 3, 3,0, 0, 81, 16,0, 1, 15, 240, 51,0, 35,0 9,1,48,0,0 
-195,0, 17,0,0,5,49, 34, 0, 3, 0, 160, 5, 0,0, 5, 48, 206, 17, 4, 208, 109,0, 2, 48,0, 112,2, 3, 57, 
-0,0,0, 1, 17,13, 208, 221,51, 18, 17,0, 176, 3, 3, 19,0, 5,16, 0, 1, 3,0, 49, 19, 50, 17, 1,0, 51,1, 
,0, 48,0,0,17,0,0,0, 48, 34, 49, 48, 0,0, 3, 48,0, 0, 0, 10,17, 0, 0, 0,0, 38,0,0,0, 0,51 


shines t SFG_wallTextures[SFG_WALL_TEXTURE_COUNT * SFG_TEXTURE_STORE_SIZE]; 
+uint8_t SFG_itemSprites[13 * SFG_TEXTURE_STORE_SIZE]; 
+uint8_t SFG_backgroundImages[3 * SFG TEXTURE STORE SIZE]; 
*uint8 t SFG weaponImages[6 * SFG TEXTURE STORE SIZE]; 
+uint8_t SFG effectSprites[4 * SFG TEXTURE STORE SIZI te 
+uint8_t SFG_monsterSprites[19 * SFG_TEXTURE_STORE_SIZE]; 
+uint8_t SFG logoImage[SFG TEXTURE STORE SIZE]; 


-SFG PROGRAM MEMORY uint8 t SFG itemSprites[13 * SFG TEXTURE STORE SIZE] - 


4, 0, barrel 

-175, 6,106, 29, 100, 84, 7,92, 2,43, 10, 11, 46, 4, 28, 200,0,0,0 ,0,0,0,0,0,0,0, 
-0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 ,255,0,0,0,0,0, 
-15,240,6,0,0,0, 0, 0, 255, 248, 255, 255, 255, 255, 255, 255, 24. 5, 255, 255, 255, 255 
-255, 143, 248, 248, 255, 255,143, 136, 136, 130, 136, 136, 136, 136, 36,136, 143, 168, 66, 
-136, 136, 137, 136, 146, 146, 130, 153, 153, 146, 146, 143, 66, 168, 170, 226, 34,130, 41, 73, 41 
-66, 137,34, 34,153, 41, 146, 226, 168, 186, 34, 34, 155, 149, 187, 186, 162, 170, 84, 153, 34, 146, 
-36, 158,170, 234, 34, 233, 229, 93, 170, 171, 85, 91, 43, 78, 68, 66, 146, 36, 187, 121, 228, 237, 
-69,90, 181,85, 85, 93, 91, 132, 77, 66, 36, 73, 158, 89, 18, 68, 69, 187, 85, 183, 119, 122, 181, 
-187,68,66,68,18,222,93,18,68, 77,161,197, 28, 119, 119, 170, 26, 94, 34, 36, 18, 213, 93, 
-193, 20, 21, 177,17,81, 87,119, 123, 183, 84, 52, 44, 20, 222, 03, 17, 17, 23, 17, 17, 21, 119, 117, 
-17, 81,65, 35, 65, 28, 213, 93, 49, 17, 26, 21, 186, 167, 119, 225, 17, 17, 113, 34, 49, 49, 222, 93, 
-60, 19, 106, 97,106, 119, 115, 49, 97, 193, 118, 35, 67, 19, 222, 93,18, 102, 101, 102, 102, 103, 
-117, 86, 22, 54, 113, 50,35, 18, 213, 93, 18, 198, 99, 118, 102, 119, 119, 119, 119, 183,54, 99, 38, 
-25, 190, 93, 102, 102, 195, 166, 203, 119, 119, 123, 190, 101, 108, 50, 51, 99, 181, 93, 54, 54, 51, 
-117,22,19,87,187,229,53,51,34, 33, 28, 222, 125, 51, 51, 51, 58, 49, 28, 17, 49, 21, 227, 19, 
-19,51, 17, 158, 185, 195, 51, 51, 49, 174, 81, 17, 85, 117, 17, 17, 193, 28, 76, 155, 186, 51, 195, 
-51, 17, 61, 91, 187, 181, 49, 52, 49, 28, 20, 28, 154, 170, 25, 236, 30, 49, 49, 17, 49, 193, 17, 17 
-28, 20,19, 28, 184, 170, 25, 225, 193, 17, 17, 17, 17, 193, 17, 17, 17, 20, 19, 30, 184, 138, 60, 238, 
-236, 193, 193, 193, 17,195, 65, 17, 17, 225, 68, 62, 175, 250, 34, 34, 34, 34, 34, 36, 225, 228, 34, 
-34, 34, 34,34, 36, 175, 251, 0,0,0, 0,0,0, 464,0, 0,0, 0, 0, 0, 191, 0,0, 0,0,0,0,0,0,0,0, 


(0) 
, 
,9 


a 
n 
ROO 
CQ ~ 
ox 
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HNOS 


0, 

ered eale h Sr ,0,9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 
-175,7,5,6, 2,94, 0,69, 4,53, 71, 93,3, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
-0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
-0,0,0,0, 0,0, 0, 0,0, 68,68, 64,0, 4, 68, 68,64, 0,0, 0, 0,0, 0, 0, 4, 17, 17, 20, 68, 65, 17, 17, 20 
-0,0, 0, 0, 0, 0, 0, 65, 18, 35, 49, 17, 19, 50, 35, 56, 64, 0, 0,0, 0,0, 4, 17, 55,119, 119, 119, 119, ' 
-119, 119,50, 70, 0,0, 0, 0,0, 4, 34, 119, 41, 41, 41, 41, 41, 39, 114,134, 0, 0,0, 0,0, 4, 34, 114, 
-146, 146, 146, 146, 146, 149, 115, 38,0, 0, 0,0, 0, 68, 19, 161, 17, 17, 17, 17, 17, 53, 163, 54,0, 0, 
-0,0,4,34,35, 163, 17, 17, 17,17, 17, 21, 163, 38,0, 0,0, 0, 4, 108, 41, 161, 21, 85, 85, 85, 177 
-53,162,134,6,0,0,0,4,4, 34, 163, 21, 85, 85, 85, 177, 21, 162, 70,0, 0,0, 0,4, 4, 194, 161, 49, 
-49, 01,17, 49, 53, 168, 96, 0,0, 0,0, 4, 0, 66, 163, 19, 17, 91, 19, 19, 21, 168,96, 0,0,0, 0, 4,0, 
-66, 161, 49, 49, 91, 17, 49, 53,168, 96,0, 0, 0,0, 4, 4, 194, 163, 19, 17, 91, 19, 19, 21, 168, 96,0, 
9,0,0,4, 4, 834, 161, 21,85, 85,85, 177,53, 162, 70,0,0,0, 0, 4, 108, 41, 163, 21, 85, 85, 85, 177, 
-21,165,134,0,0,0,0,6,34, 35, 161, 17, 17, 17, 17, 17, 53, 163, 38,0, 0, 0, 0, 0, 102, 19, 163, 17, 


-17,17,17,17,21, 163, 54,0, 0,0, 0,0, 4, 34, 121, 41, 41, 41, 41, 41, 37, 115, 38, 0,0, 0, 0,0, 4, 
-34, 119,146, 146, 146, 146, 146, 151, 114, 134,0, 0,0,0, 0, 4, 19, 55, 119, 119, 119, 119, 119, 
-119,50,70,0,0,0,0,0,0,98,50, 35, 40, 136, 130, 50, 35, 40, 96, 0, 0,0, 0,0, 0,6, 136, 1 
-102, 104, 156, 136, 134, 0, 0, 0, 0, 0, 0, 0, 0, 102, 102, 96,0, 6, 102, 102, 06, 0,0,0, 0,0, 0 
9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 

9 


o Ororo rO Or Eroro ' 
-, // b, ammo: bullets ' 
-175,124, 168, 125, 2,5 ; 
-0,0,0,0,0,0,0,0,0,0 r r 
-0,0,0,0,0,2, 34, 34, 3 5,10, 104,102, 214, 73, 32,0, 0, 0,0, 
-36, 68, 68, 68, 71, 32,0, 53,17,17,17,25,183, 119, 238, 231 
-17,17,20,68, 183,119, 238, 231, 119, 23, 32,0, 0, 0, 0, 35,17, 20, 72, 
-119, 23, 32,0, 0,0, 0,35, 17, 70, 134, 109, 179, 51, 255, 243, 51, 49, 32, 
-170, 179, 119, 85, 81,17, 49, 32, 0, 0, 0,0, 35, 17, 26, 168, 132, 179, 113, 8 A 
; 


o 
o 

1,194, 19, 17, 112, 113, 190, 3, 4, 23,0 
o 
3 
o 

2 

1 

9 

-9,9, 38,17, 78, 134, 109,179,113, 92, 193,17, 49, 32,0,0, 0,0, 35,17, 26,159, 245,1 

9 

4 


o 

,0, 170,170,170, 0,0,0,0, 0,0,0,0 
0 
A 
3 


D 
D 
, 


N Qoo 


RUE 
DURS M^ OO Q7 


] 
79,17 
-204,81,17,49,32,0,0,0,0, 35,17, 20, 137, 153, 179, 17, 197, 81, 17, 49, 32, 0, 0,0, 0, 
-70, 134,109,179, 17,92, 81, 23, 23, 32, 0, 0,0,0, 35, 17, 26, 137, 153, 179, 17, 204, 199, 
-66,0,0,0,0, 35, 17, 20, 152, 132, 179, 17, 85,68, 136, 72, 66, 0, 0,0, 0, 35, 17, 70, 134, 1 
-17,84,104,102, 214, 210,0, 0,0, 0, 35, 17, 26, 150, 245, 179, 17, 204, 73, 255, 95, 82, 0 
-35, 17, 20, 152, 132, 179, 17, 85, 193, 153, 154, 162, 0, 0, 0,0, 35, 17, 70, 134, 109, 179, 
-195,20,68,210,0,0,0,0, 35,17, 26, 150, 245, 179, 17, 197, 193, 20, 246, 130, 0,0,0, 0 
-72, 137,153,179, 17,197, 81, 20, 93, 66, 0,0, 0,0, 35, 17, 26, 152, 132, 179, 17, 92, 193 
-130,0,6,0, 0,35, 17,166, 134, 109, 179, 17, 92, 81,17, 150,130, 0,0, 0, 0, 2, 34, 42, 16 
-179, 17, 504, 193, 17, 152, 32,0, 0,0, 0, 0,0, 0, 2, 34, 179, 17, 85, 81, 17, 58, 32, 0,0, 0, 
-0,0,35,17,85,81, 17, 49, 32, 0,0, 0, 0,0, 00,0, 0, 34, 34, 153, 146, 34, 49, 32, 0, 0, 0, 
9,0,0,0,0,0,0,34, 32,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 


,1,85,197,90,85, 204,119, 17,119,16,0,0, 3, 51,0,0,1, 170,85, 90, 85,02, 1 
0,3,59, 47,51, 0, 1,85, 197, 90, 85, 204, 124, 119, 199, 193, 0, 59, 187, 42, 169, 51, 53 
-170, 92, 90, 85, 87, 246, 31, 31, 193, 3, 187, 238, 218, 153, 157, 149, 68, 37, 36, 42, 39, 135, 17, 
-17, 17,0, 62,238, 217, 153, 51,53, 85, 82, 36, 34,167, 136,97, 17, 16, 0, 3, 222, 217, 211,0, 6, 
-68, 34, 36, 42, 247,136, 246, 17, 96, 0, 3, 221, 221, 211, 0, 6, 68, 85, 36, 34, 247, 136, 246, 225, 
-96,0,59, 187, 42, 169, 51, 53, 68, 133, 36, 42, 39, 136, 246, 209, 96, 3, 187, 238, 218, 153, 157, 
-149, 68, 40, 36, 34, 167, 136, 246, 145, 96, 0, 62, 238, 217, 153, 51, 53, 68, 85, 36, 42, 39, 136, 
-246,225,96,0,3,222,217,211,0,6, 68, 130, 36, 34, 167, 136, 246, 209, 96,0, 3, 221, 221, 211, 
-51,54, 68, 85, 36, 42, 247, 136, 246, 145, 96,0, 59, 187, 42, 169, 51, 53, 68, 85, 36, 34, 247, 136, 
-246, 225,96, 3, 187, 238, 218, 153, 157, 149, 68, 34, 36, 42, 39, 136, 246, 209, 96,0, 62, 238, 217, 
-153, 51, 53, 68, 85, 36, 34, 167, 136, 118, 145, 96, 0, 3, 62, 217, 51, 59, 230, 68, 34, 36, 42, 39, 
-136, 201,153, 16, 0,0, 3, 51, 0, 50, 182, 68, 34, 36, 34, 167,135, 106, 153, 16,0, 0,0,0,0, 3,54 
-85, 82, 36, 42, 247, 140, 250, 169, 145,0, 0, 0,0, 0, 0, 6, 136, 37, 36, 34, 247, 134, 34, 221, 209,0, 
-0,0,0,0,0,0, 102, 72, 68, 42, 39, 134, 187, 238, 236, 0, 0, 0, 0,0, 0, 0, 0, 102, 104, 34, 166, 102, 
-203, 238,192, 0,0,0,0,0,0,0, 0,0, 6, 68, 105, 209, 203, 190, 192, 0,0, 0, 0,0, 0,0, 0,0, 0, 102, 
dy AAS, 25,158, 0,0, 0,6 6 0 d OL OLD 9,0,17,16,192,0,0,0,0,0,0,0,0,0,0,0,0,0, 17,0, 
-, // 4, ammo: plasma 
-175,6,0,2,4,142,206, 5, 7, 62, 205,115, 207, 116, 1, 201,0, 0, 0, 0, 35, 51, 51,51, 51, 50,0,3, 
-48,0,0,06,0,0,0,3,57, 145, 145, 145, 153, 147, 32, 54, 99,0, 0, 0,0, 0, 0, 51, 149, 34, 34, 34, 34 
-52,34,42, 162, 34, 34, 82,0, 0, 2, 57, 50, 143, 255, 34, 243, 34, 238, 39, 66, 238,62, 32,0,0,3, ” 
-149, 40, 252, 106, 175, 84, 51, 51, 55, 67, 62, 67, 32, 0,0, 3, 146, 2, 198, 170, 219, 87, 68, 67, 67, 
-52,67,116,32,0,0,3, 146, 2, 198, 170, 221, 87, 68, 67, 68, 68, 67, 116, 32,0,0, 3, 146, 2, 198, 
-106, 219, 81, 119, 116, 55, 119, 116, 23, 32,0, 0, 3,146, 0, 54, 102, 106, 81, 119, 119, 67,51, 51, 
-52,52,0,0,3,146,0, 251, 187, 187, 184, 17, 17, 17,17, 23, 67, 32, 0,0, 3, 50, 2, 106, 221, 219, 
-88, 17, 145, 25, 27, 182, 132, 32,0, 0, 2,66, 2, 198, 170, 173, 88, 17, 81, 21, 27, 172, 132, 32, 0, 0, 
-3,50, 2,198, 106, 171, 88, 17, 81, 89, 27, 172, 132, 32,0, 0, 2, 66,0, 54, 102, 106, 88, 153, 85, 
-145, 26, 204, 132, 32,0,0,3,50,0, 251, 187, 187, 184, 149, 17, 17,17, 23, 132, 32,0, 0, 2, 66,2, 
-106, 221,219, 88,17, 25, 25,17, 23,132, 32, 0, 0, 3, 50, 2, 198, 170, 221, 88, 21, 21, 21, 17, 23, 
-132,32,0,0,2,66,2, 198, 106, 219, 88, 21, 21, 21, 17, 23, 132, 32, 0,0, 3, 50,0, 54, 102, 106, 88, 
-25,21,81,17,23,132,32,0,0, 2,66,0, 251, 187, 187, 184, 17, 17, 25, 17, 23, 132, 32, 0, 0, 3, 50, 
-2,106, 221, 219, 88,17, 81, 21, 17, 23, 132, 32,0, 0, 2,66, 2, 198, 170, 221, 88, 17, 81, 81, 17,23 
-152,35,0,0,3,146,2,198, 106, 219, 88, 17, 85, 21, 17, 23, 132, 32,0, 0,3, 146,0, 54, 102, 106, 
-88, 149, 17,17, 17, 23, 132, 32,0,0, 3, 146, 0, 251, 187, 187, 184, 81, 145, 17, 20, 23, 132, 32,0, 
-0, 3,146, 2, 106, 221, 219, 88, 17, 81, 81, 23, 23, 132, 32, 0, 0, 3, 146, 2, 198, 170, 221, 88, 17, 81, 
-149, 20, 23,132, 32,0, 0, 3, 149, 34, 198, 106, 170, 88, 17, 85, 17, 17, 23, 67, 32,0, 0, 2,52,62, 
-54, 102, 106, 88, 17, 17, 51, 51, 51, 52, 32,0,0, 0, 35, 69, 46, 238, 238, 247, 119, 115, 71, 119, 
-116, 116, 32,0, 0, 0, 2,52, 65, 65, 65, 67, 51, 34, 35, 50, 34, 34, 32,0, 0, 0, 0, 34, 34, 34, 34, 34, 
-34,0,2,32,0,0,0 


-,_// 5, tree 
-175,0,17,115,5,3,2,196, 4, 114, 20, 38, 22, 96, 37, 21,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
-0,0,0,0,0,0,0,0,0,0,51,0,0,0, 1,17,0,0, 0, 3, 54, 32,0,0,0, 3,51, 51,0, 17, 26, 72,0,0,0, 
-59,187,178,0,0,0,0,3, 51, 49, 72, 100, 72, 0,0, 3, 187, 238, 113, 0, 0, 0, 0, 38, 98, 49, 68, 100, 
-72,0,0, 6,190, 231, 57,16, 0,0, 34, 187, 238, 33, 68, 100, 72, 0, 0, 34, 190, 119, 57, 16, 0,0, 43, 
-119, 119, 114, 100, 101, 72, 0, 2, 194, 231, 115, 145, 16, 2, 32, 1, 23, 119, 114, 100, 70, 136, 2, 34, 
-194, 231, 57, 145, 0, 44, 16, 51, 49, 19, 114, 68, 134, 85, 2, 204, 207, 147, 153, 145, 2, 193, 3, 51, 
-27,51,50,72,106, 72,0, 17, 204,169, 34, 209, 26, 16, 0, 1, 179,50, 33, 70, 68, 72, 0, 0, 17, 207, 
-82,37,173,16,0,0,17,38,98, 86, 164, 72,0,0,0, 17, 26, 85, 33, 98, 0, 1, 170, 85, 82, 72, 106 
-72,0,0,0,0,1, 90, 93, 22,17, 31, 165, 85, 34, 68, 134, 88, 0, 51, 102, 0, 20, 42, 166, 221, 42, 250, 
-85, 34, 33, 68, 72, 101, 3, 187, 183, 17, 204, 246, 250, 82, 255, 85, 82, 45, 210, 100, 70, 72, 3, 190, 
-121, 111, 245, 95, 207, 255, 165, 85, 45, 17, 18, 100, 70, 72, 59, 183, 115, 146, 93, 223, 204, 165, 
-85,45, 17,119,114, 68, 72, 101, 59, 231, 115, 146, 209, 165, 44, 109, 17, 29, 42, 17, 50, 68, 134, 
-88, 110, 119,57, 157, 218, 93, 198, 209, 17,1, 29,165, 18, 72, 106, 72, 30, 115, 57, 157, 170, 34, 
-198,17,145,0,49, 37, 82, 86, 164, 72, 1, 51, 153, 37, 93, 28, 81, 41, 16, 3, 49, 210, 82, 70,68, 72, 
-0,25, 34, 121, 17, 28, 33,17,0,0, 51, 29, 34, 72, 100, 72, ©, 1, 119, 57, 16, 26, 33,0, 0, 3,54, 177, 
-34,68,134,85,0, 1,115, 145, 16, 21, 16, 0, 3, 54, 107, 18, 82, 100, 70, 136,0, 0, 17, 17,2, 25,18 
-0,0,45, 231, 21,82, 100, 101, 72, 0,0, 0, 0, 33, 123, 113, 32, 0, 2, 35, 49, 82,68, 100, 72,0,0,0, 
-0, 27,238, 121,16,0,0, 49, 17, 18, 68, 100, 72, 0, 0, 0, 0, 30, 231, 57, 16,0, 51, 51, 51, 50, 72, 
-160, 72,0, 0,0, 0, 30, 115, 145, 16, 0, 0, 51, 48, 0, 17, 26, 72, 0,0, 0,0, 1, 57,17, 0,0, 3, 48, 0,0, 
-0,1,17,0,0,0,0,0,17,16,0,0,0,0,0,0,0,0,0 

-, /f 6, finish 


-175,3,4,0,5,1,2,6,50,7,198,209, 48, 42, 44 
-0,0,0,0,0,0,0,0,0,0,0,0,0,51,0,0,0,0,0,0 
-51, 51, 51, 51, 51,51, 51, 51, 54, 115, 3, 153, 15 
-158, 153, 115, 3, 119, 119, 119, 34, 119, 119, 114 


-71, 119, 119, 119, 119,119, 119, 119, 119, 119, 1 
-34) 34, 34,34, 34, 67, 53, 85, 85, 71, 40, 136, 136 
-176, 165, 36, 43, 204, 204, 95, 102, 102, 102, 102 
-246, 102, 102, 102, 102, 102, 97,65, 67, 49, 161, 
-136, 129, 65,67, 49, 17, 21, 36, 43, 187, 253, 136 
-165, 36, 43, 187, 253, 136, 136, 136, 136, 136, 13 
-17,17,17, 17,17, 17, 65,67, 49,161, 165, 18, 43 
-17, 21, 18, 43, 102, 129, 17, 17,17, 17, 17, 17, 17 
-34,34, 34, 33, 65,67, 49, 17, 21, 18, 43, 17, 34, 3 
-43, 18, 68, 68, 68, 68, 68, 68, 68, 65, 65, 67, 49,1 
-65, 65, 67,49, 161, 21,142, 43, 18, 119, 119, 119 
-38, 18, 68, 68, 68, 68, 68, 68, 68, 65, 245, 83, 3, 1 
-255,99,3, 102,102, 97, 85, 85, 85, 85, 85, 85, 85 
-102,97, 22,102, 102, 17,102, 102, 102, 99, 3, 85 
-99, 3,51, 51, 51, 51, 51,51, 51,51, 51, 51, 51,51 


-83,0,0,06,0,0,0,0, 0,0, 0,0,0,0, 0, 0, 51,0, 0,0, 


-0,0,0,0,0,0,0,0,0,0 
-, // 1, teleport ' 

-175,0, 151,6, 3, 143, 5, 4, 134, 53, 55, 2, 127,63 
-0,0,0,0,17,16,0,0,1,17,0,0,1,17,17,16,0, 
-33,0,0,0,1, 86, 113,0, 0, 21, 103, 16,0, 18, 123 
-18,55,185,113,0,1, 17, 17, 68, 65,176, 11, 20, 
-17,17,51, 51, 54, 37, 17, 99, 118, 97, 0, 19, 100, 
-113, 0,19, 68, 68, 34, 34, 34, 37, 82, 34, 124, 136 
-130, 85,142,232, 235, 151, 116, 65, 0, 19, 68, 40 
-75,177,0,19,69, 172, 205, 165, 34, 34, 85, 136, 
-170, 221, 34, 85, 34, 233,153,148, 249, 70, 116, 
-153, 151, 249, 70, 116,0, 19, 74,170, 221, 170,2 
-19,173,221,210,85,34, 37, 88,136, 200, 233, 1. 
-136, 136,200, 153, 158, 249, 230, 116, 0, 19, 68, 
-230, 116, ©, 19, 69, 221, 221, 218, 210, 34, 130, 3 
-170, 170, 173, 34, 130, 34, 156, 201, 151, 249, 11: 
-140, 204, 151, 249, 70, 116, 0, 19, 90, 88, 34, 37 
-19,165, 40, 34, 34, 130, 37, 130, 85, 04, 232, 155 
-200,85,155,147,54,49,0,19, 100, 68, 34, 86, 5 
-51,51, 51, 51, 17, 17, 51, 51, 54, 85, 113, 115, 11i 
-228,99,182,97,0,0,0,1,86,113,0,0, 21, 103 
-21, 103, 16, 0, 18, 107, 23, 113,0, 0, 0, 1, 183, 17 
-17,16,0,0,1,17,0,0,1,17,17,16,0,0,0,0,0, 
-, // 8, computer terminal 
-175,0,1,85,5,4,23,6,9,26,80,65, 2,84, 161 
-0,0,0,0,0,0,6,6,0,0,0,0,0,0,0,0,0,0, 0,0, 
-0,0,0,0,0, 17,0, 1,17, 17,17, 17, 17, 17,0, 1, 
-101,16,1,65,0,0, 238, 225, 117,1, 99, 53,53, 5 
-60,129,17,17,17,17,139,83, 102, 74, 140, 158 
-54, 74,142, 238,51, 25, 69, 22, 49, 66, 34, 34, 34 
-177, 66, 242, 242, 34, 36, 19,119, 54, 202, 131,5 
-119,54, 90,141, 216, 167, 121, 69, 22, 49, 66, 24: 
-73, 69, 22, 49, 66, 242, 34, 34, 36, 207, 119, 54,9 
-195, 119, 54, 90,148, 68, 85, 89, 69, 22, 49, 66, 3 
-69, 22, 49, 79, 255, 255, 255, 244, 195, 119, 54, 2 
-36, 195, 119, 54, 90, 185, 153, 153, 153, 69, 22, 4! 
-187,153, 85, 22, 49, 66, 34, 34, 34, 36, 19, 119,5 
-34, 84, 36, 28, 119, 54, 60, 131, 51, 218, 187, 85, 
-93, 171, 149, 22, 56, 148, 68, 68, 68, 73, 21, 51,5 
-17, 17,139, 83,54, 74, 136, 136, 136, 138, 149, 1 
-17,17, 153, 0, 24, 140, 140, 136, 136, 136, 136, 1 
-17,0,1,16, 0, 0,0, 1, 187, 0,0,0,0,0,0,0,0, 0, 
-0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 


49,0,0,0,0,0,0,0,0,0 0,0 

, 0,0, 0,0, 0,0, 0,0, 3, 147, 3, 51, 51, 51, 51, 51, 

7153, 34,153,153, 146, 41, 153, 153, 34, 153, 

, 39, 119, 119, 34, 119, 119, 119, 67, 3, 68, 68, 

19,119,67,3,68,68, 71, 34, 34, 34, 34, 34, 34 

, 136, 136, 136, 136, 136, 136, 129, 68, 115, 49, 

,102, 97, 71, 115, 49,170, 165, 36, 43, 204, 197, 

165,36, 43, 187, 255, 216, 136, 136, 136, 136, 

1,135,136, 136, 136, 136, 129, 65,67, 49 161, 

, 129,65, 67,49, 26, 21, 36, 43, 102, 120, 17, 

, 102,129, 17, 17, 17, 17, 17, 17, 17,65, 67,49, 

ARN UE S nnn E ERE 

70,165, 142, 43, 18, 68, 68, 68, 68, 68, 68,68,” 

,119, 119, 119,119, 113, 85, 83,53, 85, 85,142, 

62, 102,97, 34, 34, 34, 34, 34, 34, 34, 34, 34,33, 

, 85,85, 85, 85, 99, 3, 102, 102, 102,17, 102, 

, 85,85, 17, 85, 85, 81, 21, 85, 85, 17, 85, 85, 86, 

,51, 53,83, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,3, 
0,0,06,0,0,0,0,0,0,0, 0, 0, 0, 0,0, 0, 0, 0, 0, 


0,0,0,0,0,0,0 


,45,54,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
0,0, 1,183,177,0,0,27, 123, 16,0, 18, 33, 18, 
27,177,0,0,0,1,86,113,0,0, 21,102, 17, 17, 
68,67,51,125,51, 182, 97,0, 20, 51, 51, 51, 51, 
68, 34, 86, 51, 51, 101, 34, 41, 204, 145, 68, 71, 
, 155, 68, 68, 65, 0,19, 221, 37, 82, 40, 130, 34, 
130, 85, 85, 88, 200, 204, 206, 233, 235, 244 
504,136, 228, 254, 70,116, 0,19, 68, 172, 202, 
9,19, 74,172, 205, 170, 210, 34, 85, 34, 238, 
10, 34, 85, 37, 140, 136, 151, 249, 118, 116, 0, 
51, 249, 230, 116, 0, 19, 77, 221, 210, 88, 34, 85, 
221, 221, 218, 34, 34, 85, 37,136, 136, 158, 249, 
4,156, 201, 151, 249, 118, 116, 0, 19, 68, 90, 
8,116, 0, 19,170, 74, 221, 213, 130, 37, 85, 136, 
82,89, 187, 156, 204, 238, 158, 244, 68, 177,0, 
,246,51, 49,0, 19, 68, 68, 34, 34, 34, 34, 85, 34, 
1,51, 101, 34, 44,153, 155, 99, 118, 97,0, 20, 
8,97,0,1, 17, 17,68, 65,176, 11, 20, 68,67, 51, 
17,17,23, 54, 182, 113,0,0,0,1, 86, 113,0 
7,6,0,27,123,16,0, 18, 83, 18,53,0,0,0,0,' 


0,0,0,0,0,0,0,0,0,0,0 
194,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 
8,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0, 
6,0,0,0,1,116, 0, 22, 101, 101, 102, 102, 102, 
1,51,51,53,187,27,75,17,17,238,17,69,22, 


7 
r27, 

233, 154, 69, 22, 56, 148, 68, 68, 68, 73, 21, 51 
36, 19,68,54, 90, 238, 141, 61, 169,69,21, 
1, 218, 121, 69, 22, 49, 66, 242, 34, 34, 36, 31, 
2, 242, 34, 36, 131, 119, 54, 202, 17, 138, 119, 
0, 87, 119, 68, 89, 69, 22, 49, 66, 242, 34, 34, 36 
4, 34, 34, 36, 195, 119,54, 90, 181, 85,85,89, ” 
02,185,153, 149, 89, 69, 22, 49, 66, 34, 34, 34, 
9,66,34,34, 34, 36, 140, 119, 54, 90, 17, 138, 
4, 202, 141, 216, 171, 187,69, 21, 177, 66, 34 
25, 49, 66, 34, 34, 34, 36, 19, 68, 54, 90, 133, 85, 
4, 74,141, 221, 93, 27, 89, 22, 60, 129, 17, 17, 
,51,60, 60, 51, 51, 51, 53, 187, 27, 75, 17, 17, 
6,1,65,0,0,0, 1,153, 0, 1, 17, 17, 17, 17, 17 
0,0,0,6,0,0,17,0,0,0,0,0,0,0,0,0,0,0,0, 
9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 


-0,0,0,0,0,0,0,0,0,0,0,0 
-, // 9, column 
-175,2,4,$,5,48,6,63,51,7,81,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
-0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0, 0,0, 0, 0,0, 0, 0,0, 0, 0,0, 0, 0, 0,0,0,0, 
-0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1, 65,0, 0,0, 
-0,0,0,0,0,0,0,0,0,0,0, 20, 65,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 20, 73,16, 0,0,0,0,0,0,0 
-0,0,0,0,0,1,148, 38, 145,16,0,0,16,0,0,0,1,0,0,0,1, 22,146, 36, 105, 145, 17, 17, 33, 17, 
-17,17,23,17,17,17,25,150,98, 36, 102, 67, 119, 119, 41, 121, 150, 102, 103, 119, 118, 121, 54, 
-150, 98, 36, 70, 67, 68, 71, 36, 68, 68, 68, 71, 66, 119, 119, 57, 70, 66, 50, 68, 67, 36, 68, 40, 68, 
-68, 67, 34, 66, 36, 68, 52, 36, 66, 34, 34, 35, 51, 51, 40, 34, 50, 40, 34, 35, 50, 34, 52, 36, 66, 50 
-34, 33, 49, 125, 40, 35, 131, 49, 50, 35, 50, 50, 20, 36, 66, 35, 34, 33, 17, 17, 40, 129, 51, 49, 18, 


-51, 50, 131, 18, 36, 34, 51, 51, 49, 17, 24, 33, 19, 
-161, 33, 51, 17, 19, 50, 17, 51, 19, 19, 50, 51, 51, 
-19, 50, 35, 49, 19, 17,161, 168, 34, 130, 35, 56, 3 
-85, 85, 85, 82, 85, 85, 85,82, 67, 49, 17, 42, 160, 
9,0,0,10,33,26,0,0 


; 
6 
" 
y 
6,6 
-0,9, 17,17, 84, 17, 17, 131 
-17,85,51, 17,177, 17, 17, 
-0,0,0,2,24,51,17, 17,17 
-162,214,0,0,0,119,84,9 
-17,17,17,27,54, 70, 111,0 
-51,52,50,34,162,38,49,1 
-0,0,0, 49, 35, 34,52, 72, 34, 


-70, 33,18, 34, 34,0,0,0,0,0,0 
-67, 68, 46, 131, 51, 51,51, 0,0, 
-0,0, 7,80, 0,6, 18, 35, 238, 102, 

84,68, 71, 84, 119, 117, 146, 3 


3, 
0,0,0,0,0,0,0,0,0, 
9 

0, 

,0,0,0,0,0,0, 29 
71,16, 85, 103, 14 
4,33, 17, 215, 131 
48, 68,59, 187,17 
, 

1 

1 


A " 
0,0,0,0,0,0,0,0,0,0,0 
01,86,97,0,6,6,6,0,0,0, 
01, 85, 86, 101, 183, 16, 0, © 
,17, 24,85,86, 232, 219, 34 
0, 0,1,51,17, 24,85, 102,52 
,0,6,6,6,0,1,102, 17, 24,86, 5 
4,84, 16,06,0,0,0,0,0,1, 101,1 
1,119, 226, 34, 16,0,0, 0, 0,0, 0 
34,16,0,0,0,0 
17, 24,52, 68, 66, 34, 34, 16,0, 0 
6,17, 23, 68, 68, 34, 34, 34, 16,0 
0,1, 99,17, 23, 68, 153,153,144 
8 
1 


n 


ic} 


; 
3. 
54,2 734, 16,0, 
, 23,66, 130, 34,130,34,16,0,0,0,0,0 
,17,17,17,17,17,17,17,17,0,0,0,0, 
-0,0,0,0,0,0,0,0,0,0,0,0 


; 
*// forward decls so that we can use thes 
*uint8 t SFG random(); 
*uinti16 t RCL sqrt(int32 t value); 
*int32 t RCL sin(int32 t value); 


-SEG PROGRAM MEMORY uint8 t SFG backgroun 
*uint8 t SFG brickPattern(uinti6 t index, 


Sy 0, city 

-64, 10, 73,168, 19, 12, 14, 13, 80, 1, 72, 101, 0,1 
-118,8,0,32,0, 46, 34, 154, 17, 17, 20, 85, 84, 85 
-17, 20,65, 68, 69, 119, 102, 99, 48, 48, 0, 2, 32, 3 
-104,0,2,14,34,154,17,17,17,20,69,69, 51,5 
-87, 60, 204,195,51, 0,0, 0, 2,34, 154, 17, 17,17 
-154, 17,17, 17,68,85, 119, 51, 51, 48, 3,0,0, 13 
-102, 104, 48, 46, 32, 32, 34, 154, 17, 17, 20, 69,8 
-154,17,17,17,69,87,51,51, 51,0,8, 48, 40, 32 
-243,51,0,0,128,2,34, 154,65, 17, 17, 20, 85,6 
-17,68,85, 51, 63, 51, 48,51, 8, 130, 130, 2, 34, 1: 
-0,46, 54,154, 17, 17, 17, 69, 85, 187, 85, 91, 102 
-51,51,0,8, 8,0,0, 32, 34, 154, 17, 17, 17,68, 77 
-17,68,77,219,51,51,0,8,48,0,0, 32, 34, 154 

-2, 34, 154, 17, 17, 68, 69, 63, 239, 204, 204, 51, 4i 
-51, 51,48, 240, 136,128, 14, 2, 34, 154, 68, 17, 7 
-34, 154,17,17, 20, 68, 69, 93, 219, 211, 48, 0,0, 
-0, 8, 48,0, 224, 32, 34, 154, 65, 20, 69, 85, 84, 21: 
-69, 85, 119, 123, 221, 219, 182, 104, 8, 32, 0, 32 

-102, 102, 158,0, 2, 34, 154, 17, 17, 20, 85, 87, 10 
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51,17,50,56,51,131, 18, 34, 66,50, 51, 49, 26, 
19, 49, 170, 161,35, 17, 17, 17, 18, 51, 19, 19, 
4,34, 33,131, 17, 34, 33, 49, 50, 53,85, 85, 37 
0,0,16,0,0,0,1,0,0,0, 10, 162, 33, 19, 160,0, 


19, 85, 57, 83,17,17, 
0, 7,119, 124, 34, 56, 33, 

7,40, 99,51, 0,0, 119, 117, 
177, 33,17,18, 99, 18, 34,0, 
5, 34, 180, 68, 50, 18, 131, 34, 
0, 66, 35, 35, 56, 68, 214,4 
,0,0,0, 85, 84, 84, 65, 35 
4,35,51,50,0,0,0,0,0,0 
7,221,34,102,102,54,10 
, 80, 0,3, 18, 34, 243, 51,2 
,0,0, 68,85, 85, 85, 67, 18 
,9,0,0,0,5,0,0,0,0,51, 


L 


1 
o 
o 
9 
0 
2 
1 
, 33,28 


i 
2 r 
31, 98, 232, 68, 55, 
26, 33, 17, 169, 33, 
11, 230,51, 80,0, 
6,146,97,0,0,0, 
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o 
9 
9 


e functions in progen of images: 


dlImages[3 * SFG TEXTURE STORE SIZE] = 
uint8 t width, uint8 t height) 


00, 136, 57, 17, 17, 17, 68, 87,119, 119,119, 
,119, 118, 102, 96, 0, 130, 130, 2, 34, 154,17 
4,154,17,17,17, 17, 68, 68, 87, 118, 102, 102, 
1,0, 8, 0, 224, 2,32, 34,154, 17, 17, 17, 20, 85, 
,68, 85, 119, 252, 204, 51, 224, 48, 0, 0, 32, 34, 
0,34,34,154, 17,17, 68, 68, 85, 119, 119, 102, 
7,119,119, 102, 102, 102, 128, 128, 0, 2, 34, 
,82,34,154, 17, 17,17, 20, 87, 60, 252, 252, 
0, 204, 204,51, 48, 48,0, 32, 32, 34,154, 17, 17, 
54,17, 17, 20,69, 103,181, 85, 86, 102, 0, 56,0, 
,3,15,0,0,2, 34, 154, 17,17, 17, 68, 85, 187, 
187,51, 51, 48, 0,142, 0,0, 2, 34, 154, 17, 17, 
47,17, 65, 69,51, 51,60, 204, 195, 51, 224, 0,0, 
8,224, 0,0, 32, 34,154, 17,17, 71, 69, 51, 51, 
1, 68,85, 221, 187, 219, 176, 8, 48, 40, 32, 46, 
0,0, 2,34, 154,17, 17, 68, 68, 77, 219, 221, 211, 
9, 221,179, 48, 0,136, 128,0, 2, 34, 154, 17, 68, 
34,154, 17, 17,68, 69, 87,107, 221, 187, 102 
7, 219,190,0,8,8,0, 0, 32, 34, 154, 17, 17, 20, 


-84,86,107,182,102,102,3,224,0,2,2,34, 154, 17, 17, 20,68, 71,103, 118, 110,0, 8,0, 40, 
-32,34, 154, 17, 17, 17, 68, 71,102,103, 102, 102, 102, 104, 128, 0, 2, 34, 154 

-, // 1, reddish scifi interior 

-168, 18, 17,19, 65, 153, 1, 9, 152, 232,0, 45, 61, 80, 96, 160, 18, 114, 34, 34, 34, 34, 34, 80, 0, 
-0,0,0,0,0, 0, 18, 114, 34, 34, 34, 34, 34, 80, 0,0, 0, 0,0, 0,0, 0, 0, 215, 34, 34, 34, 34, 34, 80 
-0,0,0, 0, 0, 0, 0,0, 119, 34, 34, 34, 34, 34, 80, 0, 0, 0, 0,0,0,0,0,0, 214, 34, 34, 34, 34, 34, 34 
-32,0,0,6,0,0,0,0,0, 118, 34, 34, 34, 34, 34, 34, 36, 69,0,0,0,0,0,0, 18, 118, 17, 17, 17, 17 
-17,17,20,69,0,6,0,0,0,0, 18, 118, 17, 17, 17, 17, 17, 17, 20, 69, 0, 0, 0,0, 0,0, 18, 118, 114 
-34) 34, 34, 34, 34, 116, 69, 0,0, 0,0, 0, 0, 18, 118, 130, 34, 34, 38, 0, 0, 0,0, 0,0,0, 0, 0, 0, 18 
-118,155,54, 54, 34,0,0,0,0,0,0,0,0, 0, 0,85, 86, 138, 34, 34, 34, 34, 41, 133, 0, 0, 0, 0, 0, 0 
-0, 86, 138, 17, 17, 17,17, 25, 133,85, 0, 0, 0, 0,0, 0, 0, 86, 138, 17,17, 17, 27, 25,132, 70, 0,0 


-0,0,0,0, 85, 85,85, 17,17, 17, 25, 132, 70, 0,0, 0,0,0,0,0,0,0,5,17,17,17, 25, 132, 70,0,0 


6,6,128, 17,17,17, 17, 25, 132, 70 
-0,0,0,0,0,16,118,128,17,17, 27, 17, 25, 246, 0,0,0,0,0,0,0,16, 118, 128, 17, 17, 17, 17, 


-132,0,0,0,0,0,0,0,16, 118,128, 51,51, 51, 51, 57, 246, 0, 0, 0, 0,0,0, 0, 16, 118, 130, 51,51 


51,51,50,132,0,0,0,0,0,0,0, 16, 118, 130, 51, 51, 51, 51, 50, 132,0,0,0,0, 0, 0,0, 16, 118 


-131, 51, 51,51,51,51,132,70,0,0,0,0, 0,0, 0,0, 5,60, 51, 51, 51, 51, 36, 70,0, 0, 0,0,0,0 
-0,5,51,51, 51, 51, 51, 36, 70,0,0,0,0,0, 0,0, 14, 229, 51,51, 51, 51,51, 52, 70,0, 0,0,0,0, 
-85, 85,51, 195, 51, 51, 51, 51, 52,64, 0,0, 0, 0,0, 0, 18, 114, 17, 17, 17, 17, 17, 17, 18, 64,0, 0 
-0,0,0,18, 113, 17, 17, 17, 17, 17, 17, 17, 64, 0, 0, 0, 0, 0, 0, 18, 115, 51, 51, 51, 51, 51, 80,0,0 
-0,0,0,0,0,18, 115, 51, 51, 51, 51, 51, 80,0,0,0,0,0,0,0,0 

^p d P red city at night 

-171, 1,175, 90, 172, 174,173, 25, 27, 30, 91, 103, 0, 0, 0, 0, 113, 23, 113, 17, 51,68, 68, 102, 1 
-85,82, 34, 34, 34, 38, 49, 113, 23, 113, 17, 51, 68, 68, 102, 102, 85, 82, 34, 34, 34, 35, 51, 113, 
-0,0,0,0,0,0, 68, 69, 85,19, 4, 101, 166, 17, 113, 0, 0, 4, 68, 102, 102, 85, 85, 81, 17, 19, 4, 10 
-38, 54,113, 0, 0, 4, 68, 102, 102, 85, 85, 81, 17, 19, 4, 101, 38, 51, 113, 0,0, 4, 68, 102, 102, 85 
-85, 82, 33, 19, 4, 101, 34, 49, 113, 0, 0, 0, 0,0, 0,0, 4, 69, 81, 19, 4, 101, 42, 17, 119, 17, 17, 17 
-17,0, 4, 68,102, 85, 85, 35, 4, 101, 42, 51, 135, 17, 17, 51, 51, 51,0, 0, 0, 0, 68, 83, 4, 101, 34, 
-152, 113,17, 59/51, 48, 0,4, 68, 102, 85, 19, 4, 101, 34, 83, 152, 113, 17, 51, 51, 48,0, 4,68, 1 
-17,19,4, 101, 42, 51,185, 113, 17, 51, 51, 48, 0, 4, 68, 17, 17, 19, 4, 101, 164, 17, 119, 17, 17, 
-51, 48, 0, 4, 68, 102, 82, 19, 4, 101, 165, 17, 119, 17, 17, 51, 51, 51, 0,0, 0,0, 69, 85, 85, 34, 37 
-51,119,113,17,17,17,16,4, 68, 102, 101, 82, 37, 85, 34, 34, 102, 119, 119, 17, 19, 51,0, 4, 7 
-102, 85, 34, 37,85, 34, 34, 34, 119, 119, 17, 17, 17, 0, 4, 70, 101, 85, 34, 37, 85, 34, 34, 34, 119 


-17,17,17,17,16, 4, 70, 101, 82, 38, 17, 48, 70, 51, 34, 113, 16, 0, 0, 0, 0,0, 0, 102, 102, 33, 17 
-48, 67,50, 38, 17, 16, 176, 176,0, 4, 68, 102, 101, 82, 33, 17, 48, 17, 51, 51, 113, 16,0,0,0, 4, 
-102,101, 82, 33,17, 48,17, 51, 50, 113, 16, 0,0, 0, 4, 68, 102, 101, 82, 38, 17, 48, 17, 51, 51, 1. 
-17,17,17,11,16,0, 0,0, 82, 34, 34, 34, 35, 50, 34, 136, 113, 17, 17,17, 19,0, 0, 70, 85, 85, 34 
-84, 36, 51, 36, 136, 115, 17, 16, 0, 3, 48, 0, 0, 0, 68, 102, 82, 36, 17, 17, 152, 135, 17, 16, 0, 0, 5 
-0, 4, 68, 85, 85, 34, 33, 17, 22,153, 135, 17, 16,0, 0,0,0, 0, 0,68, 102, 82, 37, 17,17, 153, 135 
-17,17,17,16,0, 68, 70, 101,1, 19, 4, 101, 81, 34, 152, 119, 16,0, 0,0, 4, 68,64, 17, 17, 19, 4, 
-101,34, 36,152, 119,16,0,0,0,0, 68, 70, 101, 1, 19, 4, 101, 35, 51, 135, 119, 16,0,0,0,0,4 
-101,85,34,34,34,35,54,119,23,16,0,0,0,0,0,0,4,69,82,34,34,35,51. 0 7 7’ 


; 
-SFG_PROGRAM_MEMORY uint8_t SFG_weaponImages[6 * SFG_TEXTURE_STORE_SIZE] = 
-// 0, knife 


~~ Or 
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‘ 
A 
: 8 
102,136, 49, 148, 68, 68 
-136,54, ,85,34,17, 102, 102, 111, 2 14,34,34,0,0,0,85,1 
-34,22,111,108, 97, 17,18, 118, 114, 53, 83,0,0, 85, 17, 22, 17, 17, 34, 34, 37, 85,87, 113, 11 
-51,83,0,5, 17,22, 24,130, 34, 17, 17, 24, 27, 37, 114, 51, 51, 83, 0, 81, 22, 98, 187, 184, 17,1 
-97, 17,34, 37,114, 51, 51, 51,5, 17,104, 187, 34, 134, 102, 102, 102, 18, 33, 37, 121, 51, 51 
-5, 22,139, 130, 40, 24, 140, 204, 129, 34, 17, 37, 121, 115, 115, 119, 81, 17, 85, 82, 82, 33, 28, 
-17,34,34, 37,125, 119, 115, 119, 51, 51, 52, 116, 68, 68, 49, 33, 21, 34, 82, 37, 125,55, 119,1. 
-0,0,0,0,0,0, 3,65, 35, 43, 226, 37, 125, 151, 71, 119,0, 0,0, 0, 0,0, 0, 3, 126, 35, 69, 37, 58, 
“147, 146,68, 6,0,9,0, 0,0, 0,0, 14,52, 4, 87,61, 147, 146, 0,0 9,0,0,0,0,14, 68 

0,0 

By 


Too 
TB Or 
HOO ~ o 
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NON 


-147,64,0,0 0,0,0,0,0,0, 74,147,64,0, 0,0,0, ,0,4, 26, 217, 6 
,170,167,64,0,0,0,0,0,0,0, 
68,0,0,0,0,0,0,0,0,0,0,0,0,0 ,0,0,0,0,0,0 

101,100, 99,25, 98,9,18,0,0,0,0,0,0, 
0,102,103, 91,170, 0,0,0,0,0,0,0,0,0,0,1, 22,67, 45, 186, 153 


" 
, 

172,131, 51, 71, 20, 91, 169, 170, 0, 0 1,35,1 
0,1,51,19, 131, 56, 130, 67, 50, 36, 66, 91, 186, 148, 0,0, 0,19, 51, 
8,93, 186, 154, 0,0, 0, 24, 134, 56, 131, 52, 68, 17, 194, 39, 18, 85, 2 
4, 68, 66, 34, 34, 34, 84, 21, 255, 185,0, 0, 6, 51, 50, 50, 34, 34, 34, 33 
-17,17, 23, 28,93, 169,0,0,87,114, 34, 08, 17, 17, 17,17, 17, 17, 23, 28, 85, 169, 0, 9, 188, 23 
-21, 97, 81, 85, 85, 85, 92, 92,197, 197,87, 218,0, 5, 85, 206, 236, 229, 85, 85, 117, 117, 119,1 
-119, 199,119, 221,0, 0, 7,204, 193, 17, 17, 17, 17, 17, 17, 17, 17, 252, 87, 218, 0, 5, 85, 204, 2 
-170, 169,153, 153, 153, 153, 153, 170, 170, 87, 169, 0, 0, 188, 199, 34, 193, 17, 17, 17, 17,17 
-23,17,85,169,0,0,87, 115, 50, 35, 51, 136, 51, 52, 68, 34, 39, 17, 01, 153, 0, 0,6, 136, 134, 5 
-136, 136,136, 131, 51,136, 136,65, 219, 185,0, 0, 6, 51, 54, 67, 51, 51, 131, 56, 136, 55, 24, 7 
-186, 187, 0, 0, 0, 98, 38, 35, 68, 68, 51, 34, 35, 55, 20, 45, 169, 148, 0, 0, 0, 100, 68, 100, 34, 34 
-44, 18, 17,67, 52, 219, 153, 68, 0,0, 0, 6, 68, 34, 34, 18, 38, 97, 28, 98, 34, 219, 171, 186,0, 0, 
-0, 102, 17,68, 33, 17, 108, 17, 103, 17, 91, 219, 171, 0, 0, 0, 0, 0, 102, 102, 20, 68, 34, 33, 103, 
-98,186,154,0,0,0,0,0,0,0, 102, 98, 34, 68, 70, 22, 91,186, 153, 0,0, 00,0, 0, 0,0, 6, 102, 


0,0,0,0,0,0,0,0,119,1 
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17, 
6, 
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6 
25, 
98, 


-44, 38, 93, 186, 153, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6, 102, 34, 101, 219, 153, 0,0, 0,0,0,0,0,0,0,0,0 


-0, 102, 103, 95, 170, 0, 0, 0, 0,0, 0,0, 0,0, 0,0,0,0,0,119,119,0,0,0,0,0,06,0,0,0,0,0,0, 


-0,0,0 
-, // 2, machine gun 

-175,2,4,3,1,5,6,0, 60,59, 50,53, 61,62, 74,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
-0,0,0,0,0,0,0,0,0 0,0,0 6,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 
-0,0,0,0,0,0,0,0,0,0,0,0,0,0,17, 20, 68, 64, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 17, 34, 51, 17, 20, 
-0,0,0,0,0, 0,0, 0,0, 1, 98, 17, 17,68, 71, 65,17, 16,0, 0, 0,0, 0,0, 0, 22, 33, 17, 20, 68, 70, 1 
-35,167,0,0,0,0,0,0,0, 22,33, 20, 68, 97, 22, 98, 50, 228,0,0, 0,0,0,0, 0, 118, 52, 70, 17, 1 
-102,34,34,20,0,0, 0,0, 0,0, 7, 51, 17, 22, 102, 102, 101, 37, 35, 20, 0, 0,0, 0,0, 0, 22, 102, 2 
-84, 82,140, 178, 84, 49, 50, 0, 0,0, 0,0, 1, 82, 34, 51, 50, 34, 43, 178, 51, 161, 68, 0,0, 0,0, 17 
-17; 34, 35,51, 152, 49, 19, 51, 161, 68, 68, 0,0, 1, 17, 88, 83, 34, 58, 19, 136, 37, 37, 50, 51, 13 
-85,0,0, 22, 150, 134, 99, 35, 147, 50, 34, 85, 85, 34, 51, 34, 85, 0, 0, 121, 24, 56, 209, 35, 51, 5 
-34,85,82,34, 51, 34, 37,0, 0, 113, 19, 18, 33, 35, 51, 34, 37, 85, 34, 37, 51, 34, 34,0, 0, 1, 119 
-49, 49, 147, 38, 101, 85, 85, 34, 85, 51, 130, 34, 0, 0,0, 0, 119, 113, 147, 50, 34, 86, 102, 86, 98 
-161,68,68,0,0,0,0,0, 7, 25, 34, 37, 85, 34, 37, 195, 51, 161, 68, 0,0, 0,0, 0,0, 113, 17, 17,5 
-53, 92,131, 51, 49, 20,0,06,0, 0, 0,0, 7, 19, 20, 65,17, 17, 19, 50, 51, 20,0, 0,0, 0,0, 0,0, 118 
-20, 65,68, 17, 17,50, 35, 20,0,0,0,0,0, 0,0, 22,17, 68, 68, 20, 65, 19, 51, 20,0,0,0,0,0,0 
-22) 33,17, 68, 68,65, 17, 51, 23, 0,0,0,0,0,0,0, 7,98, 49,17, 20, 119, 68, 68, 64, 0,0,0,0,0 
-0,0, 23, 34,51, 17,20,0,0,0,0,0,0,0,0, ,0,17,119,119,64,0,0,0,0,0,0,0,0,0,0, 
-0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 
a AS dy rocket launcher 

-475, 33) 7,39, 115, 2,0, 5, 117, 116, 4, 37, 114, 3, 36, 108, 0,0, 0, 0, 0, 0,0, 0,0, 0,0, 0, 13, 20 
-102,0,0,0,0,0,0,0, 0, 0, 0, 0, 0, 221, 218, 122, 85, 96,0, 0,0, 0, 0, 0, 0,0, 0, 0, 13, 34, 39, 16 
-51,96, 0,0, 0,0, 0,0, 0, 0,0, 0, 5, 170, 170, 165, 51, 96,0, 0,0, 0, 0,0, 0,0, 0,0, 5, 93, 221, 22 
-81,102,0,0,0,0,102, 102, 16,0, 0, 0, 17,102, 102, 102, 102, 204, 0, 0,0, 17, 170, 173, 214, 8 
-17,17,136,137,198, 204, 193, 206, 0, 0, 93, 122, 213, 81, 17, 17, 136, 136, 137, 68, 193, 236, 
-158, 238,0, 5, 170, 17, 22, 20, 148, 152, 148, 204, 196, 153, 66, 153, 136, 136,0, 90, 161, 17, 1 


-68, 76,68, 76,153, 153, 137, 40, 136, 136, 136, 5, 163, 17, 17, 73, 153, 201, 153, 201, 136, 139 
-190, 43,179, 51, 51, 5, 58, 81, 20, 136, 132, 136, 132, 139, 179, 55, 226, 51, 51, 51, 51, 13, 42, 
-24, 187, 180, 68, 68,178, 34, 34, 162, 34, 34, 34, 35, 215, 33, 17, 72, 187, 119, 114, 36, 34, 34, 
-162,35, 51, 51, 17, 211, 83, 21,131, 50, 34, 34, 46, 34, 34, 34, 162, 34, 34, 209, 51, 163, 37, 85 
-181, 51, 51, 34, 46, 34, 34, 34, 114, 34, 45, 51, 119, 163, 37, 85, 232, 51, 51, 51, 62, 51, 51, 51, 
-178,51,127,55,187, 211, 37, 85, 238, 238,238, 238, 228, 136, 136, 187, 226, 51, 115, 123, 18 
-215, 49, 81, 20, 68, 68, 73, 148, 153, 152, 142, 146, 235,175, 251, 153, 13, 58, 17, 28, 68, 68,6 
-68, 68, 68, 153, 67, 153, 175, 123, 153, 5, 122, 17, 81, 204, 196, 68, 68, 68, 68, 68, 67, 116,175 
-125,137,5,119,85,85, 97, 204, 204, 204, 204, 68, 68, 71, 36, 223,123, 185,0, 87, 117, 85,81 
-102, 17,17, 28, 204, 204, 196,58, 211, 123, 184,0, 5, 119, 165, 85, 81, 102, 85, 17, 17, 17, 204 
-167,211,119,187,0,0,81,122,513,85,85,22, 101,85, 17, 17, 74, 31, 119, 187,0, 0,0, 17,1 
-173, 214,16, 102, 102, 85,17,17, 31, 247, 119,0, 0, 0,0, 102, 102, 96,0, 0,0, 102, 102, 81, 31 
-119, 119, 0,0,0,0,0,0,0, 0, 0,0, 0, 0, 102, 23, 123, 182, 0,0, 0, 0, 0,0, 0,0,0,0,0,0, 0, 109, 
-123, 187,0, 0, 0, 0, 0, 0,0, 0, 0,0, 0, 0, 0, 97, 215, 136,0, 0, 0, 0, 0, 0, 0, 0, 0,0, 0, 0,0, 6, 109 
-255,0,0,0,0,0,0,0,0,0,0,0,0,0,0,6,102 T I I T T OOTO PPOO 


-, // 4, plasma gun 

, 187, 7,190, 37, 42,100, 209,0,0,0,0,0,0,0,0,0,0,0,0,2,80,1 
-17,0,0,0,0,0,0,0,0,0,0,37,0,44,149, 2 0,0 80, 2, 198, 80,134, 106 
-165,51,0,0, 0, 0,0, 0, 0, 44, 101, 2, 194, 37, 170, 170, 51, 51,0, 0, 0,0,0,0, 2, 201, 103, 88, 4 
-170,163,51,21,86,0,0, 0,0, 119,0, 2, 194, 37, 170, 74, 51, 52, 85, 102, 17,0, 0,0, 34, 68, 11. 
-40, 42,170, 172,67, 51, 70, 33, 17, 17,0, 0, 34, 52, 68, 130, 74,164, 51, 196, 51, 51, 110, 17,1 
-85,0,2,51, 66, 136, 170, 67, 51, 68, 67, 51, 52, 81, 17, 37, 51,0, 42, 52, 119, 170, 68, 51, 51, 5 
-51, 51, 66, 17,18, 68, 68, 2, 163, 55, 42, 163, 51, 52, 66, 221, 85, 93, 33, 17, 68, 17, 153, 2, 119 
-119, 118, 102, 102, 98, 33, 17, 18, 17, 18, 20, 73, 187, 187, 42,52, 17, 17, 17, 17, 17, 17, 17, 7 
-33,17,36,155, 149, 136, 36, 18, 119, 117, 86, 97, 20, 68, 68, 68, 36, 68, 33, 185, 83, 67, 35, 68 
-65, 39, 150, 150, 22, 22, 145, 105,22, 145, 27, 181, 51, 20, 35, 68, 17, 39, 185, 185, 185, 185, 1 
-155, 185, 187, 187, 182, 52, 20, 35, 65, 18, 39, 150, 150, 22, 22, 145, 105, 22, 145, 27, 182, 68, 
-33, 34,119,117, 86,97, 20, 68, 68, 68, 36, 68, 33, 185, 97, 33, 36, 17, 19, 51, 51, 51, 51, 51, 51 


-51,35,51, 36, 155, 150, 88, 2, 119, 118, 102, 102, 102, 34, 36, 68, 50, 51, 50, 52, 73, 187, 187,2 


-17,39, 33, 17, 17, 17,18, 101, 101, 85, 99, 51,68, 17, 153, 0, 34, 18, 117, 34, 34, 17, 17 , 17,17 
-17) 229,51, 50, 68, 68,0, 7, 34, 34, 88, 119, 114, 17, 119, 209, 17, 17, 83, 51, 37, 51,0, 0, 119, 
-39, 136, 247, 47,34, 45,17, 17, 110, 51, 50, 85,0, 0, 0, 119, 119, 128, 136, 85, 119, 34, 114, 33 
-22,228,51,51,0,0, 0,0, 136,0,8, 198, 87, 117, 242, 34, 33, 102, 85, 67,0, 0,0, 0,0, 0,8, 201 
-101, 136,85, 82,34, 34, 34, 85, 0,06, 0,0, 0, 0, 0, 140, 152, 8, 201, 136, 82, 34, 34, 34,0, 0,0, 0 
-0,0,8,128, 8, 198, 128, 134, 101, 34, 54, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 136, 0, 140, 152, 133, 85,0, 
-6,0,0,0,0,0,0,0,0,0, 8, 128, 8,136, 0, 0,0, 0, 0,0, 0,0, 0,0, 0,0,0,0,0,0 

-, // 5, solution 
-6,76,175,48,26,5,4, 7,57, 17, 75, 27, 58, 2, 28, 68, 34, 34, 34, 34, 34, 34, 34, 34, 45, 221, 21 
-34,35, 51, 50, 51, 34, 34, 34, 51, 51, 34, 34, 34, 55, 7, 119, 50, 48, 6, 67, 21, 34, 34, 51, 69, 86, 
-56, 45, 112, 87, 119, 3, 8, 136, 68, 161, 34, 34, 53, 102, 70, 102, 68, 215, 0, 87, 7, 102, 131, 173 
-133, 170, 34, 34, 48, 182, 68, 70, 103, 112, 0, 231, 0, 100, 134, 108, 218, 90, 34, 34, 48, 96, 181 
-68, 112,0, 0,231, 0, 84,134, 119, 74,165, 34, 34, 53, 176, 96, 183, 0,0, 5, 21, 80, 4, 77, 7, 124 
-170,34, 51,53, 70,102, 112, 0, 5, 105, 145, 21, 0, 70,0, 7, 202, 51, 85, 104, 136, 71,0,0,97,1 
-153,17,85,0,0,0, 124, 48, 70, 102, 104, 135, 0, 6, 17, 31, 25, 17, 17, 85,0, 0, 7, 48, 180, 68, 7 
-103, 0, 81, 17, 17, 17,153, 17, 25, 80,0, 0, 48, 101, 182, 68, 71, 0, 81, 17, 26, 17, 249,145, 17, 
-0,5, 48, 224,96, 230, 71,0, 101, 17, 17, 17, 25, 145, 17, 23, 0,02, 53, 176, 224, 96, 71,0, 105, 
-250, 241,241,153,17,25,0,202, 51,54, 70, 181, 64, 0, 97, 150, 144, 154, 15, 153, 17, 23,0, 1 


-34, 35, 68, 68,64, 5, 97, 31,127,122, 122, 25,145, 16, 85, 134, 34, 35, 56, 136, 128,0, 97, 31,1 


-15, 10, 17, 145, 25,0, 134, 51, 51, 68, 68, 64, 0,97, 26, 145, 144, 159, 17, 25, 23, 0, 138, 53, 10 
-70, 69, 176,0, 97, 17,169, 170, 241,17, 25, 151,0, 138, 53, 176, 176, 224, 183, 5, 07, 17, 25,1. 
-17,17,17,151,0,88, 48, 224, 96, 101, 183, 5, 81, 17, 26, 153, 241, 17, 17, 112, 0, 5, 53, 101, 2 
-180,135,0,85,17,17,25,145,17,80, 0,0, 0, 53, 228, 77,136, 135,0, 5,81, 26, 25,97, 7,5,0 
-6,51,68, 136, 132, 71,0,0, 85, 81, 17, 151, 0,0, 80,0, 76, 34, 51,133, 70, 70, 112, 0, 85,5, 16 
-112, 0, 102, 5, 100, 204, 34, 34, 53, 176, 220, 71, 0, 5, 80, 231, 0, 5, 68, 102, 76, 204, 34, 34, 48 
-224, 182, 68, 112,0, 85, 231,0, 6, 72, 68, 204, 197, 34, 34, 48, 182, 68, 68, 71, 112, 5, 87,0, 10 
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67 
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-68 
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-47 
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1,37, 24, 136, 114, 38, 159, 101, 235, 181, 35, 181, 112, 0,0, 0, 1, 37, 


pisi 

-23 
-23 
-13 
-20. 
E 

-84 
-16 
-29 
20, 

26, 

-17 
-11! 
-17 
-68 
-10. 
-17 
ET 

-34 
-96 
-11 
-101 
a, 


4,141, 220, 90, 34, 34, 53, 68, 68, 136, 136, 55, 5, 96, 5, 100, 3, 173, 133, 170, 34, 34, 51,136, 
6, 51, 51,35, 112, 102, 100, 136, 64, 136, 132, 161, 34, 84, 34, 51, 51, 34, 34, 84, 54, 102, 68, 
, 56, 100, 67, 21, 34, 34, 34, 84, 34, 34, 84, 34, 85, 51, 51, 34, 35, 51, 50, 51 


G PROGRAM MEMORY uint8 t SFG effectSprites[4 * SFG TEXTURE STORE SIZE] - 


0, explostion 

5,183,174, 15, 103, 111, 191, 7, 31, 95, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,48,48,0,0,0 

0,0,0,0,0,0,0,3, 3, 3, 3, 19, 3,0, 0, 0, 0, 0, 0, 0, 0, 0, 48, 48, 16, 51, 49, 19, 48, 48,0, 0, 0, 0, 
9,0,3,3, 1, 1, 19, 17, 131, 51, 49,0,0,0,0,1, 16,0, 0, 48, 50, 34, 20, 85, 120, 49, 17, 64,0, 0, 
0,65,1,0,0, 34, 17,69, 87, 117,17, 33,16, 0, 0, 0,0, 4,16, 16, 4, 18, 17, 21, 87, 85, 18, 33, 16, 
0,0,1,9,34, 34, 17, 34, 17, 21, 85, 85, 66, 17, 48, 0,0, 0, 65, 18, 34, 34, 17, 65, 22, 85, 86, 68, 
, 19, 51,0, 0, 48, 17, 34, 34, 33, 18, 65, 68, 70, 68, 68, 102, 67, 51,0, 1, 19, 49, 34, 34, 33, 18, 

, 132,100, 70, 97, 20, 81, 17, 51, 48, 17, 18, 34, 18, 18, 34, 33, 119, 85, 86, 97, 33, 81, 51, 48, 3, 


, 18,33, 17,34, 33, 37, 119, 85, 100, 97, 18, 35, 51, 0, 48, 49, 34, 18, 34, 33, 102, 87, 119, 117, 
117,34) 34,16, 48, 1, 17, 18, 33, 17, 22, 104, 119, 119, 117, 81, 18, 18, 33, 67,0, 1, 65, 18, 33, 
, 71,119,119, 119, 119,132, 65, 18) 34, 64, 48, 0, 69, 81, 17, 86, 69, 88, 119, 119, 133, 81, 17, 
34,147, 0,0, 56, 21, 69, 86, 70, 103, 119, 119, 116, 17, 18, 34, 34, 144, 0, 3, 51, 56, 86, 102, 
2,120, 118, 101, 120, 81, 34, 34, 35, 0, 0, 48, 51, 17, 85, 102, 102, 103, 70, 102, 136, 85, 34, 34, 
,0,9,5,49, 19,53, 84, 102, 100, 70, 162,88, 133, 84, G6, 17, 19, 0,48, 51, 51, 85, 68,102, 68, 
, 102, 101, 97, 33, 68, 19, 17, 48, 3, 3, 49, 81, 36, 84, 17, 70, 101, 82, 33, 18, 33, 67, 51, 0,0, 
, 49,17, 33, 33, 33, 70, 102, 66, 34, 34, 34, 17, 51, 48, 0, 3, 17, 18, 34, 33, 34, 20, 129, 18, 34, 
, 84, 34, 51, 0,0, 49, 17, 34, 33, 17, 17, 33, 65, 34, 34, 17, 18, 34, 19, 48, 0, 1, 18, 33, 17, 17,1 
,34, 33,145, 17, 18, 34, 19, 48,0, 1, 17, 17, 19, 49, 49, 18, 17, 49, 19, 49, 18, 34, 35, 51, 0,0, 
,51,51,17,49,1i , 19, 51,17, 17, 36, 3,0, 3, 51, 51, 48, 48, 3, 17, 16, 48, 17, 3, 51,17, 
16,8, 3,48, 3, 3,0, 0, 16, 19, 6, 6, 0, 1, 81, 0, 0,6, 81, 0,6, 0,0, 0,1, 3, 48, 0, 51, 51, 48, 6,0 
1, fireba 


5,103, 183, 7, 191, 111, 254, 31, 95,180,173,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 0, 0,0,0, 
9, 0,0, 0, 0, 0,0, 0,0,0, 0, 0,0, 0,0, 0, 0, 0,0, 0,0, 0, 0,0,0, 00,0, 0,0, 1, 17,0, 16, 0,0, 0,0, 
B08 8 8457847 81 e 8 26 4825 65,20 04. 2 C8 66 
,0,0,0,6,0,0,8,17,17, 113, 83, 51,85, 119, 28, 118,0, 0,6,0, 6,0, 1,21, 113, 81, 19, 53, 81, 
,119, 129,0, 0,0,0,0,0, 17,19, 53,17, 19,50, 17, 17, 113, 16, 16, 0,0, 0,0, 1, 33, 83, 49, 17, 
,66,34,17,17,18,0,0,0,0, 0,0, 33, 85, 53, 21, 19, 18, 34, 34, 24, 18, 16, 0, 0, 0,0, 1, 33, 85, 


6,6,6,6,6,0, 2, 54,102, 96, 16 
9,0 9 


6,6,0,0,0,0,0,1, 17, 18, 34, 36, 38, 38, 12 
i 

r 0,0,0,0, 0, 
r 0,0,0,0,0,0,0,0,0,0,0,0, 


8 
9,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
6,6,6,6,6,0,0,0,0,0,0,0,0,0, 17,68, 16,0 
6,6,6,0,6,6,0,0, 17,18, 7,113, 20, 17,119, 1, 
16,0,0,0,0,0,0,1, 36, 34, 1, 19, 153, 51, 33, 65 
50,16, 0,0,0,0,0,0,114, 37,82, 2, 17,51, 170 
2,138, 43,178, 16,0,0,0,0, 1, 20, 34,52, 83, 163 
,0,0,0,0,1, 17, 18, 35, 51, 51, 34, 18, 34, 194, 36, 68,0, 0,0,0,0, 17, 17,1 
134, 34,51, 17,0, 0,0,0,1, 7,113, 34, 134, 136, 34, 211, 70, 34, 131, 17,0, 
1134, 34,84, 97,17, 102, 98, 16,0, 0, 0,0, 0, 1, 18,85, 84, 17, 98, 97, 33, 22, 08, 1,0 
37,83, 242, 68, 70,18, 146, 33, 23,16, 0, 0,0, 0, 1, 50, 53, 35, 134, 133, 65, 39, 185 
6,0,0,0, 19, 147, 34, 136, 51, 81, 39, 190, 36, 65, 32, 0, 0,0, 0,0, 17, 18, 34, 131, 34, 8 
, 34, 32,0,0, 0,0, 1, 1, 17, 34, 34, 34, 57, 50, 114, 49, 34, 0,0,0, 0,0, 0, 16, 17, 34, 34, 83, 
RATTAN TT ER E UDR ELE DU 
6,0,0,0,6,6,0,6,6,0,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 


,34,67,50,33, 
, 32,51, 57, 163, 
, 51,83, 34, 17,3 


DU 
~~ HOOH 
aS Gee 


© 


rn 
(((index / SFG_TEXTURE_SIZE) % height) !- 0) && 
P (index % SFG TEXTURE SIZÉ + ((index / (height * SFG TEXTURE SIZE)) % 2 


% width) !- 0); 


G PROGRAM MEMORY uint8 t SFG monsterSprites[19 * SFG TEXTURE STORE SIZE] - 
nt8 t SFG circle(uinti6 t index, int8 t cX, int8 t cY, uint8 t r) 


0, spider idle 

5,0,4,3,5,6, 223,1, 7,10, 2, 20,62, 95, 120, 18,0, 1, 17, 16,0, 0,0, 0, 0,0, 0,0, 1, 17, 16,0, 
20,45,65,0,0,0,0,0,0,0,0, 21,52, 33,0, 1, 65, 170, 20, 16,0, 0,0,0,0,0, 17, 133, 50 

,1, 218,211, 162, 16,0, 0,0,0,0, 17,133, 84, 17, 17, 17,1, 42, 61, 173, 16, 1, 0, 0, 0, 1, 133, 

,33,0,0,0,1,65, 170, 20, 17,1, 16,0, 1, 24, 85, 73, 16,0, 0,0, 0, 20, 210, 71, 119, 19,81,0,0, 
19,146,16,0, 0,0, 1,115, 17, 115, 115, 68, 65, 0,0, 0, 1, 66, 49, 0,0, 0, 20, 36, 119, 41, 37, 69, 


16,0,0,1,66,49, 17, 17, 0, 18, 50, 115, 21, 85, 68, 68, 33,0, 1, 17, 51, 133, 52, 66, 16, 20, 45 
5,25,197,66,66,65, 1, 24, 136,85, 85, 50, 35, 49, 1, 17, 37, 86, 198, 196, 34, 33,0, 1,85, 85, 
,153, 153, 145,0, 21,85, 70,140, 102, 34, 34, 16, 0, 147, 57, 147, 51, 35, 16,0, 17, 119, 60, 
4,102,98, 34, 46, 238, 191,66, 243, 17, 17, 17, 1, 57,115, 115, 38, 108, 198, 34, 231, 243, 187, 
6,33,0,0,0,18, 49, 153, 151, 34, 104, 198, 62, 255, 59, 180, 51, 112, 0,0, 0, 18, 49,51, 55, 34, 
4, 198,62, 255,59, 180, 51, 112, 0,0, 6, 1, 57, 121, 115, 38, 108, 198, 34, 231, 243, 187, 116, 


33, 0,0,0,0,17, 119, 60, 104, 102, 98, 34, 46, 238, 191, 66, 147, 17, 17, 17, O, 21, 85, 70, 140, 


2,34,34,16,0, 148, 41, 147, 51, 35, 16, 1, 17, 37, 86, 198, 196, 34, 33, 0, 1, 136, 136, 133, 153, 
3,145, 20, 45, 113, 28, 197,68 66,65, 1,21, 85, 85, 85, 52, 66, 49, 18, 50, 115,21 85, 84, 68, 
0,1, 17, 51, 133, 50, 35, 16, 26, 36, 119, 41, 37, 85, 85, 16,0, 0,1, 66, 55, 17, 17,0, 1,115, 17, 
5,115, 68, 65,0,0,0,1, 66, 49,0,0,0,0,20, 45, 71, 119,19, 81, 0, 0, 1, 19, 50, 16,0,0,0,1, 

, 170, 20,17,1,16, 0,1, 24, 136, 137, 16, 0, 0, 0, 1, 218, 61, 162, 16, 1, 0,0, 0, 1, 133, 85, 129, 
6,0,1,42,211,173,16,0,0,0,0,0, 17,69, 85, 17, 17, 17, 1,65, 170, 20, 16,0, 0,0, 0,0,0,17 
, 50, 35, 16, 6, 20, 219, 65, 0, 0, 0, 0, 0, 6, 0, 0, 20, $6, 49, 6, 6, 1,17, 16, 6, 0,0, 0, 0,0, 0, 0,1, 
" 1, spider attacking 

5,0,183,3,4,1, 191, 5, 31,6, 7, 22, 10, 223, 20,18, 0,34, 37, 85, 43,176,0,0,0,0,0,0,17 
,16,0,0, 34,98, 34, 38, 102,0,0,0, 0,0, 1, 148, 71, 65, 16, 0, 2, 08, 34, 102, 98, 6,6,6,0,0, 
,169,52,51, 49,0, 2, 104, 40, 102, 32,0, 0, 0,0, 5, 170, 145, 17, 17, 16, 2, 38, 104, 136, 98, 32, 
,0,0,0,90, 167, 65,0,0,0,2, 102, 102, 102, 102, 34, 85, 0, 0, 5, 184, 124, 16,0, O, O, 2, 102, 
34,102, 102, 252, 80,9, 91,139, 16, 16,0, 6,9, 2, 34, 46, 54, 36, 102, 187, 113,0, 85, 84, 196, 
717,17, 0,0, 91, 235, 85, 34, 107, 136, 145, 0, 0, 5, 115, 10, 71, 116, 16, 0, 04, 238, 94, 88, 139, 
9,116, 80, 0, 85, 58, 169, 52, 67, 49, 0, 23, 75, 85, 91, 184, 231, 71, 80, 5, 170, 153, 119, 60, 
4,17,0,1, 21,232,141, 141, 116, 68, 16, 88, 137, 119, 204, 195, 49, 0, 0, 1, 153, 136, 189, 169, 
2,68, 65,1, 195, 60,51, 51, 67,16,0,1, 17, 85, 55, 218, 221, 212, 68, 85,95 116, 243,49, 17, 
, 0,19, 197,51, 83, 77, 217, 125, 69, 95, 62, 87, 65, 16, 0, 0, 1, 67, 49, 204, 197, 68, 218, 157, 
1243, 235,51, 80, 0, 0, ©, 1, 67, 193, 51, 53, 68, 218, 157, 95, 243, 235, 51, 80,0, 0,0, 0, 19, 
S LIE oe Me er SNe ROL ICT 
1,141, 196, 68,16, 90, 170, 170, 204, 195, 49, 0, 0, 23, 75, 85, 91, 184, 235, 71, 85, 5, 183, 153, 
0,60, 204,17, 0,94, 238, 94, 88, 184, 187, 116, 80, 0, 85, 55, 153, 52, 67, 49, 2, 43, 235, 82, 34, 
PME ER ER GRR UREN TRUCE EI ETE RT 
185,172,16,0,0,0, 2, 38, 136, 134, 34, 80, 80, 0, 0, 0, 88, 167, 65,0, 0,0,0, 182, 136, 134, 98, 


,0,0,0,0,5, 185, 145, 17, 17, 16, 0, 34, 102, 102, 102, 32, 0, 0, 0, 0,0, 87, 153, 52, 51, 49,0,2, 
,34,102,107,0,0,0,0,0, 1,116, 71, 65, 16,0, 2, 37, 82, 43, 32,0, 0,0, 0,0, 0, 17, 17, 16,0 
// 2, spider walking 

5,0,4,5,6,3, 223,1, 10, 7, 2, 18,62, 95, 120, 63,0, 0, 17, 17,0, 0,0, 0,0,0,0, 1, 17, 17,0,0, 
1,50,211,16,0,0,0,0,0,0,21,51,50, 16,0, 0, 19, 26, 161, 49, 0, 0, 0, 0, 0, 17, 146, 35, 33,0, 
0, 29,173, 90, 33,0,0,06,0, 1,148, 68, 81, 16, 0, 0, 0, 18, 165, 218, 209,0, 16, 0,0, 25,67, 49, 
6,0,0,0, 19, 26, 161, 49,16, 17,0, 1,148, 51, 16,0, 0,0 1,61,35,119, 113, 84, 16, 25 
,56,0,0,0,0, 0,0,23,81, 23,87, 83,51, 16, 17,21, 129,0,0,0,0,0, 1, 50,55, 114, 180,67,” 


, 
,65,0,1, 50,16, 0,0, 0, ©, 1, 37, 39, 81, 68, 67,51, 50,0, 1, 85, 81, 17, 17, 17,0, 1, 50, 215, 17, 
4,67, 35, 35, 16, 25, 153, 148, 68, 83, 50, 16,0, 17, 18, 68, 111, 108, 50, 34, 16, 1, 68, 68, 68, 
37,81,0,1,68,67, 105, 246, 98, 34, 33, 0, 133, 88, 136, 136, 136, 129, 0, 1, 23, 117, 198, 150 
2,34, 34,238, 227, 37,181,17,0,0, 0,21, 135, 87,82, 102, 252, 98, 46, 123, 91, 50, 81,0, 0,0, 
24,136, 114, 38, 159, 101, 
5, 181, 35,181, 112,0, 0,0,0, 21, 135, 87, 82, 102, 252, 98, 46, 123, 83, 123, 33, 0,0, 0, 0,1, 
, 117,198, 150, 102, 34, 34, 238, 235, 50, 133, 17, 17,0, 0, 1, 68, 67, 105, 246, 98, 34, 33,0, 
1,40, 85,85, 34, 16,0, 17,18, 68, 111, 108, 50, 34, 16, 1, 148, 35, 17, 17, 17,0, 1, 50, 215, 17, 
4,67,35, 35, 16, 25, 50, 16,0, 0,0, 0, 1, 37, 39, 81, 68, 67, 51, 50, 17, 148, 72, 136, 128,0, 0,0, 
50,55, 114, 130, 67, 68, 65, 20, 68, 73, 148, 136, 128, 0, 0, 0, 23, 81, 23, 87, 83, 51,16, 1, 17, 
68,83,56,129,0,0,1, 61, 35, 119, 113, 84, 16, 0, 5, 21, 68, 82, 34, 81, 0, 0, 19, 26, 161, 49 
,17,0,0, 20,66, 87,18, 37,16, 0,0, 18, 165, 218, 200,0, 16, 0,0, 1, 84, 52, 65, 17, 81, 17,0, 
,173,90, 33,0,0,0,0,0, 17, 19, 52, 82, 37, 16,0, 19, 26, 161, 49,0, 0,0, 0, 0,0, 1, 19, 82, 81, 
6,1,50,211,16,0,0,0,0,0,0,0,1, 17, 16, 0, 0,0, 17, 17,0, 0,0, 0, 0,0, 0,0,0,0,0,0 
// 3, destroyer idle 
175,3,4,5, 73, 1,6, 2, 77,157, 79, 7,78, 76, 75,17, 0, 0,0, 17, 17, 17, 17, 17, 17, 17, 17, 17, 
,17, 17,17, 11, 221, 219,0, 17, 17,17, 16,0,0,0,0,0, 1, 17, 17, 11, 217, 153, 219, 1, 17, 16,2, 
9,114, 39, 116, 119, 1, 17,17, 11, 189, 154, 155, 1, 16, 12, 194, 124, 204, 204, 199, 204, 1, 17, 
, 16, 189, 154, 169, 176, 12, 199, 116, 35, 51, 51, 50, 51, 1, 17 , 17, 17, 11, 217, 170, 213, 196 
,67,34,54, 34, 40, 34, 0,0, 17, 16, 11, 217, 154, 149, 52, 50, 50,0,0,0, 0,0, 4,64, 17, 7,118, 
2,138,173, 83, 68,128, 17,17, 17, 17, 7, 114, 32, 16, 116, 12, 66, 106, 169, 181, 51, 71,0, 1, 
,0,115, 56, 128, 16, 67, 0, 102, 102, 42, 213, 35,52, 71, 112,0, 119, 51, 40, 128, 7, 48, 194,0, 
114,171,82,51, 68, 71, 114, 83, 34, 40, 128, 4, 12, 204, 64, 0, 71, 106, 181, 131, 52, 68, 71, 82, 
, 40, 80, 4,12, 199, 114, 192, 36, 70, 157, 184, 52, 119, 116, 37, 40, 133, 80, 0, 204, 119, 119, 
14,70, 169, 213, 55,51, 55, 69, 80, 102, 96,0, 102, 103, 116, 44, 4, 50, 106, 155, 83, 157, 147, 
7,34,06,0, 2,9, 230, 68, 32, 3,50, 106, 173, 83, 57, 211, 53, 34, 1, 17, 2, 11, 150, 68, 48, 3, 50, 
6, 233, 83,57, 211,53, 34,1, 17, 0, 34, 36, 67, 44, 3,50, 106, 238, 83, 157, 147, 37, 34, 128, 0, 
119, 68, 67,128, 3,54, 254, 229, 34, 51, 50, 53, 88, 50, 32, 6, 7, 68, 50, 192, 131, 38, 174, 245, 
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== 0) * 


-35,34,35, 37, 34, 40, 128, 2,4, 68, 48,0, 50, 1 
-3, 38, 254) 86, 130, 34, 34, 34, 88, 34, 40, 128, 
-136, 40, 80, 16, 51, 99, 38, 105, 154, 245, 130, 
-238, 88, 134,96, 17,7, 66,6, 0, 101, 80, 17, 16 
-17,6,96,17,17,11,186,170,245,96,130,51 
-246, 5,180, 51, 51,51,50, 80, 17,17, 17,17,1 
-17,17, 11,221, 170, 255, 1, 17,16, 85, 85, 0, 
-17,17,17,17,17,17,17,0,0,0,17,17,17,17 
-, // 4, destroyer attacking 
-175,0,3,4,73,1,5, 2,183, 6, 77,157, 79, 78, 
-17,17,17,0,0,0,0,0, 136,136, 128, 0,0, 0,0 
-0, 0, 0, 28, 218, 170, 220, 16, 1, 88, 136, 136, 2 
-238/ 136, 136, 255, 136, 128, 0, 0, 0,0, 28, 218 
-0, 0, 0,1, 221, 171, 187, 163, 102, 255, 255, 13 
-99, 99,56, 136, 0,0, 17, 86, 97, 1, 150, 37, 230 
-99,37,85,85,82, 211, 35, 54, 98, 17, 17, 249, 
-255, 243, 70,50, 39, 113, 22, 53,238, 230, 17, 
-19, 49, 238, 153, 46, 18, 102, 125, 151, 57, 51, 
-90, 215, 51, 173, 163, 148, 68, 116, 65, 18, 21, 
-69, 81, 19, 33, 163, 86, 98, 17, 51, 37, 189, 67, 
-87,58,67,173,163, 36, 34, 16, 0, 19,18, 34, 1 
-18,89, 150,102, 55, 17, 51, 82, 52, 35, 34, 35, 
-35,51,50, 116, 34, 39, 113, 19, 37, 102, 99, 17 
-22, 33, 17, 50, 82, 69, 114, 34, 36,68, 71, 34, 3 
-23, 119, 39, 65, 1,51, 37, 50, 87, 171, 68, 21,8 
-50, 65, 87, 88, 17, 150, 103,113, 17, 84, 65, 0, 
-21, 81,0, 1, 204, 219, 187, 36, 20, 114, 51, 51, 
-119, 34, 34, 34,65, 16,0, 0,0, 0, 28, 205, 187, 
-187,33,0,0,1, 17,17, 16,0,0,0,0,0,0,28,2 
-16,6,0,0,0,0,0,0,0,0,0,0,0 '  ' ' " 
-, // 5, destroyer walking 
-175,0,3,4,1,5,2, 73,6, 77, 19,7, 78,157 , 75 
-26,204,202,17,0,0,1,17,17,17,0,0,0,0, 
-17,0,0,0,0, 26, 172, 157, 154, 16, 27, 179, 40 
-161, 184, 136, 50,51, 59, 184, 102, 16,0,0,0, 
-0, 0, ©, 1, 26, 201, 157, 151, 53, 35, 97, 17, 18, 
-16,0,1,17,97, 17,85, 16, 1, 133, 36, 181, 36, 
-68, 68, 119, 199, 35, 58, 88, 129, 17, 136,51, 1 
-130, 115, 34,102, 16, 21, 52,187, 181, 17, 21, 
-187, 136, 43, 18, 85, 76,214, 53, 136, 133, 39, 
-56,51,56, 87,118, 119,16, 18, 20, 68, 136, 82 
-19, 33, 159, 69, 82,17, 51, 36, 220, 115, 57, 19 
-249, 115,57, 195, 55, 34, 97, 17, 19, 18, 34, 85 
-18, 72,133, 85,54,17,51, 78, 247, 34, 51, 50, 
-35, 34, 35, 39, 34, 38, 97,19, 36, 85, 83, 17, 19 
-21, 33, 17,50, 78, 116, 98, 34, 34, 38, 118, 34, 
-17, 22,102,103, 113, 1, 51, 36,50, 70,157, 11 
-109, 254,113, 70, 65, 23, 97, 16,0, 1,20, 65,0 
-1,17,0,0,26, 173,221, 231, 65, 98, 51, 85, 13 
-51,51,53,0,0,0,0,0, 26,172, 221, 222,16,1 
-16,0,0,17,17,17,16,0,06,0,0,0, 26, 205, 23 
-0,0,6,6,0,0,0,0,0, 

-, // 6, warrior idle 
-175,0,3,5,1,4,6,62,2,7,92, 170, 151, 93,9 


-0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 


-149, 204, 204/187,176,0,0,0,0,0,0,0,185, 
-0,1,255,204, 119, 119, 119, 119, 119, 119, 19 
-133/16,6,0,0,0,0,0,0,0,0,0,0,0,0,1, 85, 
-1,19,53,81,0,0,0,0,0,0,0,0,0, 1, 33, 1,22 
-51,51,33,0,0, 25, 16,0, 17, 16,0, 0, 18, 40,1 
-178, 85, 85,54,51, 50, 68,0, 0, 19, 105, 155, 2 
-51, 54, 178, 54,129, 130,55, 218, 211, 38, 51, 
-211,38,99,51,36,0,1,17, 34, 85, 51, 102, 56 
-51,51,88, 34,58, 173,50, 86,99, 53, 81, 0,1, 
-36, 0, 0, 0, 18, 85, 85, 85, 136, 40, 163, 50, 57 
-162, 43, 149, 54,180, 68, 68, 0, 0, 21, 85, 43, 2 


, 
0,0,0, 1, 18,36, 68,68,0,0 
,1,17,16,0,0,0,0,0,0, 0, 


3 
9 
o] 
o 0,0,0,0,0,0,0,0,0, 


AY Ek 


D 
, 
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FS ooc zooo- 


, 
1 
t 
1l 
D 
D 
j 
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1 


NI © 
~ 6000-0009 

© 
UES ~~ 


" OOO POR 


, 
-1,136,135, 72,85, 147,53, 119,0, : 
-0, 19, 51, 154,163, 152, 136, 50, 36 5, 
-36, 74, 83,53, 119,0, 0, 1, 17,17, 86 47 
-51, 54, 133, 34, 43, 180, 68, 165, 51,67,0,0,1 
-97,0,0,0, 1, 86, 102, 102, 104, 133, 50, 34, 34 
-34, 68, 68, 68, 69, 133, 87, 0, 0, 1, 86, 101, 205 
-101,17,29,197,16, 7,130, 34,187,180, 68,1 
-68, 42, 119, 0,0, 1, 16, 0, 0, 0, 2, 34, 36, 68, 68 
-68,68,68,23,0 ,6,0,0,0,2, 43,1: 


9,0, 
70,8, go” tas ,0,0,0,0,0,0, 


o 
z m 
-175,0,72,65,2 
o 
o 


2,9 
0,0 
0,0 
0,0 
ri, 
ri, 
rol 
713 
1,1 


D 
" 

n 

ic} 
0 
1 
8 
5 


oo 
222 
2 
o 
2 
o 
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-2,34,34,0,0, 
-56,171,32,0 
-171,50,34,57, 
-68, 65, 0, 2,163, 
-0,0,1,65,0,0,0, j 
-136,34,17,17,17,17,68,65,0, 0,0, 36, 101, 
-0,0,0, 3,122, 529,61, 136, 137, 242, 17, 17,1 
-65,0,0,06,28,16,0,0,0, 2, 118, 174, 101, 51, 
-238, 85, 82,52,65, 1,119, 119, 102, 102, 85, 6 
-85, 68, 68, 65, 0, 2, 118, 174, 102,83, 50,53, 8 
-179, 37,81, 0,0,0, 20,16, 0, 0,0, 3, 122, 230, 
-118,85,52, 216, 137, 243, 86, 124, 197, 204, 1 
-17,17,68,65,0,0,0, 42, 171, 147, 57, 211, 66 
-136, 50, 65,0,0, 0,0, 1, 193, 0, 0, 0, 2, 179, 34 
-179, 34, 34,57,83, 0, 0, 0, 1, 119, 118, 102, 85 
-68, 65,0, 0, 40, 50, 35, 223, 32,0,0,0, 1, 17,1 
-1,81, 0,0, 0,0, 47, 255, 223, 34,0,0,0,0,0,0 
0,0,0,0,0,0,06,0,0,0,0,0,0,0,0,0 
S 5,'plaSmabot attacking’ 
175,198,0,2,4,3, 72, 39,193, 5, 194 
0,0 
o 


H 
5 
,35,16,0,0,1,17 


n 
[] 
1 
1 
7 
131,57,211,66,52 


19, 


- ,6,49,1 
-0,0, 111, 193, 1,0, 0, 0,0, 0, 0, 0,0, 0,0,0,0, 
-143, 17,17,240,0,0,0,0,0, 2, 178 

-0,0, 97,23, 119, 113,17, 17,0, 0,10, 153, 1553 
-68,85, 83,51, 50,0, 6,145, 17, 119, 17, 19, 61 
-85,172,128,0,0,0,2,50,0,0,0,6, 17, 113,1 
-118,85,84, 76, 200, 170, 168,136, 211, 50,0 
-187, 146,0, 0, 6,0, 233,151, 85, 91, 180, 67,9 
-230,227,32,0,0,43,32,0,0,0,0, 105,68, 12 
-0, 105, 68, 68, 204, 85, 110,51, 218, 153, 153, 
-218, 68, 85,85, 51,51, 50, 0, O, 105, 68, 124,6 


6,49, 
,0,0,0,0 
9,0,0 
58,15 
,19,6 


-0, 105, 71, 124, 91, 153, 207, 85, 32, 0,0, 35, 32 


-251,37,34,0,0,0,6,233, 149, 81, 20,148, 67 
-17, 84, 60, 200, 136, 136, 136, 211, 50,0,0,0, 
-0,0,6,177,17,119, 17,17, 163, 32,0,0,0,13 
-156, 151,51, 34,34, 0,0, 105, 17, 119, 113, 28 


-17,17,0,0,0, 10, 69,85, 51, 51, 50,0, 0, 97,17 


-1,65,17,21,17,06,0,0,0,0,2,82,0,0,0,0,6 
2/918: ender adie. dc e n 
r 
3,4,5,2,175, 1,6,52, 7, 93,92, 50,74,73, 
,85, 80, 0, 153, 153, 52, 1, 134, 17,16, 80,0 
5,129, 9,119, 115, 386, 16, 85, 9, 114, 115,5 
-151, 113, 18,4, 18, 34, 51, 97, 135, 129, 102, 3 
-22,24,4,68, 70,16, 2, 20, 67, 51,51, 51, 48, 3 
-115, 3, 49, 65,51, 0, 65,96, 85, 85, 9, 49, 33, 3 
-49, 36, 34, 33, 35, 18, 113, 115, 43, 50, 22, 23, 
-51, 22, 18, 34, 36, 16, 7, 10, 34, 64, 66, 34, 51, 
-176,34, 49, 19, 45, 194, 35, 51, 116, 100, 70, 1 
-97,22,16,80, 1,121, 10, 170,65, 35, 18, 34, 3 
-32,68,18,34,34,6,5,85,1,68, 119, 64,0, 1 
-170,65, 34, 65, 34, 34, 33, 34, 33, 96, 0, 0, B5, 
-114, 32, 80, 115, 35, 11, 176, 51, 49, 19, 20, 65 
-19, 35,50, 33, 70,6, 17, 22,96, 7, 49, 33,1, 51 
-36, 34, 50, 39, 18, 49, 35,65, 17, 70, 65, 17,22 
-102, 162,6, 0, 3,53, 85, 51, 51, 51, 49,1, 17,6 
-17,68, 6, 96,129, 2, 34, 0,0, 3, 34, 65, 35, 50, 
-29,4,18,17, 70,97, 135, 129,0, 17, 17, 20, 16 
-68, 17,22, 16, 85, 80, 4, 193,17, 204, 68, 104 
-70,1,128, 17, 16, 80, 0, 4, 70,16, 85, 85, 85, 8 
-, // 11, ender walking 
-6,3,4,5,175,2,1,6,52,93,7,92,50, 74, 73, 
-68, 68, 68,0, 10, 170, 114, 80, 136, 97, 17, 4,0 
-126, 16, 119, 50, 81, 4, 68, 0, 167, 35, 51, 51,5 
-85,1, 34,51, 22,24, 120, 22, 1, 85,97, 4, 64, 1 
-97,4,2,21,85, 51, 51, 51, 53,18, 34, 16, 102, 
-85,18,0,1, 96, 68, 68, 10, 115, 18, 34, 34, 50 
-81, 34,18, 49,55, 19, 50, 178, 22,23, 114,0,0 


m 
e 


-39,114,32,3,17,50,53,5,34, 51, 35, 35, 51, 50 


-19, 45,194, 35, 51, 117, 101, 22, 96, 64, 50, 39 
-16,68,0, 39, 160, 153, 149, 35, 17,34, 34, 34, 
-5,82,54,35,6,0,0,64, 21, 87, 165,0,0, 17,1 
-149, 34, 81, 34, 34, 34,18, 33, 06,0, 4, 68, 7,5 
-4,64, 115,35, 48, 187, 3, 49, 19, 21, 81, 18, 17 
-33, 86,6, 17, 102, 4,7, 50, 18,16, 19, 51, 113, 
-39, 18, 49, 83, 37, 21, 86, 81, 17,97, 4, 3,50, 1 


,0,0,0,0,0,0,1, 43, 68, 68, 34, 36 


11, 229, 82, 51, 51, 50,82, 34, 40, 128, 3, 32, 66,0, 
16,50,0,0,0, 111, 229, 104, 34, 40, 133, 85, 104, 
40, 96, 82,67, 6,102, 133, 80, 17,3, 54, 102, 137, 
, 13,187,154, 229, 102, 104, 36,0, 116, 72, 128, 
,71,67,84,32,17, 16,0, 17, 16, 187,218, 174, 
1,189,170, 175,1, 16, 5, 34, 34, 34, 80, 1, 17, 17, 


1,17,17, 17, 17, 17, 11, 218, 255,0, 17, 17, 17,0,0, 


,17,17,17,17,17, 17, 17,17 


7,31,0,0,0,0,0,0,0,0,0,0,128,0,0,0,0,0,0, 
0, 28, 221, 220,17, 0,0, 0,8, 136, 136, 128, 0,0, 
55,136,128, 0,0, 0,0, 28, 218,187,172, 85,94, 
187,187, 245, 105, 255, 248, 136, 136, 136, 0, 0, 
6,136,136, 0, 0,1, 17, 0, 25, 17, 85, 87, 189, 38, 
,37, 186, 105, 51, 35,56, 0, 0, 17, 255, 146, 33, 1, 
99,55, 113, 25,51, 94, 33, 17, 153, 44, 50, 51, 111, 
22,148,195, 115,54, 153, 159, 114, 34, 39, 113 
57,100, 34, 59, 65, 19, 94, 233, 153, 149, 17, 102, 
85,153, 98, 225, 99, 37,172, 67, 58, 211, 52, 39, 
58, 211, 52, 34, 17, 17, 18, 33, 202, 86,99, 17, 51, 
02, 50, 225, 51, 37,58, 66, 51, 50, 52, 34, 113, 17, 
36, 71,50, 33, 19, 53, 150, 99, 46, 23, 50, 82, 36, 
, 19, 37, 36, 66, 51, 50, 39, 66, 34, 39, 113, 19, 34, 
ð, 113, 1, 50, 81, 17,85, 85, 36, 87, 34, 39, 66, 99, 
1,119, 25, 98, 21, 85, 116, 65, 0, 19, 51, 85, 123, 
1, 92, 202, 171,52, 81,35, 51, 105, 99, 34, 33,0, 
51,50,65,0, 1, 17,0, 28, 205, 219, 178, 65, 20, 
36, 16,1, 20, 68,68, 65,16, 0, 0, 0, O, O, 28, 219, 
19,177,16,0,0,0,0,0,0,0,0,0,0,0,0,17,17, 


,76,0,17,17,17,0,0,0,0,0,0,0,0,0,0,0,0,0, 
10, 26, 201, 153,202, 16, 1, 19, 136,130, 33, 17, 
187, 184,133, 129,16, 0,0,0, 1,172,157, 217, 
0,26, 201, 221, 199, 85, 85, 50, 34, 35, 50, 102, 16, 
38, 102,16, 17,16, 0, 24,17, 68, 70, 220, 115, 54, 
217, 167,51, 81,17, 16,0,17,56, 34, 16,1, 83, 36, 
02, 16, 24,51, 75,353, 17, 136, 122, 114, 51, 85, 88, 
135,167,99,53,85,88, 114, 34, 102, 16, 19, 49, 
34,103, 16,19, 75, 184, 136, 132, 17, 85, 73,199, 
177,83,36,154, 115, 156, 147, 135, 33, 68, 16, 
5,55, 34, 17, 16, 18, 33, 169, 69, 83, 17, 51, 36, 
50, 177, 51, 36, 255, 115, 156, 147, 39, 38, 50, 33, 
55,114, 38, 97,19, 33,133, 83, 43, 22,50, 78, 231, 
36, 231,114, 51,51, 50, 114, 34, 38, 07, 19, 34, 
38,113, 1,50, 65, 17, 68, 68, 231, 70, 34, 38, 97, 
9, 20, 38,65, 16,0, 1, 20, 71, 113,0, 19, 51, 68, 
,1, 14,169, 157, 247, 65, 35, 37, 136, 133, 33, 0,0, 
4,97,0,0,0,0,0,1,170, 205, 223, 225, 23, 98, 34 
17,118, 84, 38, 97,0, 0,0, 0,0, 26, 204, 221, 238, 
8,17,0,0,0,0,0,0,0,0,0,0,0,0,17,17,17,0,0, 


5,148,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
,0,0,0,0,0,0,0,0,0,0,0, 12, 199, 119, 119, 
153, 153, 153, 153, 150, 103, 119, 128, 0, 6,0, 0,0, 
3,0,0,0,0,0,0,1,17,17,17,17,17, 17,17, 28 
16,6,0,1,17,16,0,0,0,0,0,0,0,0,0, 21, 81,0, 
99,51, 81, 0,0, 17,0,0,0,0,0,0,1, 40, 22,102, 
53,102, 99, 50,68, 0,0, 22, 145, 17, 234, 145, 0,1, 
7; 


b 
34, 102, 16, 24, 90, 173, 51, 38, 99,50,68,0,0,4 
50, 68,0,0,0, 21,51, 102, 99, 136, 34, 55, 122, 
, 34,55, 218, 211, 38, 51, 51, 81,0, 19, 51, 51, 51, 
47, 34, 37,51, 53, 88, 34, 170, 51, 35, 102, 50, 34, 
98, 34, 34, 36, 0,0, 1, 37, 85, 178, 82, 136, 136, 
34,34, 65, 132,162, 43, 82, 36, 68, 34, 36, 0, 0, 21, 
6,0,1, 17,17, 36, 68, 68, 68, 

,6,0,0 6,0,18,43, 66,83,82,0, 
0,0,0,0, ,18,34,36,0,0,0,0,0 
0,0, r r 


à AAAI 6,6, 


6 
" 
;8 


5,53, 119, 0,0, 
34,34, 34) 36, T 
,17,17,83,54, 
,68, 74, 86,97,0,0,0,2 
, 197,135, 120, 34, 34, 34 
65,101,0,0,1,81,0,1,1 
, 68, 68, 74, 85,0,0,0,0, 
87, 187,187,17,0,0,0,0 
9,0,0,0,0,0,0,0,0,0,0 
9,0,0,0,0,0,0,0 


oN 


0 


142,147 
10,2, 

3 1,85,68, 
,17,17,17,17,0,42, 185, 50, 35, 141, 50, 49,0,0 
,16,0,0,0,21, 81,0, 0,0, 43, 51, 136, 179, 68, 
51,52, 216, 136,146, 86, 124, 197, 204, 204, 113, 
7,47,28,17,0,0,0, 2,122, 174, 83,153, 211, 35, 
50,51,65,0,17,17,68,65, 17,16, 0,2, 118,102, 
5,0, 2,118, 102, 238, 102, 98, 52, 81, 1, 102, 85, 
1,0,17,17,17,17,17,16, 0, 2, 122, 174, 101, 171, 
95, 184, 136, 210, 17, 17, 17, 17, 21, 17, 0, 0, 0, 35, 
99, 81,0,0,0, 43, 85, 170, 179, 68, 159, 34, 17, 17, 
,52,16,06,0,0, 23, 113,0, 0, 0, 42, 185, 50, 35, 
35,137, 36, 16,0, 0, 1, 17,20, 68, 17, 17,02 
,65,0,2, 152,56, 34, 61, 32, 0,0, 0, 1, 101, 85, 68, 
7,417,117, 17,0, 0, 41, 147, 61, 255, 32, 0,0, 0, 0,0, 


D 


,1,17,0,0,0,06,2,34, 34, 0,0,0,0,0, 0, 0, 0,0, 0, 
92,65,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
6,177,17,17,0,0,0,0, 0,0, 2, 34,0,0,0,0, 15, 
107,17,23,17,31,0,0, 0,8, 136, 131, 51, 34, 34 

, 68,85, 50, 0, 0, 103, 17, 119, 119, 17, 16, 0,0, 10, 
„0,0,10, 168, 141, 34, 34, 34, 0, 1, 17, 17, 23,17, 
7,17, 85,172, 128, 0,0, 0, 2, 82, 0, 0, 0,6, 156, 55, 
0, 0, 6, 52,85, 81, 84, 180, 68, 245, 73, 187, 91, 
8,34, 54,54, 43, 34,0,0,0, 0, 105, 71, 115, 52, 69, 
4,83, 206,110, 227, 32,168, 141, 51, 50, 34, 32,0, 


68,68, 85, 50,0, 0,105, 68, 68, 204, 68, 110, 51, 
9,238, 254,53, 208, 136, 136, 221, 210, 34, 32,0, 
,0,0,0,0, 233, 71, 197, 25, 68, 69, 253, 136, 221, 
,197, 73, 187, 91, 185, 82,0, 0,0, 6,149, 87, 17, 
6,187,113,17, 17, 21,172, 208,0,0,0, 13, 146, 0, 
178, 6,0, 0,6,73, 145, 23, 119, 19,50, 0,0,10 
32,0, 0,10, 153, 68, 68,85,50, 0,6,105, 17, 119, 
23, 17, 22, 0,0,0, 10, 168, 210, 34, 34, 34,0, 0, 
,52,69,31,0,0,0,0,0,0,2, 34,0, 0, 0,0, 0, 102, 
0,0,0,0,0,0,0,0,0,0 


0,85,85,85,85,0,0,0,80,5,0, 5,85, 85,80,0,0, 
, 9,114, 32, 85, 80, 3, 151, 119, 119, 119, 104, 97, 
1, 51,51, 54,97, 114, 113, 99, 50, 17, 22, 16, 80 
3, 20, 70,16, 9,119, 20, 55, 114,0, 65, 34, 16, 17, 
4,33,6,96,129,4,65,0,0, 9, 113, 51, 58, 58, 51, 
4, 35, 34,35, 49, 51, 18, 34, 38, 102, 102,0,0, 7, 
119,114, 32, 7, 49, 33, 1, 34, 51, 49, 39, 23, 114, 
19, 85,51,50, 6, 102, 17, 22, 96, 80, 115, 35, 11, 
6,85, 3,55, 10, 164, 18, 18, 61, 17, 18, 18, 50, 55, 
4,33, 34, 35, 96,0, 0, 3,68, 121, 64,0, 1, 18, 34, 
17,18, 32, 68,18, 34, 34, 6, 5, 85, 80, 1, 55, 10 
3,51, 10, 164, 35, 34, 52, 17, 18, 17, 84, 36, 103, 
, 18, 34, 68, 98, 36, 16, 9, 19, 34, 64, 67, 51, 119, 
,51, 113,35, 19,52, 34,16, 100, 68, 70, 16, 3, 49, 
16,3, 49, 33,51, 51,35, 35, 16, 18, 75, 68, 102 
8,76,6,95,96,85,85, 1,68, 18, 58, 58, 49, 208, 
0,65, 20,96, 17,22, 24, 1, 18, 36, 32, 80,50, 36, 
, 85, 2,36, 34,34, 33, 20, 230, 97, 114, 113, 100, 
1,185, 129, 4, 68, 68, 70, 16, 85, 85, 80,0, 68, 68 
5,0,0,0,80,5,0,5,85,85,80,0,0 7 7! 


0, 68, 68, 68, 68,64, 0,0,4, 0,64, 0,68, 68,0, 0, 4, 
, 167, 34, 4,68, 68,0, 39, 119, 119, 119, 21, 86, 24, 
41,49, 102, 23, 59,52, 33, 17,07, 4, 64, 42,114, 18, 
67,37,87,114, 32, 81, 34, 49, 1, 17,97, 128, 85, 
8,16,81,0,4, 10,119, 19, 51, 147, 147, 115, 1, 49, 
35,50, 35, 33, 34, 22, 102, 96, 68, 68, 7, 115, 18 
7,115, 18,16, 18, 35, 50, 23, 23, 115, 35, 22, 18, 
6,102, 18, 37,16, 64, 115, 34, 48, 187, 2, 49, 
, 112, 153, 177,18, 49, 209,17, 33, 35, 55, 97, 86, 
18,51,96, 22, 16,64, 53,87, 165,0,0, 17, 34, 33, 
8,53,5,85,34,34,6,4,68, 68, 0,39, 112, 153, 
1,48, 153, 178, 34, 53, 17, 17, 33, 18, 21, 103, 34, 
85, 98, 81,4, 10, 17, 34, 37, 5, 51, 55, 10, 34, 51, 
55,19,50,81, 80, 101, 85, 97, 4, 7,50, 18, 82, 35 
8, 85,51,50, 35,16, 18, 37, 181, 102, 102, 96,0, 4, 


-2,34,19,51,51,51,49,101 
-1602, 1, 128, 18, 87, 32, 64, 50 
-80, 82, 17, 86, 96, 24, 120, 22 
-86, 16, 68, 68,0, 92, 17, 204, 
-1,17,4,0,0,0,0,68,68,68 
sp. '15,' ender’ attacking 
-0,4,5,175,3, 26, 28,191, 6, 
-48,0,0,51,51,51, 0,13, 221 
-136, 104, 94,119, 221, 119, 1 
-119/ 118, 244, 75, 64, 48, 29, 
-26, 168, 137, 144, 86, 153, 19 
-96, 119, 9, 96, 84, 0, 0, 13, 13 
-17, 17,33, 18, 41, 156, 150, 1. 
-116, 104, 136, 129, 16, 8, 180 
-33, 42, 170, 17, 34, 18, 18, 34 
-34, 133,181,171, 64, 48, 33, 
-5, 90, 18, 68, 17, 17, 17, 65, 3 
-51, 48,74, 161, 136,0, 0, 68, 
-17,65, 20, 176, 0, 0, 51, 8, 34 
-85, 2, 47, 242, 101, 95, 249, 2 
-11, 244, 75,176, 8, 33, 65, 64 
-18,152, 105, 198,92, 149, 10: 
-235,187,0,0,1,17,66,34,3 
-166, 254, 86, 85, 80, 119, 6, 1. 
-97,26,16,48,34,20,95, 80 
-150, 101, 238, 231,125, 221, 
-112/ 85, 90,171, 64,51, 51,5 


17,85, 86,0, 2, 34, 102, 96,1, 21, 81,51, 147,145,214, 81, 85, 80 
37,19, 50, 37,1, 21, 86,1,17,104, 16,17, 21,16, 64, 51, 33,03, 
11,17, 22, 16, 68, 0, 33, 82, 34, 33, 21, 230, 96, 23, 39, 22, 85, 85, 
85, 96, 16, 24, 120, 16, 85, 85, 86, 16, 68, 68, 68, 0,5, 85, 86, 0, 136, 
68, 64, 0,0, 68,0, 64, 0, 68, 68, 68, 68, 68 


29,2,1,30, 7, 105, 27, 51,51, 51,51, 48,0,0, 3,0, 48, 112, 51, 51, 
,137,80, 153, 231, 119, 115, 0, 13, 129, 16, 51, 51, 0, 24, 136, 136, 
36,130, 26,64, 51, 0,216, 18, 204, 204, 204, 198, 119, 125, 221 
129,73,85,6,153, 204, 103,119, 215, 126,6, 250, 171, 64, 48, 216, 
8, 7,119,118, 144, 90, 171, 64, 1, 74, 170, 34, 34, 34, 37, 105, 153, 
6, 66, 34, 82, 82,130, 6,198, 85,121, 0,6, 176, 51, 51, 13, 130, 65, 
53,110, 187, 187,0, 0, 8,130, 65, 164, 17, 65, 36, 40, 108, 201, 89, 
, 65,64, 65, 18, 33, 72, 248, 140, 156, 110, 105, 145, 26, 64, 2, 68, 

, 41, 14, 235, 255, 75,176, 48, 130, 17, 42, 85, 1, 36, 66, 26, 81, 18, 
17,40, 5,84, 65, 36, 164, 68, 20, 18, 40, 180, 75, 64, 51,0, 17, 141, 
4,176,0,0, 48, 42, 161,141, 0,0, 68, 17, 20, 10, 161, 17, 18, 11, 3 
65, 20, 10,161, 17, 17, 11, 3, 51, 51, 0, 18, 40, 5, 90, 17, 95, 145, 17, 
,33,5, 81, 17, 37, 255, 255, 31, 65, 74, 184, 129, 16, 48, 130, 18, 42, 
55,85, 177, 26, 64, 13, 68, 17, 26, 10, 34, 40, 108, 153, 34, 150, 91, 
,66, 34,134, 156, 108, 201, 86, 80, 181, 170, 171, 64, 8, 33, 65, 161, 
4,94, 95,68, 75,64, 2, 33, 65, 18, 34, 41, 156, 96, 105, 149, 85, 238, 
4, 44, 198, 229, 102, 85, 126, 0, 9, 176, 51, 51, 4, 74,164, 34, 82, 
44,145,0, 0, 48, 33, 26, 66, 41, 149, 6, 101, 94, 119, 119, 121,96, 
89, 102, 94, 224, 119, 215,126, 6, 111, 74,64, 51,0, 20,89, 153, 
119,117,111,75,64,51,51,0, 95,102, 255, 85, 224, 96, 119, 215, 
1,0,5,85,94, 0, 153, 7,119, 3, 0, 10, 171, 64, 51, 51, 51, 51, 48, 0, 


-0,51,0, 48,112, 51,51, 48, 0,0 


-, // 13, turret idle 
-175,0, 181,26, 41, 168, 37,6 
-0,0,0,0,0,0,0,0,0,0,0, 
-6,0,0,0,25,145,0,0,0,0 
-1,35,184,130,81,16,0,0 
-0,25,98,187,98,81,16,0 
-17,17,71,98,118,98,81,16 
-103,53, 16, 0, O, 1, 50,52, 98 
-0, 0, 25, 118, 100,84, 161, 0, 
-76, 35, 104, 132, 81, 16,0, 1, 
-34,51, 68, 85, 17, 19,51, 70, 
-36, 16, 0, 0, 1, 102, 35, 52, 69 
-67, 165,98, 36,81,16, 0,1,1 
-1,17,17,18, 58, 35,58, 81,11 
-52,16,0,0, 22, 34, 68, 18, 58 
-85, 65, 25, 34, 35, 193, 0,0,0 
-17, 35, 58,16, 0,1, 35,68, 16 
-16,0,0,0,0,0,0,0,0,0,0,0 
-9,0,0,0,0,0,0,0,0,0,0, 
7/ 14’ turret walk 

5, 0,131, 26, 41, 37,168, 6 
0,0,0,0,0,0,0,0,0,0 

o 


" 
1 o, 
8,59, 136, 33,0,0, 0,0, 
49, 43,181, 38, 65,0, 0 
0, 117, 39, 85, 83,0,0,0, 
0,0,19,35, 69, 34, 65,0,0 
-84, 100, 161,0, 25, 115, 82 
-70, 65, 0,0, 1, 151, 82, 35 
-51, 52, 82,53, 136,65, 0,0, 
-52, 70, 97, 0, 1, 68, 35, 101,3 
-1, 181, 34,52, 65,16, 0,17, 1 


Os 


-162,51, 161,0, 1, 117,40, 35,6 
-17, 84,52, 17,835,168, 195, 166 


-34,51, 68, 16, 0, 0, 0, 17, 16, 
-0,0,0,17,16,0,0,0,0,0,0, 
8 0,0, 8 0,0,0,0,0,0,0,0, 


7 15 turret attack 
, 
, 


o 


0,131, 41, 26, 1,168, 19 
9,0,0,0,0,0,0,0,0,0 
,0,0,0,1,136,16,0,6,6 
-18,77,170,38,16,0,0,0,0 
e 
-0, 148, 36, 61, 226, 54, 16,0 
-139,119, 112) 238, 80,0, 24 
-211, 194, 77,170, 54,16, 0, 
-204, 192,119,119, 106, 169 
-0,94, 211, 194, 77, 162, 49, 0 
-85, 224, 74, 85, 0, 0,0,83, 73 
P 
-158, 170, 150, 48, 6,6, 0,6,0 
r 
175,168,1,2,3, 10 
90 80,0 0,0 6,6 
-187,144,6,6,6,6,6,6, 
-116,16,0,0,0,0,0,0,4 
-19,49,16,1,17,0, 0,6, 
-34/ 184, 133,85, 50, 17,28, 1 
-100,99,85,153,0,0,23,66, 
-34, 165, 90, 21,130, 33, 36, 3 
-118, 70, 59, 185, 144, 24, 139 
-170,170,97,168,36,116,18 
-51,68,75,89,0,0, 25,50, 35 
-18, 102, 163, 34,52, 70,102, 
-0, 0,0, 23, 66,50, 34,58, 90, 
6,0 17,34,34 
-124,16,0,0,0,0,0,0,0,0,1 


j 


D 
9 
k 
5 
b 
6 
7 
9 


hour S 


e 
e 


t 
1l 
6,73 


, z 
-83, 67,85, 49, 
-211, 115, 21,4 
-221, 209, 1, 97,0, 
-153, 145, 17, 22,4 


index % SFG TEXT! 
index / SFG TEXTI 


-SFG PROGRAM MEMORY uint8 


-0,0,0,0, 24, 65, 0, 19, 16, 0, 0,0 


-0,1, 132,69, 51, 84, 65,32, 0 
-97, 243, 94, 40, 51, 84, 66, 15 
-0, 0, O, 33, 17, 20, 203, 238,1 
-34, 38, 122, 187, 32,0, 0,0, 0 
-202, 170,170, 212, 51, 37, 21 
-218, 56, 32, 0, 0, 2, 33, 17, 10. 
-210, 34, 195, 35,51, 49, 210, 
-0,0,0,2, 38,87, 119, 166, 15 
-37,223,53,114,18,0,0,0,2 
-215, 119, 187, 97, 134, 45, 17 
-0,0,0,0,0,2, 34, 33,110, 23 
-29, 159, 32,0,0,0,0,0,0,0, 


-24) 65, 32,0,0,0,0,0,0,0,0,0 


-17,0,6,0,0,0,0,0,0,0,0,1 
-0,6,0,6,0,0,0,0,0,0,0, 24 


+ ‘return RCL sqrt(cX * c 
+} 


5 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); Anarch 


0,0, 4,221 


0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 


r 


,91,7,48,93,90,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
6,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,16,0,0,0,0,0,0,0,0,0,0, 
,0,0,0,17,0,0,0,0,17, 151, 98, 16, 0,0,0,0,0,0,1, 130,16, 0,0, 
0,0, 1, 40, 16, 0,0, 1, 34, 123, 178, 85,65, 0,0, 0, 0,0, 23, 49, 0,0 
, 0,0, 0, 23, 65, 0, 0, 0, 25, 98, 118, 98, 16, 0, 0, 0, 0,0, 1,115, 16, 0, 
,0,0,0, 1, 20,116, 16,0, 0,0, 22, 35,114, 36, 85, 65,0,0, 1, 25, 
,36,81,16,0, 0, 25, 151, 39, 69, 161, 0,0, 25, 51, 68, 98, 36, 16, 0, 
1,151,54,585, 184, 36, 16,0, 0, 1, 151, 98, 35, 52, 85, 17, 23, 102 
151,98,35, 52,85, 162, 50, 34, 70, 35, 104, 132, 85, 65,0, 1, 118, 
35,104, 132, 81, 16,0, 1,118, 35,51, 68, 81,0, 1,67, 70, 35, 184, 


, 81,0, 0, 20, 66, 53, 98, 36, 16,0, 0, 1, 115, 51, 68, 81, 16,0, 0, 1, 
14,51, 69, 16,0, 0, 0,0, 20, 85, 98, 36, 85, 65,0, 27, 98, 35,65, 0,0, 
6,6,27,34,35,16,0, 0, 23, 98, 51, 18, 58, 35, 58, 16, 0, 1, 123, 130, 
, 140, 58,81, 16, 23, 98, 184, 129,0, 0,0, 1, 35, 65, 1, 90, 44, 202, 

,1,20,81,1, 85, 140, 202, 81,16, 22, 34, 52, 65,0, 0, 0, 17,1, 16,0, 
,0,0,0,16,0,0,0,0,19,49,0,0,0,17,17,0,0,0,0,0,0,0,0,0, 1, 
,0,0,0,0,0,6,0,6,0,0,0,6,0,6,0,0,0,6,0,6,0,6,0,6,6,6,06, 


; 
1 n 
2 4 

16,6,0,1, 117 
6,52, 82,59, 130, 6 
1 8 


16,0, 
0,0,0, 


94, 77,162, 49, 
2,119, 120, 135,1 
21,221, 211,194,77 
,0,0,90, 255, 231, 68 
1109, 226, 54,16, 0,0,0, 
, 36, 158, 68, 150,16, 0,0 

35, 49, 36, 154, 164, 15 
6,0,0,17,54, 16, 22, 10 
6,6,1,0,0,0,0,1, 68, 
9,0,0,0,0,0,0,0,0,0 


7 
9, 
9, 


Iun PAIS 


2 1 
99, 103, 99, 85,80, 0, 0, 23, 66, 136, 138, 18, 85, 106, 50, 199, 119 
136, 85,171,166, 102, 54, 59, 102, 51, 36,181, 89, 144,0, 23, 34," 
5,55,103, 75,89, 0, 1, 18, 187, 136, 136, 81, 168, 36, 116, 18, 119, 
, 85,85, 102, 98, 88, 39, 71, 18, 102, 102, 68, 59, 187, 153, 1, 18, 51, 
,68, 68, 68, 59,185, 144,0, 19, 34, 34, 58, 106, 21, 130, 33, 39, 34, 
,35, 171, 166, 163, 34, 54, 103, 51, 36, 85, 153,0, 0, 23, 66, 42, 51, 
115,89, 144,0, 0, 23, 66, 34, 163, 51, 86, 50, 17, 19, 52, 68, 97, 89, 
33, 49,1, 19, 51,16,0,0, 0,0, 22, 50, 51, 51, 34, 90, 19, 49, 16, 1, 

17,188,17,17,193,0,0,0,0,0,0,0,0, 0, 20, 65, 1, 131, 16, 20 

,32,1,131,16,1, 70, 57,0,0,0,0,0,06,06,06,1, 18, 33, 129,0, 0, 19, 
17,17,129,0,0,5,155,153,0,0,0,0,0,0,0,0,0,1,16,0,0,0, 5, 


sprite 
,135, 79, 26, 159, 131, 37,0, 0, 0,0, 0,0,0,0, 


,48,2,1,68, 73, 113,0,0,0,0, 0,1, 101, 8 
,85, 71,51, 37,84, 48,17, 0,0,0,0 
8, 68,115, 34,85, 34, 35,0,51,0,0 
117,34, 34,163, 101, 51, 67, 32, 0 
0,2,34,0,53, 51, 53,51, 84, 16,0, 
2,32,0,27,189,211,48,23,16,0 
,0,0, 1,155, 221,65, 1, 112, 1,17, 
,0,0,0,0,0, 1, 101, 84, 113, 0, 23, 54, 102, 53, 
,81,0,0, 0,0,0, 2,33, 68, 73,17, 193, 1, 68, 71 


oun 


T s 


0 
0 
r 
5 
16, 23, 119, 115, 65,0, 0, 0, 0, O, 32, 2, 170, 34, 31, 236, 49,23, 

24,238, 193,1, 17,0,0,0,0,0,0,0,0,0, 32,0, 24, 254, 193 
6,1,17,16,2,32,48,0,0,0,0,06,06,0,60,0,0,0,1,0,2,0,0,0 — 
pse sprite 
5,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
6,0,0,0,0,0,0,0,0,0, 0,0, 66,34,0,0,0,0,0,0,0,0,0,0,0 
6,6,6,6,6, 6,4, 36,17, 0,6,0,0,0,0,0,0,6,0,6, 6,1, 18, 65,” 
7,34,34, 19, 51,0,0,0,0, 0,0, 0,0, 0, 1, 22, 98, 34, 34, 33, 20, 0, 
4 
r 


; 
o 

85,82, 37,136, 22, 68,0,0,0,0,0,0,0,0,1, 18, 53,85, 34, 132, 19 
4,85,84,53,100,66,0,0,0,0,0,0,0,0,1,55,51, 51, 39, 22, 102, 
58,58, 39, 65,101, 33,0,0,0,0,0,0,0,0,0,18, 34, 34, 116, 22, 83, 
4, 20,68, 17,50, 20,0,0,0,0,0,0,0 

6,6,6,0,6 
„0,0,0,6 
6,0,0,0, 


83,49, 0,0,0, 0 
,0,0,0,6,6,6 
f] 


,0,0,0,0, 


35,117,51,65,0,0,0,0 
,163,155,0,0,6,6,60,0,' 
8 
9 
18,50,0 6 


o 
0 
2655598187 806,6:6.6.6. 6.6.6.6 


ð 1 N 
r ,0,0,0,0,0,0,0,0,0, 
: DERE a ara 
6 54,0,0,0,0,0,0, 0,0, 


URE SIZE; 
URE. SIZE; 


|t SFG logolmage[SFG TEXTURE STORE SIZE] = 


,0,0,0, 


A 

f] 

: 0,0, 24,65, 17, 19, 17, 17, 0, 0,0, 0 

6,6,0,0,0 9 

$,52,0,0,0 5 
6 


1,17,17,17,17,17,242,0,0,0 
7,17, 24,60, 190, 40, 50, 34, 34, 155, 
09,51, 84, ,178,0,0,0,0,0, 17, 17, 131, 171, 123 
6,97, 92,170 


19, 
6,26, 121, 130, 0, 0, 0,0, 34, 17, 22, 234, 164, 28, 60, 34, 02, 2 
2,116,113, 69, 210, 35, 51, 93, 51, 66, 50,0, 0, 34, 34, 40, 126, 246, 
34,34,0,0,0,2, 40, 119, 238, 105, 197, 210, 35, 51, 93,51, 65, 50, 
6, 60, 34, 92, 223, 218, 161, 32,0,0,2, 34, 38, 87, 119, 170, 20, 51, 
, 34,34, 69, 122, 119, 241, 211, 35, 86, 102, 187, 32,0,0,0,0,0,97, 
,246, 105, 32,0, 0,0, 0, 34, 33, 22, 247, 238, 29, 51, 53, 65, 155, 98, 
5,29,54,17,17, 155, 146,0,0, 0,0, 0, 0,0, 97,111, 153, 34, 34, 34, 
0,41, 150, 40, 51, 84, 65,146, 0,0,0,0,0,0,0,0, 0,2, 38, 40, 56, 
9,2,40,49,145,65,0,0,0,0,0,0,0,0,0,0,1,17, 34, 17, 17 
,152,69,51,84,65,0,0,0,0,0,0,0,06,06,6,1, 17, 24, 56, 17, 17,0, 
,51,84,65,0,0,0,0,0,0,0,0,0,0,0,0, 1,17, 17, 17,0,0,0,0,0 


X + CY * CY) <= r; 


uint8 t SFG charToFontIndex(char c) 


a 


; 


-1394,4 +156,1052 @@ static const uinti6 t SFG font[47] = 
0x9249 // 46 "X" 


*void SFG_generateImages(void) 


PEPE PEATE EERE PEPE EEE EEEEOEEHEHEUHUEU E EE HEE E EET EEE HEE T ETT EEE PEEP EET T AAA E TET E TET EEE HEPAT TEE EE EHH HEE E TEER ETH HHT TEETH HHT T THERE EH HH HHH EU E Y E E EHH HHT 


uint8_t *current = SFG_wallTextures; 
for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 0: white wood 


*current - SFG brickPattern(i,8,8) ? (SFG random() « 100 ? 19 : 3) 
(5 * (SFG random() « 50)); 


current++; 


Tor (uint16_t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 1: wall plus window 


uint8 t x 
x. 


*current - 
y EA e eS BA K FTOR USE Rd 
(x VU 26s 16 || y == 4 || y >= 20)? 4+ 
4 [;] 
ü * Sec | Yckpatternts, à 8, 8)); 


*current += SFG random() « 50; 


i % SFG TEXTURE SIZE, 
i / SFG TEXTURE SIZE; 


current++; 


} 
ror (uint16_t 


m 
D] 


0; i < SFG TEXTURE STORE SIZE; ++i) // 2: pink sci-fi wall 


i % SFG TEXTURE SIZE, 
i / SFG TEXTURE SIZE; 


>= 22: a5 AY Y 2i Sree rangom < 50) 
D esa d 
2 && x » 10) hl 
| ao 40 M aycu nu 
I| y == 15) && x > 5 && x < 27 && (x < 10 || x > 22)) 


(83 ` (y > 10 && x < 25 && x > 7)); 


if ((*current -- 83 || *current -- 82) && SFG random() « 30) 
*current - 18; 


current++; 


} 
for (uint16_t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 3: moss concrete 
uint8_t y = i / SFG_TEXTURE_SIZE; 
*current = ((y % 4) || SFG random() < 40) ? 
SFG random « 220 ? 4 : (SFG random() « 200 ? 123 : 5)) 
SFG random »y*42?412: 20); 


current++; 


for (uint16_t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 4: wood tiles 


uint8 t x = i % SFG TEXTURE SIZE, 


i / SFG TEXTURE SIZE; 


*current = (((x < 16) == (y >= 16)) ? 11 : 19) + (SFG random() < 20); 


if (x % 16 == © || y % 4 == 0) 
*current -= 1; 


current++; 


p 

for (int i = 0; i « SFG TEXTURE STORE SIZE; ++i) // 5: brick wall texture 
*current - (SFG brickPattern(i,8,4) ? 13 5) * (SFG random() « 50); 
current++; 

for (int i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 6: green moss 
*current = 

(i !- 130 && i !- 420 && i !- 800) ? 
(SFG | random() « 200 ? 36 : 45) : 30; 


current++; 


for (int i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 7: heavy door 


uint8_t x i % SFG TEXTURE SIZE, 
y i / SFG TEXTURE SIZE; 
*current = (x == 4 || x == 28) ? 9 : 
(((x A 4 && x< && SFG ? randon( | > i/ 3) ? 60 - (SFG random > i) 
4+(x > 4 && x < 28 && y % 2245/68) ste candan( Se 266 
) + (x =='0 |] x == 29)); 
current++; 


for (int i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 8: skull on white 
*current = (SFG_circle(i, Tes XA) (i08 circle(i,18,17,1) ) ? 92 : ( 
SFG circle(i,0,0,10) 11 SFG | d e(i,31,0,10 i] SFG! | circle(i,0,31,10) 
| SFG circ e(i, 34 31, 10) || SFG | circle(i,1 15,15,8)) ? 5+ 
$FG random() « 30): (SFG_random() < 150 ? 140' : 131)); 
current++; 
int8_t coords[] = { 
2,6, 11,2, 20,0, 28,-1, 
0,18, 7,14, 15,11, 23,10, 32,7, 
2,28, 16, 24, 19,22, 28, 19, 12; 35, 20,31, 29,29 }; 
for (int i = 0; i « SFG TEXTURE STORE SIZE; ++i) // 9: lava 
*current - SFG random() « 80 ? 101 : 173; 


for (int j j.< 16; ++ j) 
if (SFG_ cireleli] coords[j 2],coords[j * 2 * 1],3)) 


*current = 3 + (SFG random() > 100) * SFG circle(i,coords[j * 2] + 1, 
T cords) * 2 * 1] - 1,2); 
real 


current++; 


for (int i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 10: indoor window 


uint8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 


*current = 
(x < 26 && x > 6 && y > 2 && y « 20 && 
x t= 11 && x !- 21 && l= 11 && y !- 10) ? 
SFG TRANSPARENT COLOR : 
((SFG random() « 220 ? 4 : 70) 
- (x < 27 && x > 5 && y > 1 && y < 21) 
+ (y > 22 && (SFG random() < 50))); 


current++; 


for (int i = 0; 


i 
uint8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 


uint8_t joint = i == 68 || i == 92 || i == 956 || i == 932; 


< SFG_TEXTURE_STORE_SIZE; ++i) // 11: white metal 


*current = MS 
SFG- WIE « 2542 5 : 93) - 2 * joint 
SFG | random) « 100) && In == 

Nc rllablt () < & (x = 


i1 || x == 


current++; 


Okckokokokbokckok bockocbob bob bob AH 


} 
for (int i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 12: white tiles 


uint8_t x = i % SFG TEXTURE SIZE, 


i / SFG TEXTURE SIZE; 


*current = (x % 2 == y % 2 && SFG. _random( ) « 40 ? 
SFG random() < 70 ? 13. : 5) : 4 
SFG random() < 230) * ((x == i6 || y == 16 || x == 0 || y == 0) - 
x == 17 || y == 17); 


current++; 


for (int i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 13: pink door 


uint8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 
*current = SFG | circle i,16, 16, 4) + 
x == 5 X == 54 


xe 8 || x5 2 HM 
[Se Pandon() < i *3))- (SFG_random() % 10 > y))); 


current++; 


for (uint16_t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 14: city wall 


uint8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 
*current = (x < 27 && x > 5 && y > 5 && y < 27) ? 4: 
(2 + (SFG brickPattern(i,8,8) && x != 27 && X !- 5 && y != 5 && y !- 27)); 


*current += SFG random() « 50; 


current++; 


for (uint16_t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 15: green sci-fi wall 


SFG_TEXTURE_SIZE, 
SFG_TEXTURE_SIZE; 


i 
i 


uint8_t x 
y 
*current - 
((x < 19 && x > 13 && y < 19 && y > 13) || y == 20 ) ?38 : ( 
SEG random() « 220 && 
(sre. circle(i,16,16,11) && !SFG circle(i,16,16,10)) || y == 12)) ? 
14 
(Sr random() « 220 ? 52 : 36) - (SFG random() » 250))); 


current++; 


MR 


current - SFG itemSprites; 
for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 0: barrell 


96 SFG TEXTURE SIZE, 


uint8 t x i n x 
i / SFG TEXTURE SIZE; 


*current - (SFG circle(i,16,16,6) && !SFG circle(i,16,16,4)) ? 10 : 33; 


*current = (x <= 28 E x >= 4) ? 
(*current + ((y == I] y == 31) ? -1: ( (x + (SFG random() > 180)) / 6)) 
8 * (SFG | Gy dot) < 50)) : 
SFG TRANSPARENT COLOR; 


current++; 


for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 1: health 
uint8 t x = i % SFG TEXTURE SIZE, 

y = i / SFG TEXTURE SIZE; 

x 


*current = (x < 28 && x > 5 && y > 6 && y < 26 && i !- 251 && i !- 230 && 
i !- 806 && i != 827) ? 
( < 21,88 y,* 11 8& X < 22 8& x > 11 8& (x / 2 == 6 
yx 7 2 == 10 || y == 16)) ? 94:6 
x 5 3°88 x x > 10 && x %2==y%2 ) - (y == 25)) 
SFG_TRANSPARENT_COLOR; 


current++; 


for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 2: bullets 


uint8_t x = i % SFG TEXTURE SIZE, 
y = i / SFG_TEXTURE_SIZE; 
*current - 
(x < 27 && x > 2 && y > 15 && y < 30) ? 
36 - (x <9) - 7 * (y > 21 H3 y < 25) - 8 * (SFG random() > 210) 
((x«26 && x > 1 && y > 8 BY S129) 7, 
((y» 11&& (x - 1) € 5» E 101°: 35) : SFG TRANSPARENT COLOR); 


current++; 


for (uinti6 t i = 0; i « SFG TEXTURE STORE SIZE; ++i) // 3: rockets 


uint8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 
odo. - D 
y 18:88 EROR) Ed && x < 28 - (y > 20 ? 
Y 35°: 3) + (x > ofa ) 7 2 10 


: y 
Y Eai ea y > s ke x 2888 x S 5 Ok (x - 1) /2) €3--0?291: 
SFG TRANSPARENT. COLOR) ; 


current++; 


for (uinti6 t i 


0; i < SFG TEXTURE STORE SIZE; ++i) // 4: plasma 


uint8 t x 
y 


*current - 
y > 9 && y « 29 && x > 5 && x « 28) ? 
> 16 
Ü x«12?x:12) - 6) + 
(x » 13 && x « 26 && y « 25 && SFG random() « 110) 


(116 + x % 3) 
Jr, TRANSPARENT. COLOR ; 


i % SFG TEXTURE SIZE, 
i / SFG TEXTURE SIZE; 


at 
o 
ES 


current++; 


for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 5: tree 


uint8 t x 
y 


if (y » 26 && x « 28 && x » 3) 
*current = 3 + SFG_brickPattern(i,5,4); 
else 
*current = 
(SFG_circle(i,4,10,4) || SFG_circle(i,17,4,4) || SFG_circle(i,27,15,4)) 
? 


tae + (SFG_random() < 100) 
((!SEG circle(i,-7,26,17) && !SFG circle(i 


!SFG_circle(i,18 $ 10) aa 35j »9&&x« 25) 
QU > 14 && x < 20 && y 


i % SEG TEXTURE SIZE, 
i / SFG TEXTURE SIZE; 


36,31,17) && 


- * (SFG random() « 90) - (SFG random() » 190) 
T E TRANSPARENT. COLOR 
; 


current++; 


for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 6: finish 


uint8 t x = i % SFG TEXTURE SIZE, 

y = i / SFG TEXTURE SIZE; 
*current - 
(x > 4 - 


31 88-529 t -- 31) && 23)? 
xs 7x S 6 && y > 2,0 ) E ) ( 
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VASE c BRI A 
/ 5) + (x %5 == 0 && y % 2)) 
&& x < 25 ? 116 : SFG TRANSPARENT. COLOR) ; 


current++; 


for (uinti6 t 


i 
uint8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 


int8 t plusW = -1 * (y 


= 0; i < SFG TEXTURE STORE SIZE; ++i) // 7: teleport 


4) + (ly / 4) * 2); 


*current = 
y > 3 && x < 30 + plusW && x > 3 - plusW) ? 


x > 5 && X < 28 && y > 6) ? 
SFG random() % 64 == 0 ? 35 : 67) + 8 + 
(SFG random() < ie +. 8.% (SEG. | Jondont > 230) 
(5 (x lu (x == 29 + plusW)) 
yt sro.’ TRANSPARE T eO 


OR; 
current++; 


for (uinti6 t i 0; i < SFG TEXTURE STORE SIZE; ++i) // 8: terminal 


SFG TEXTURE SIZE, 
SFG TEXTURE SIZE; 


i 
i 


uint8 t x 


Nae 


int8_t plusW = (y == 31) - (y == 0) - (y < 2) - (y > 16) - (y / 4 == 4); 


*current = 
x < 29 + plusW && x > 4 - plusW) ? 


(x < 26 && x > 7 && »2&& y« d» ait ee 
i (4 + 80 * (y < 18 || > / 4) 
SFG_random() < 30 
: SFG_TRANSPARENT_COLOR; 


/ 
Py (y z 30) - we e 17) GS 


current++; 

current[-470] = 117; 

current[-468] = 94; 

for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 9: column 
i % SFG TEXTURE SIZE, 
i / SFG TEXTURE SIZE, 
y= ii lly 20 || y == © || y == 31), 

m= (y >= 10 && y 21); 


*current - 
4 < 10 && iSke-eirele i 0,10, 33} && ise-eiretetie 31,10, 483} || 


y > 21 && ISFG circle(i,0, 21,10 


&& !SFG_circle 
m && x < 21 +h && x > 10 - h) 
Y 


B ai, 21,10 
4- es ST Al (x > 13 && SFG random() < 120 )) - h+m 
: SFG TRANSPARENT COLOR; 


current++; 


for (uinti6 t i 


0; i < SFG TEXTURE STORE SIZE; ++i) // 10: ruin 


uint8 t x = i % SFG TEXTURE SIZE, 
= i / SFG TEXTURE SIZE; 
*current - 
p. x o > E 4 3 5) cs - x || SEG circle(i,10,22,7) ? 
S OC a0 Dg FB x My. SFG random() < 30) 


( 
+ (see; random() > 250) * 8 
: SFG_TRANSPARENT_COLOR; 


current++; 


for (uinti6 t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 11: lamp 


uint8_t x i % SEG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 
* 


int8 t l= (y (SFG random() < 190)) 
if (l < 0) 
l*--1; 


if (l> 5) 
lz25; 


l=5- l; 
if (l> 4) 
l-24; 


; 
*current = 

(x < 16 && x > 12) | 

SFG_circle(i,14,2,11) && SFG_circle(i,14,15,11)) || 

FG_circle(1,14,3, 5) 

SFG circle(i, 14, 14, 

SFG_circle i, 14, 32, 

24 * 1+ (x/ 6 == 2 la. sre _random() > 120 ) 

+ (SFG random() < 30 ) * 

SFG_TRANSPARENT_COLOR; 


current++; 


} 


for (uinti6 t i = 0; i « SFG TEXTURE STORE SIZE; ++i) // 12: card 
uint8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 
*current = 
n A && x > 2 ae y>5 && y < 27 && !SFG_circle(i,2,28,6) ) ? 
t 4 == 2 


30 + sey Ba) cet (asa I y == ean 
x 5 
SÉ TRANSPARENT | OLOR; 


current++; 


current = SFG_weaponImages; 
for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 0: knife 


i % SEG TEXTURE SIZE - 2, 
31 - i 7 SFG TEXTURE SIZÉ - 4; 


(C(x = y) Z 
skó | TRANSPARENT COLI 

else if (y == 3 || y == -2) 

*current = (x < 24 && x >= -1) ? 10 : SFG TRANSPARENT COLOR; 
else if (y »- -1) 

iseubfent. = xX < 25 ? 9 : SFG TRANSPARENT COLOR; 
else 

*current = (x < 18 && x > 4) ? 97 - (x > 6) : SFG TRANSPARENT COLOR; 


veurrene SCC VOR ago S TL eee cea Ga as SUC 
EE 


if (*current != SFG TRANSPARENT COLOR && SFG random() « 20) 
*current += 8; 


current++; 
} 
for (uint16_t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 1: shotgun 
int8 t x = i % SFG TEXTURE SIZE, 
y = SFG TEXTURE SIZE - 1'- i / SFG TEXTURE : SIZE; 
if (x « 16) 
"eur renti a = 


== 15 && y < 24 1 are _circle(i, 8,34,7)) 
? Es - (SFG random( 
(SFG cireleci 11,10, Hu NES && x > y / 3)) ? 4 - (x< 10) 


grandom( ) < 
Sfc | TI ANSPARENT. P 
else // mirror 


*current - 
*(current - (x - 15) * 2); 


Okcbokckckcbckckckobokckckobokockok bob bob bob bockobobokokckok HHHH 


(SFG_random() > 242) 


Se HHH 


if (*current -- 3) 
*current - 4; 
else if (* current == = 4) 


*current = 3; 
current++; 


for (uint16_t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 2: machine gun 


i % SFG_TEXTURE_SIZE, 


int8 t x 
y SFG TEXTURE SIZE - 1 - i / SFG TEXTURE : SIZE; 


if (x « 16) 
t 


if (SFG circle(i, 15,23,7) && x % 2 == y % 2) 
*current - 5; 
else if (y » 12) 
*current - (y « 29 5e NGS ABEN AR co Lb Xe 22) 2789 
(4 + (x < git)? : SFG_TRANSPARENT_COLOR 
else if (y 
fecumrent = x > 6? 4 + (x < 11): SFG TRANSPARENT COLOR; 
else 
*current = x > (1 + (y - 9)) ? 4 + (x <= 2): SFG TRANSPARENT COLOR; 


v 


l 
else // mirror 
*current - *(current - (x - 15) * 2* 1); 
if (*current -- 5) 
*current - 3; 


current++; 


} 
for (uint16_t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 3: rocket launcher 


int8 t x = i % SFG TEXTURE SIZE, 
y = SFG TEXTURE SIZE - 1'- i / SFG TEXTURE : SIZE; 
*current - 
SFG circle, 16,13,6) I 
y < 20 && x 36,13, 6) / 5) && x < 27 - (y / 5)) II 
PIC Ne 18 bax Sd 2 


115 - ((x - 6) / 7) - 8 * (SFG random() < 40) 
SFG circle(i,16,10,6) ? 4 : SFG TRANSPARENT COLOR 
; 


current++; 


for (uint16_t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 4: plasma gun 


int8 t x = i % SFG TEXTURE SIZE, 
y = SFG TEXTURE SIZE - 1 - i / SFG TEXTURE SIZE; 
if (x « 16) 
*current = SFG circle(i,6,15, 1) ll SFG. Uireteti 4,21,1) |I 
SFG circle(i,2,27,1) || (y == 25 && x > 


(x_== 15 && y < 25 && 2 5), n "GFe cirete(l, 16,29,5) && 
ISFG circle(i,16,29,3) (y % 3 == 0): 


SFG circle(i,15,7,7) || (y < 25 &&& x> y / 3) ? 4 - (x < 10) 
SFG TRANSPARENT COLOR 


);, 
else // mirror 
*current = *(current - (x - 15) * 2 + 1); 
if (*current == 3) 
*current = 5; 
current++; 
} 
for (uint16_t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 5: solution 


int8_t x i % SFG_TEXTURE_SIZE, 
y = i / SFG_TEXTURE_SIZE; 


if (SFG_circle(i,16,22,16) ) 
*current = SFG circle(i,16,22,12) && !(x <= 17 && x >= 15 && y >= 18 && 
y <= 22 && i !- 625 && i !- 687) ? 
76*8* {Seg-rangom(} < 3883): 


(5 + 9 * (SFG_random > 200 
else 
ee Oe e262 82x) anny 19r E COH) way 


*current = (x 96 ! 
: SFG TRANSPARENT COLOR; 


current++; 


current = SFG_backgroundImages; 
for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 0: city 


int8 t x = i % SFG TEXTURE SIZE, 
y = SFG TEXTURE SIZE - 1'- i / SFG TEXTURE : SIZE; 
if (i == 110 || i == 320) 
*current - 18; 
else 
*current - 


y < 8 + ((x / 4) * (x / 4)) * 20) ? 
((x * 2 == 0 && y % 2 == 0 && SFG random() < 30 ) ? 222 : 1) 


iy > 21 + ((int32_ ti (ROL sin( (( (ints2_ t) ES * 1024) / 32) * 2)) / 512) 
S sre random() < 30 ? » 11); 


current++; 


for (uint16_t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 1: interior 


int8_t x i % SFG_TEXTURE_SIZE, 
y = SFG TEXTURE SIZE - 1'- i / SFG TEXTURE | SIZE; 


int8 t tmp = (y / 4), tmp2 = (x / 4) % 3; 
if (tmp > tmp2 && tmp <= 5 + tmp2) 


tmp2 - ((32 - x) 72+ 3); 
*current = ((y > tmp && y < 32 - tmp) || (y > tmp2 && y < 32 - tmp2)) ? 
(18 + (x > 16) + 16 * (SFG random() « 5) ) : 58; 
else 
*current - 88; 
current++; 
} 
for (uinti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 2: hell city 
int8 t x i % SFG TEXTURE SIZE, 


y i / SFG TEXTURE SIZE; 
uint8 t tmp = SFG random() % 8; 
*current = YY, A A : np} ^ Q 96 3) 

171 + (y > «Og > 25 
: (40 + Gre? randon 9)); 


? 
- tmp) * 10 * (y « 15 && SFG random() « 5) 


current++; 


current = SFG_effectSprites; 
for (uint16_t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 0: explosion 


if (i == 2 || i == 60 || i == 1020) 
*current = 174; 
else 
*current = 
(SFG_circle(i,16,16,16) && (SFG_circle(i,16,16,12) 
|| SFG_random() « 160)) ?°(SFG_random() « 200 ? 174 : 191) 
* ((SFG random() & 0x08) == 8) : SFG TRANSPARENT COLOR; 
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current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 1: fireball 


*current - SFG circle(i,16,16,13) ? 
SFG effectSprites[SFG ' TEXTURE : STORE SIZE - 1 - i] 
SFG TRANSPARENT COLOR; 
if (*current 174) 
*current - 94; 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 2: plasma 


*current = (SFG circle(i, 16,16,13) && SFG random() « 230) ? 
SFG effectSprites[2 SFG TEXTURE : STORE SIZE - 1 - i] * 24 
: SFG TRANSPARENT COLOR; 


current++; 


for (int16_t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 3: dust 


*current = 
SFG_circle(i,10,12,5) || SFG_circle(i, 22 
| (SFG circle(i, 16, 16,14) && are. | random( ) « 50) 
((SFG_ random() & 0x10 0) 
sre | TRANSPARENT COLOR; 


t= 
current++; 


current = SFG_monsterSprites; 
for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 0: spider idle 


int8 t x 
y. 


if (x « 16) 
if (re, cirele(1,4/5,9) | 1 Shonen le 9,272) I] 
current = x % 2 + y € 2 I= 2 ? 3 : 92; 
else if ((SFG_circle(i, 17,15,14) && SFG | Circle(i, 13,8,11 I] 
SFG_circle(i,10, 32, 10) && !SFG circle i,13, 57, 13 
SFG circle(i, 18, 32; 10) && !SFG circle(i, 20, 34, 11))) 
*current = (Se^ circle(i, 11,12,3) && SFG. | circle(1, 13,10,3)) ? 
6 


53 + (x dd ) 

(4 ye I * 16 * 3Ferandont) -< 

n ds ITEN 16,12,5) && SF randonc) 3 35)); 
else 


*current = SFG_TRANSPARENT_COLOR; 


i % SFG_TEXTURE_SIZE, 
SFG TEXTURE SIZE - 1 - i / SFG TEXTURE : SIZE; 


l 
else // mirror 
*current - 
*(current - 1 - (x - 16) * 2); 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 1: spider attacking 


*current 
i< SEG TEXTURE_SIZE ? SFG_TRANSPARENT_COLOR : 


SFG | random « 50 * (SEG. random() > 
V current - SFG TEXTURE : sion | ire . 
) SFG TEXTURE SIZE * (i « SFG TEXTURE SIZE * 22)) 
; 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 2: spider walking 


*current = 
(i < SFG TEXTURE SIZE || 
(i / SFG TEXTURE SIZE == 31 && i % SFG TEXTURE SIZE « 16)) ? 
SFG_ TRANSPARENT_COLOR 


*(current - 2 * SFG TEXTURE STORE SIZE 

- (i / SFG TEXTURE SIZE « 20 ) * SFG TEXTURE SIZE 

+ (i / SFG TEXTURE. SIZE > 20 && i % SFG TEXTURE SIZE « 16) 
) SFG TEXTURE. SIZE) 

; 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 3: destroyer idle 


int8 t x 
y 


if (x « 16) 


if (SFG circle(i, 15,8,5) 
*current = (SFG circle i,15,5,5) && !SFG -circle{i, 15,2,6)) ?0 : 4; 
else if (x > 1 && y » 19 - X / à && y « 27 - x / 8) 
*current - 83; 
else if (SFG i circle(i, 15,9,9) || 
y « 20 && !SFG | circle(i,- 7,22,15) && x < y + 13) 
y » 8 && SFG | circle(i, 10 17, 7) && i !- 712 A 
fur Benn S3 ATS EUR ERAN 
else 
*current - SFG TRANSPARENT COLOR; 


i % SFG TEXTURE SIZE, 
SFG TEXTURE SIZE - 1 - i / SFG TEXTURE SIZE; 


l 
else // mirror 
*current - 
*(current - 1 - (x - 16) * 2); 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 4: destroyer attack 
*current - 


SFG circle(i,5,19,5) ? 
111 - 8 (SEG_ random() < 140) 


i « SFG TEXTURE SIZE ? SFG TRANSPARENT COLOR : 
*(current - SFG TEXTURE. STORE SIZE 

) (i >= SFG TEXTURE SIZE ? SFG. ; TEXTURE : SIZE : 0)) 
; 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 5: destroyer walk 
uint8_t leg = i % SFG_TEXTURE_SIZE >= 16 && i / SFG_TEXTURE_SIZE >= 16; 
*current = 
(i « SFG TEXTURE. SIZE Ld. (ls & i> 
SFG TEXTURE SIZE * SI EX URE SIZE - SFG_TEXTURE_SIZE)) ? 
SFG_ TRANSPARENT_COLOR 
* (current - 2 * SFG TEXTURE STORE SIZE - 
i >= SFG TEXTURE SIZE ? SFG TEXTURE SIZE : 0) + 
leg ? SFG TEXTURE SIZE : 0)); 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 6: warrior idle 


int8 t x = i % SFG TEXTURE SIZE, 
y = SFG TEXTURE SIZE - 1 - i / SFG TEXTURE SIZE; 
if (SFG_ ewetepi 13,10,1) || SFG circle(i,20,10,1)) 
*current - 


else if (SFG circle(i, 16,12,11) && !SFG circle(i, 33: 11,12)) 
*current = 5 + e RES «(y = 5) *16)' * 


else if SFG_circle(i,17,10 H 
ell see N S ENE II 
iic 113. I] i == 


) >y / 25 ak (SPE. 
current = 5 - (SFR Fanon )_< (x.- 2) * 16) - (y < 15) + 
(SFG_circle(i, 23, 31,2) SFG circle(i,24,31,2)); 


Okckokckck-bckckck b kckckobokockck bob bob bob bob bob FEE EEE EEE EE EEE EEE EEE cb bob bb bob bb bob bb EE EEE EEE EE EEE EEE EE EEE EEE EE EEE REEF EEE EEE EEE EEE REEF EEE EEE EE HEEFT E EEE EEE EE FEE ETE EE FEE EHH HEHEHE ék cb b bí b ck b à b b b b à 


else 


13,4) || SFG circle(i,16,19,5) 
? 


(Gre. reu 5,6,5) H SFG. DERE 27,6,5)) && SFG patent) < 190) ? 
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Se HHH 


*current = SFG_TRANSPARENT_COLOR; 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 7: warrior attacking 
uint8 t y - i / SFG TEXTURE SIZE; 


*current - 
SFG circle(i,19,17,9) && !SFG -circle(i, 18,14,10)) ? 53 
i 96 SFG_ TEXTURE. SIZE « 11 && y < 
? SFG_TRANSPARENT_COLOR : 
current - SFG TEXTURE STORE SIZE - SFG TEXTURE SIZE * 
y? 3 && y < 18))); 


current++; 


for (inti6 t i = 0; i < SFG_TEXTURE_STORE_SIZE; ++i) // 8: plasmabot idle 


int8 t x 
y 


if (SFG circle(i, 9, 9,4 LL SFG_circle(i, 23, S js : 
*current = 6l SFG circle(i,9,9,3) || SFG circle(i,23,9,3)); 
else if (SFG_ SircéG, d6511,7) | 
y/9--2 && (x / ui E (x == 22] x72 6)) |I 
/ 8 == 3 8& ((X - 1 (T Wa Sa AE *48)j 
Current = 4^ - (y > 18 A ie * (SFG random() < 2 
((i 2 i == 274) (i / 6 == 61) 


*current = SFG_TRANSPARENT_COLOR; 


i % SFG_TEXTURE_SIZE, 
i / SFG_TEXTURE_SIZE; 


current++; 


} 
for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 9: plasmabot attacking 
*current = 
4 SFG_circle(i,9,9,4) || be sircle(i, 23,9,4)) && SFG_random() < 180) ? 
w= 8-2 (S G random( 00) 
*(current - SFG TEXTURE : STORE), SIZE + ( 
i » SFG TEXTURE SIZE && i « 20 * SFG TEXTURE SIZE) * SFG TEXTURE SIZE); 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 10: ender idle 


int8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 
if (y < 25) 
if (x < 16) 


*current = (SFG_circle(i,8,8, 8) Alcs SFe Scirele(i,1 10 18, 7)) ? 
(SFe circle(i,15,7, Y Bary (x 5) : 


3 + (SFG circ eG, 13) 12; 10) "ak sec Sr andsa() « 1930) - 
SFG_circle(i,6,19,3))) 
SFG_TRANSPARENT_COLOR; 
else // mirror 
*current - 
*(current - (x - 15) * 2); 
else 
*current = (x > 2 && x < 28) && ((x + 1) % 4) ? 
(3 - (SFG ràndom() « 120)) : SFG TRANSPARENT COLOR; 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 11: ender walking 


*current = *(current - SFG TEXTURE STORE SIZE - 
(i > SFG TEXTURE SIZE * 23)); 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 12: ender attacking 
*current - i « SFG TEXTURE SIZE ? SFG TRANSPARENT COLOR 

(SEG_ circle i,6,20,4) SFG : grew i,25,20,4 ? 

8 SFG'randóm() < 126) + FG random() « 30 


): 
S current - SFG TEXTURE . STORE. BE SFG TEXTURE SÍZE * 
(i « 30 * SFG TEXTURE SIZE)) 


; 
current++; 
for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 13: turret idle 


int8 t x i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 


int8_t limit; 
if (SFG_circle(i,16,10,5 SFG circle(i,23,8,4 
(rey irit eg 2 LI) erue sil 


limit = 10 - x / 4 + SFG random() % 
*current = 35 - (y > limit) - (y > hit + 4); 


} 
else if ( 
(x < 18 && y > 32 - (x - 6) * 2) || (x > 17 && y > (x - 13) * 2)) && 
y < 30 + ((x + 1) & 0x02)) 
limit = 19 + x % 2; 
*current = 35 - (y. » lim - (y » limit + 6) + 56 * 
(SFG_circle(i,13, 26, S | SFG circle(i,21,26,1)); 


else 
*current - SFG TRANSPARENT COLOR; 


current++; 


} 
for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 14: turret walking 
*current = *(current - SFG TEXTURE STORE SIZE - 
G > SFG TEXTURE SIZE && i < 18 * SFG TEXTURE SIZE) * SFG TEXTURE SIZE 
(i > SFG TEXTURE SIZE * 30)); 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 15: turret attacking 


*current - 
i « 16 * SFG TEXTURE HERES 
SFG _circle(i, 16, 11,5) FG_circle 3 20,9 ATF 
33 (60 (ato), rdlaon(] < 110)) * SFG | Circle(i, 16,13,3) + 


(SrG ándomi) « 90) 


SFG TRANSPARENT COLOR) 
*(current - SFG TEXTURE STORE SIZE); 


current++; 


for (inti6_t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 16: exploder 


int8 t x = i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 


if (i == 365 ji: i -- 371) 
*current - 
else if (SFG ! circle(i, 18 12,5) || (y / 2 == 5 && x > 3 && x < 29) || 
(x == 16 && y / 8 == 0 
current = 102 + 6 * (SFG random() « 50) - 2 * SFG circle(i,16,16,3 
etse if AX 5 12608 x 25888 NEC && y > 2) || SrG-circleti, 16, 20) 64) 
*current = 4 + (y < 6) - (y > 21) - (y > 21 && x % 2); 
else if (SFG_ circle(i,16,25,6) && SFG random() « 100) 
p Ur rene -9348 * (ste. random() < 100); 
else 
*current = SFG_TRANSPARENT_COLOR; 


current++; 


for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 17: dying 
if (SFG circle(i,16,20,8) && SFG random() « 50) 
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*current - 54; 

else if (SFG circle(i, 10,15,4) || SFG circle(i,25,18,3) || 
SFG. | circle(i,13,23, 5) m (sEa circle(i, 16,20, 10) && SFG random() < 80)) 
*current = 4 - (SFG random() < 50); 


else 
*current - SFG TRANSPARENT COLOR; 


current++; 


for (int16_t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // 18: dead 


int8 t minus - SFG random() « 90; 


if (i == 781 || i == 717) 
*current - 

else if (SFG ! circle(i, 11,32,5) || SFG circle(i,21,33,5)) 
*current - 3 - minus; 

else if (SFG circle(i, íi, 24,5) || SFG circle(i,5,30,4) || 
SFG circle(i,19,27, 4)) 
*current = 4 - minus; 

else 
*current - SFG TRANSPARENT COLOR; 


©. 
09 


current++; 


} 
current = SFG_logoImage; 
for (inti6 t i = 0; i < SFG TEXTURE STORE SIZE; ++i) // logo 


int8 t x i % SFG TEXTURE SIZE, 
y = i / SFG TEXTURE SIZE; 


*current = SFG_circle(i,16,16,12) ? 68 : 
((y < 16 && x > 5 && x < 28 && (y > (((x * 1) / 4) € 2 ))) 
? 0 : SFG TRANSPARENT COLOR); 


current++; 


char logoStr[] = "anarchproc"; 
for (inti6 t i = 0; i < sizeof(logoStr) - 1; ++i) 
uinti6 t c = SFG font[SFG charToFontIndex(logoStr[i])]; 
for (uint8 t j = 0; j « 16; ++j) 
if ((c_>> 15) & 0x01) 


SFG -lLogoImage[ (13 +j%4+ 7 * (i >=_6) ) * SFG TEXTURE SIZE + 
(74) *1*5-(i»-6)*25*2] 27; 


Cc <<= 1; 


H 
F 


v 
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#endif // guard 
3 


diff --git a/make.sh b/make.sh 
index 4669af0..bad5614 100755 
--- a/make.sh 

+++ b/make.sh 

@@ -14,7 414,7 @@ fi 


Clear; clear; 


--FLAGS='-x C.-std-c99 -Wall -Wextra -pedantic -03 -wall -Wextra -Wno-unused-parameter -Wno- 
missing- field- initializers -0 anarch' 
*C FLAGS-'-x c -std=c99 -Wall -Wextra -pedantic -Os -fdata-sections -ffunction-sections -Wl,-- 


mods/full zbuffer.diff 


This mod adds full z-buffer that mostly fixes the incorrect sprite visibility, 
however RAM consumption increases quite a bit. Note that visi lity inaccuracies 
may still occur as e.g. floor depth is not accurate and isn't used, but the 
game 

generally looks much better. 


By drummyfish, 
omain. 


released under CCO 1.0, public 


diff --git a/constants.h b/constants.h 
index 956baa0..da72f24 100644 
--- a/constants.h 
+++ b/constants.h 
@@ -352,7 +352,7 QQ 
#define SFG FONT_SIZE_BIG 1 
#endif 


-#define SFG_Z_BUFFER_SIZE SFG_GAME_RESOLUTION_X 
+#define SFG_Z_BUFFER_SIZE (SFG_GAME_RESOLUTION_X * SFG_GAME_RESOLUTION_Y) 


Jk 
Step in which walls get higher, in raycastlib units. 

diff --git a/game.h b/game.h 

index 24285cb..f8ef257 100755 


--- a/game.h 
+++ b/game.h 
@@ -951,6 +951,14 @@ void SFG_pixelFunc(RCL_PixelInfo *pixel) 


SFG_TRANSPARENT_COLOR; 


uint8_t *zValue = SFG_game.zBuffer + 
pixel->position.y * SFG_GAME_RESOLUTION_X + pixel->position.x; 


uint8 t zDistance = SFG RCLUnitToZBuffer(pixel-»depth); 


if (*zValue »- zDistance) 
*zValue = zDistance; 


Tob B RGB GA 


shadow = pixel->hit.direction >> 1; 


lise // floor/ceiling 
@@ -1216,29 +1224,25 @@ void SFG drawScaledSprite( 


gc-sections -Wall -Wextra -Wno-unused-parameter -Wno-missing-field-initializers -o anarch' 
COMPILER-'g-**' 


aa Poa 6 +36,7 @ $1 = "sdl" ]; then 
SDL2 Us. m age 


SDL FLAGS-'sdl2-config --libs --static-libs^ 
COMMAND="${COMPILER} $(C FLAGS) main sdl.c -I/usr/local/include $(SDL FLAGS)" 


echo ${COMMAND} 
00. 798,3 *99,5 @@ elif [ $1 = "emscripten" ]; then 
else 


pne "unknown parameter: $1" 

T 

4 

*gzexe ./anarch # compress the binary 
diff --git a/sounds.h b/sounds.h 
index 2e2b042..a10c035 100644 

--- a/sounds.h 

+++ b/sounds.h 

00, ;29,9 *29,40 @@ 


ets an 8bit sound sample. 

-#define SFG_GET_SFX_SAMPLE(soundIndex, sampleIndex) \ 

- ((SFG PROGRAM I| MEHORY | U8(SFG sounds + soundIndex * SFG SFX SIZE \ 
- + sampleIndex / 2) << (4 * ((sampleIndex % 2) !- 0))) & Oxf0) 


* 
+uint8_t SFG GET SFX SAMPLE(uint8 t soundIndex, int32 t n) 


+++ 
AS 


Switch (soundIndex) 


case 0: 
return 128 + (60000 / (n * 8 + 1)) * 2; 
break; 


case 1: 
return 128 + (4000 / (((n / 2) >> ((n / 32) % 4)) + 1)) / 16; 
break; 


case 2: 
return 128 + (5000 / (n / 160 + 1)); 
break; 


case 3: 
return 128 + (n < 300) * ((n* 5) / 7); 
break; 


case 4: 
return ((uint8 t) ((n/ 2) >> ((n/4) %7))) / 2; 
break; 

case 5: 
return ((uint8 t) ((n/ 2) >> (n % 8))) / 5; 
break; 


default: break; 


return 0; 


kk RGB RGB BG BG BG B B B BG B B B B BR GBA 


J 


#define SFG TRACK SAMPLES (512 * 1024) 

#define SFG TRACK COUNT 6 

@@ -487,3 +518,4 @@ SFG PROGRAM MEMORY uint8 t SFG sounds[SFG SFX SIZE * 6] = 
; 


#endif // guard 
+ 


for (inti6 t x = x0, u = u0; x <= x1; ++x, **u) 


if (SFG_game.zBuffer[x] >= zDistance) 


+ for (inti6 t y = yO, v = v0; y <= y1; ++y, ++v) 

- int8_t columnTransparent = 1; 

+ uint8_t color = 

+ SFG G get Texel (image, SFG game.spriteSamplingPoints[u] 
+ | game. spriteSamplingPoints[v]); 


for (inti6 t y = yO, v = v0; 1; ++y, ++v) 
if (color != SFG_ TRANSPARENT _totory ' 
uint8_t color =. i ; 
SFG getTexel(image,SFG game.spriteSamplingPoints[u] 
SFG game.spriteSamplingPoints[v]); 


if (color !- SFG TRANSPARENT COLOR) 
Hf SFG | DIMINISH | SPRITES 


color - palette. | minusValue(color,minusValue); 
color - palette ae minusVa ue) ; 


" vendif 
- columnTransparent = = 
uint8_t *zValue = SFG dnd. zBuffer + y * SFG GAME RESOLUTION X + x; 
+ if (*zValue >= zDistance) 
+ 
SFG_setGamePixel(x,y,color); 

+ } *zValue = zDistance; 

H 


- if crcotumntransparent) 
SFG_game.zBuffer[x] = zDistance; 


small3dlib 
small3dlib.h 


#ifndef SMALL3DLIB_H 
#define SMALL3DLIB_H 


/* 
Simple realtime 3D software rasterization renderer. It is fast, focused on 
resource-limited computers, located in a single C header file, with no 
dependencies, using only 32bit integer arithmetics. 


author: Miloslav Ciz 

license: CCO 1.0 irae aes domain) 
found at https://creativecommons.org/publicdomain/zero/1.0/ 
+ additional waiver of all IP 

version: 0.905d 


Before including the library, define S3L PIXEL FUNCTION to the name of the 
function you'll be using to draw single pixels (this function will be called 
by the library to render the frames). Also either init S3L resolutionX and 
S3L resolutionY or define S3L RESOLÜTION X and S3L RESOLUTION Y. 


You'll also need to decide what rendering Strategy and other settings you 
want to use, depending on your specific usecase ou may want to use a 
z-buffer (full or reduced, S3L_Z BUFFER), sorted- drawing (S3L_SORT), or even 


none of these. See the description of the options in this file. 


The rendering itself is done with S3L. ürawScene, usually preceded by 
S3L newFrame (for clearing zBuffer etc. 


The library is meant to be used in not so huge programs that use single 
translation unit and so includes both declarations and implementation at 
once 
If you for Some reason use multiple translation units (which include the 
DAL you'll have to handle this yourself (e.g. create a wrapper 
manua 


split the library into .c and .h etc.). 


This work's goal is to never be encumbered by any exclusive intellectual 
property rights. The work is therefore provided under CCO 1.0 + additional 
WAIVER OF ALL INTELLECTUAL PROPERTY RIGHTS that waives the rest of 
intellectual property rights not already waived by CCO 1.0. The WAIVER OF ALL 
INTELLECTUAL PROPERTY RGHTS is as follows: 


Each contributor to this work agrees that they waive any exclusive rights, 
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including but not limited to copyright, patents, trademark, trade dress, /** Says which method should be used for computing sin/cos functions, 


industrial design, plant varieties and trade secrets, to any and all ideas, possible 

concepts, processes, discoveries, improvements and inventions conceived, values: © (lookup table, takes more program memory), 1 (Bhaskara's 
discovered, made, designed, researched or deve Loped by the contributor either approximation, slower). This may cause the trigonometric functions give 
solely or jointly with others, which relate to this work or result from this slightly different results. */ 


work. Should any waiver of such right be judged legally invalid or #define S3L SIN METHOD 0 

ineffective under applicable law, the contributor hereby grants to each #endif 

affected person a royalty. Tree, non transferable, non sublicensable, non 

exclusive, irrevocable and unconditional license to this right. /** Units of measurement in 3D space. There is S3L FRACTIONS PER UNIT in one 
spatial unit. By dividing the unit into fractions we effectively achieve a 

creer reece eee renee fixed point arithmetic. The number of fractions is a constant that serves as 
1.0 in floating point arithmetic (normalization etc.). 


CONVENTIONS: 
typedef 
This library should never draw pixels outside the specified screen "1f S3L USE WIDER TYPES 
boundaries, so you don't have to check this (that would cost CPU time)! pertant 
You can safely assume that triangles are rasterized one by one and from top PEL 
down, left to right (so you can utilize e various caches), and if sorting S3L Unit; 
= ; 


is disabled the order of rasterization will be that specified in the scene 
structure and model arrays (or course, some triangles and models may be 
c.). 


skipped due to culling e /** How many fractions a spatial unit is split into, i.e. this is the fixed 


point scaling. This is NOT. SUPPOSED T0, PE EDEFINED, so rather don't do it 
> : XE otherwise thin m ove fe) $ 
Angles are in S3L_Units, a full angle (2 pi) is S3L_FRACTIONS_PER_UNITS. IEEE dS MAy OVET ANON ets) 
#define S3L_F S3L_FRACTIONS_PER_UNIT 
We use row vectors. 


typedef 
In 3D space, a left-handed coord. system is used. One spatial unit is split #1f S3L USE WIDER TYPES 
into S3L FRACTIONS PER UNITs fractions (fixed point arithmetic). P int32 t 
else 
y ^ inti6 t 
#endif 
7| z S3L ScreenCoord; 
/ 
/ typedef 
[0,0,0]------- =x #if S3L_USE_WIDER_TYPES 
uint32_t 
Untransformed camera is placed at [0,0,0], looking forward along +z axis. The #else 
projection plane is centered at [9,0 9l Stretrinch from uinti6 t 
-S3L FRACTIONS PER UNIT to S3L_FRACTIONS PER UNIT horizontally (x), #endif 
vertical size ly depends on the aspect ratio (S3L_RESOLUTION_X and S3L Index; 
S3L RESOLUTION Y). Camera FOV is defined by focal length in S3L Units. 


#ifndef S3L NEAR CROSS STRATEGY 


Rotations use Euler angles and are generally in the extrinsic Euler angles in /** Specifies how the library will handle triangles that partially cross the 
ZXY order (by Z, then by X, then by Y). Positive rotation about an axis near plane. These are problematic and require special handling. Possible 


rotates CW (Clock-wise) when looking in the direction of the axis. values: 
Coordinates of pixels on the screen start at the top left, from [0,0]. 9: Strictly cull any triangle crossing the near plane. This will make such 
triangles disappear. This is good for performance or models viewed only 
: : ; : rom at least sma istance. 
There is NO subpixel accuracy (screen coordinates are only integer). 1: Forcefully push the vertices crossing near plane in front of it. This is 
. ; z a cheap technique that can be good enough for displaying simple 
Triangle rasterization rules are these (mostly same as OpenGL, D3D etc.): j environments on slow devices, but texturing and geometric 
artifacts/warps 
- Let's define: will appear. : P 
- left side: 2: Geometrically correct the triangles crossing the near plane. This may 
- not exactly horizontal, and on the left side of triangle result in some triangles being subdivided into two and is a little more 
- exactly horizontal and above the topmost expensive, but the results will be geometrically correct, even though 
(in other_words: its normal points at least a little to the left or barycentric correction is not performed So texturing artifacts will 
completely up) appear. Can be ideal with S3L FLAT. . ; 
E right side: not left side 3: Perform both geometrical and barycentric correction of triangle crossing 
- Pixel centers are at integer coordinates and triangle for drawing are the near plane. This is significantly more expensive but results in 
specified with integer coordinates of pixel centers. .correct rendering. */ 
- A pixel is rasterized: define S3L NEAR CROSS STRATEGY 0 
- if its center is inside the triangle OR #endif 
- if its center is exactly on the triangle side which is left_and at the 
same time is not on the side that's right (case of a triangle that's on #ifndef S3L FLAT 
a single line) OR 2 i : : /** If on, disables computation of per-pixel values such as barycentric 
- if its center is exactly on the triangle corner of sides neither of which coordinates and depth -- these will still be available but will be the same 
is right. for the whole triangle. This can be used to create flat-shaded renders and 
will be a lot faster. With this option on you will probably want to use 
These rules imply among others: sorting instead of z-buffer. */ 
#define S3L FLAT 0 
- Adjacent triangles don't have any overlapping pixels, nor gaps between. #endif 
- Triangles of points that lie on a single Line are NOT rasterized. 
- A single "long" triangle CAN be rasterized as isolated islands of pixels. Hif S3L_FLAT 
- Transforming (e.g. mirroring, rotating by 90 degrees etc.) a resu of #define S3L COMPUTE DEPTH 0 
rasterizing triangle A is NOT generally equal to applying the same #define S3L PERSPECTIVE CORRECTION 0 : . 
transformation to triangle A first and then rasterizing it. Even the number // don't disable z-buffer, it makes sense to use it with no sorting 
of rasterized pixels is usually different. #endif 
- If specifying a triangle with integer coordinates (which we are), then: 
- The bottom-most corner (or side) of a triangle is never rasterized #ifndef S3L PERSPECTIVE CORRECTION 
(because it is connected to a right side). f ] /** Specifies what type of perspective correction (PC) to use. Remember this 
- The top-most corner can only be rasterized on completely horizontal side is an expensive operation! Possible values: 
(otherwise it is connected to a right side). Se 
- Vertically middle corner is rasterized if and only if it is on the left 0: No perspective correction. Fastest, inaccurate from most angles. 
x of the triangle and at the same time is also not the bottom-most corner. 1: Per-pixel perspective correction, accurate but very expensive. 
/ 2: Approximation (computing only at every S3L PC APPROX LENGTHth pixel) 
Quake-style approximation is used, which only computes the PC after 
#include «stdint.h» $3L PC APPROX LENGTH pixels. This is reasonably accurate and fast. */ 
define S3L PERSPECTIVE CORRECTION 0 
#ifdef S3L RESOLUTION X #endif 
#ifdef S3L_RESOLUTION_Y 
#define S3L_MAX_PIXELS (S3L_RESOLUTION_X * S3L_RESOLUTION_Y) #ifndef S3L_PC_APPROX_LENGTH . . 
#endif /** For S3L_PERSPECTIVE_CORRECTION == 2, this specifies after how many pixels 
#endif PC is recomputed. Should be a power of two to keep up the performance. 
Smaller is nicer but slower. * 
#ifndef S3L RESOLUTION X #define S3L_PC_APPROX_LENGTH 32 
#ifndef S3L MAX PIXELS #endif 
#error Dynamic resolution set (S3L_RESOLUTION_X not defined), but\ 
S3L_MAX_PIXELS not defined! sif S3L PERSPECTIVE CORRECTION 
#endif 4 Jarfina S3L_COMPUTE_DEPTH 1 // PC inevitably computes depth, so enable it 
endi 
uinti6 t S3L resolutionX = 512; /**« If a static resolution is not set with 
S3L RESOLUTION X, this variable can be #ifndef S3L COMPUTE DEPTH ; 
used to change X resolution at runtime, /** Whether to compute depth for each pixel (fragment). Some other options 
in which case S3L MAX PIXELS has to be may turn this on automatically. If you don't need depth information, turning 
defined (to allocate zBuffer etc.)! */ this off can save performance. Depth will still be accessible in 
#define SS3L RESOLUTION X S3L resolutionX S3L PixelInfo, but will be constant -- equal to center point depth -- over 
#endif the whole triangle. */ 
#define S3L_COMPUTE_DEPTH 1 
#ifndef S3L_RESOLUTION_Y #endif 
#ifndef S3L_MAX_PIXELS 
#error Dynamic resolution set (S3L RESOLUTION Y not defined), but\ #ifndef S3L Z BUFFER d. ul deti ! 
SS3L MAX PIXELS not defined! /** What D of z-buffer (depth buffer) to use for visibility determination. 
#endif Possible values: 
uint16_t S3L resolutionY = 512; /**« Same as S3L resolutionX, but for Y 0: Don't use z-buffer. This saves a lot of memory, but visibility checking 
resolution. */ .won't be pixel-accurate and has to mostly be done by other means 
#define S3L RESOLUTION Y S3L resolutionY (typically 
#endif sorting). 
1: Use fu z-buffer (of S3L_Units) for visibiltiy determination. This is the 
#ifndef S3L USE WIDER TYPES most accurate option (and also a fast one), but requires a big amount of 
/** If true, the library will use wider data types which will largely supress memory.: A : 
.many rendering bugs and imprecisions happening’ due to overflows, But! this 2: Use reduced-size z-buffer (of bytes). This is fast and somewhat accurate, 
will DuC inaccuracies can occur and a considerable amount of memory is 
i i needed. 
4p a tee Consumer more RAM and may potentially be slower on computers with #define S3L_Z BUFFER 0 
native integer. */ #endif 
#define S3L_USE_WIDER_TYPES 0 
#endif #ifndef S3L_REDUCED_Z_BUFFER_GRANULARITY 
/** For S3L_Z_BUFFER == 2 this sets the reduced z-buffer granularity. */ 
#ifndef S3L SIN METHOD ^ #define S3L REDUCED Z BUFFER GRANULARITY 5 
E VE endi 
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#ifndef S3L STENCIL BUFFER 
/** Whether to use stencil buffer for drawing -- with this a pixel that would 
be resterized over an already rasterized pixel (within a frame) will be 
discarded. This is mostly for front-to-back sorted drawing. */ 

M Sderine S3L STENCIL BUFFER 0 
endi 


#ifndef S3L SORT 
/** Defines how to sort triangles before drawing a frame. This can be used to 
solve Visibility in case z-buffer is not used, to prevent overwriting already 
rasterized pixels, implement transparency etc. Note that for simplicity and 
performance a relatively simple sorting is used which doesn't work completely: 
correctly, so mistakes can occur (even the best sorting wouldn't be able to 
solve e.g. intersecting triangles). Note that sorting requires a bit of extra 
memory -- an array of the triangles to sort -- the size of this array limits 
the maximum number of triangles that can be drawn in a single frame 
(S3L_MAX_TRIANGES_DRAWN). Possible values: 


0: Don't sort triangles. This is fastest and doesn't use extra memory. 

1: Sort triangles from back to front. This can in most cases solve visibility 
without requiring almost any extra memory compared to z-buffer. 

2: Sort triangles from front to back. This can be faster than back to front 
because we prevent computing pixels that will be overwritten by nearer 
ones, but we need a 1b stencil buffer for this (enable 

S3L STENCÍL BUFFER), 
So a bit more memory is needed. */ 

#define S3L SORT 0 

#endif 


#ifndef S3L MAX TRIANGES DRAWN ; . 
/** Maximum number of triangles that can be drawn in sorted modes. This 
affects the size of the cache used for triangle sorting. */ 
poet ine S3L_MAX_TRIANGES_DRAWN 128 

#endi 


#ifndef S3L_NEAR PEE . i ; 
/** Distance of the near clipping plane. Points in front or EXATLY ON this 
plane are considered outside the frustum. This must be >= 0. */ 
eae rate S3L_NEAR (S3L_F / 4) 

#endi 


#if S3L_NEAR <= 0 
#define S3L_NEAR 1 // Can't be <= 0. 
#endif 


#ifndef S3L_NORMAL_COMPUTE_MAXIMUM_AVERAGE 
nest attects the S3L_computeModelNormals function. See its description for 
etails. 
#define S3L_NORMAL_COMPUTE_MAXIMUM_AVERAGE 6 
#endif 


#ifndef S3L_FAST_LERP_QUALITY 
FAS Quality (scaling) of SOME (stepped) linear interpolations. © will most 
likely be a tiny bit faster, but artifacts can occur for bigger tris, while 
higher values can fix this -- in theory all higher values will have the same 
speed (it is a shift value), but it mustn't be too high to prevent 
overflow. */ 
#define S3L FAST LERP QUALITY 11 

#endif 


/** Vector that consists of four scalars and can represent homogenous 
coordinates, but is generally also used as Vec3 and Vec2 for various 
purposes. */ 

typedef struct 


S3L_Unit x; 

S3L_Unit y; 

S3L Unit z; 

S3L Unit w; 
} S3L Vec4; 


define S3L logVec4(v)N 
printf("Vec4: %d %d %d %d\n", ((v).x), ((v) -y), C(v).z), ((v) .w)) 


static inline void S3L vec4Init(S3L Vec4 *v); 
static inline void S3L_vec4Set(S3L_Vec4 *v, S3L Unit x, SS3L Unit y, 

S3L Unit z, S3L Unit w); 
static inline void S3L vec3Add(S3L Vec4 *result, S3L Vec4 added); 
static inline void S3L vec3Sub(S3L Vec4 *result, S3L Vec4 substracted); 
S3L Unit S3L vec3Length(S3L Vec4 v); 


/** Normalizes Vec3. Note that this function tries to normalize correctly 
rather than quickly! If you need to normalize quickly, do it yourself in a 
way that best fits your case. * 

void S3L vec3Normalize(S3L Vec4 *v); 


/** Like S3L vec3Normalize, but doesn't perform any checks on the input vector 
which is faster, but can be very innacurate or overflowing. You are supposed 
to provide a "nice" vector (not too big or small). af 

static inline void S3L_vecsNotmalizerast(S3L_vec4 v) 


S3L Unit S3L vec2Length(S3L Vec4 v); 
void S3L_vec3Cross(S3L_Vec4 a, S3L Vec4 b, S3L Vec4 *result); 
static inline S3L Unit S3L vec3Dot(S3L Vec4 a, S3L Vec4 b); 


/** Computes a reflection direction (typically used e.g. for specular component 
in Phong illumination). The input vectors must be normalized. The result will 
be normalized as well. */ | 

void S3L reflect(S3L Vec4 toLight, S3L_Vec4 normal, S3L Vec4 *result); 


/** Determines the winding of a triangle, returns 1 (CW, clockwise), -1 (CCW, 
counterclockwise) or O (points lie on a single line). */ 
static inline int8 t S3L triangleWinding( 
S3L ScreenCoord x0, 
S3L ScreenCoord yo, 
S3L ScreenCoord xi, 
S3L ScreenCoord y1, 
S3L ScreenCoord x2 
S3L ScreenCoord y2); 


typedef struct 


S3L Vec4 translation; . i . k 
S3L_Vec4 rotation; /**« puter angles. Rortation is applied in this order: 


z= by z roll) CW looking along z+ 
2. x = by x (pitc d Cw looking along x+ 
3. y = by y (yaw) CW looking along y+ */ 


S3L_Vec4 scale; 
} S3L_Transform3D; 


#define S3L_logTransform3D(t)\ 
printf("Transform3D: T = [%d %d %d], R = [%d %d %d], S = [%d %d %d]\n",\ 
t).translation.x,(t).translation.y,(t).translation.z,\ 
t).rotation.x (t)-rotation.y, (t):rota ion.z,\ 
t ‘scale.x, (t).scale.y, (t).scale.z) 


static inline void S3L_transform3DInit(S3L_Transform3D *t); 
void S3L_lookAt(S3L_Vec4 pointTo, S3L_Transform3D *t); 


void S3L_transform3DSet ( 
S3L_Unit tx, 


SZ, 
S3L Transform3D *t); 


/** Converts rotation transformation to three direction vectors of given length 
(any one can be NULL, in which case it won't be computed). */ 
void S3L rotationToDirections( 
S3L Vec4 rotation, 
S3L Unit length, 
S3L Vec4 *forw, 
S3L Vec4 *right, 
S3L Vec4 “ups; 


/** 4x4 matrix, used mostly for 3D transforms. The indexing is this: 
matrix[column][row]. * 
typedef S3L_Unit S3L_Mat4[4][4]; 


#define S3L_logMat4(m)\ 


printti Mata an 96d 96d 96d 96dNn %d 96d 96d 96dNn %d 96d %d 96dNn %d 96d %d %d\n"\ 
,(m 0], (m) [1] [0], (m) [2] [9], (m) [3] [O], V 

m)[o][i1],(m)[i][i],(m)[2][1], (m) [ 3] [1], N 

m)[0][2], (m) [1][2], (m) [2] [2], (m) [3] [2], N 

m) [6] [3], (m) E23 [3], (0) E21 E31, (m) £31131) 


/** Initializes a 4x4 matrix to identity. */ 
static inline void S3L mat4Init(S3L Mat4 m); 


void S3L mat4Copy(S3L Mat4 src, S3L Mat4 dst); 
void S3L mat4Transpose(S3L Mat4 m); 


void S3L makeTranslationMat( 
S3L Unit offsetx, 
S3L Unit offsetY, 
S3L Unit offsetZ, 
S3L Mat4 m); 
/** Makes a scaling matrix. DON'T FORGET: scale of 1.0 is set with 
S3L FRACTIONS PER UNIT! */ 
void S3L makeScaleMatrix( 
S3L Unit scaleX, 
S3L Unit scaleY, 
S3L Unit scaleZ, 
S3L Mat4 m); 


/** Makes a matrix for rotation in the ZXY order. */ 
void S3L makeRotationMatrixZXY( 

S3L Unit byX, 

S3L Unit byY, 

S3L Unit byZz, 

S3L Mat4 nj; 


void S3L makeWorldMatrix(S3L Transform3D worldTransform, S3L_Mat4 m); 
void S3L makeCameraMatrix(S3L Transform3D cameraTransform, S3L Mat4 m); 


/** Multiplies a vector by a matrix with normalization by 
S3L FRACTIONS PER UNIT. Result is stored in the input vector. */ 
void S3L vec4Xmat4(S3L Vec4 *v, S3L Mat4 m); 


/** Same as S3L vec4Xmat4 but faster, because this version doesn't compute the 
W component of the result, which is usually not needed. */ 
void S3L vec3Xmat4(S3L Vec4 *v, S3L Mat4 m); 


/** Multiplies two matrices with normalization by S3L_FRACTIONS_PER_UNIT. 
Result is stored in the first matrix. The result represents a transformation 
that has the same effect as applying the transformation represented by m1 and 
then m2 (in that order). */ 

void S3L mát4Xmat4(S3L Màt4 mi, S3L_Mat4 m2); 


typedef struct 
S3L Unit focalLength; 
controlled 


/**« Defines the field of view (FOV). 0 sets an 
orthographics projection (scale is 


with camera's scale in its transform). */ 
S3L Transform3D transform; 
} S3L Camera; 


void S3L cameraInit(S3L Camera *camera); 


typedef struct 


uint8 t backfaceCulling; has What backface culling to use. Possible 
values: 
- 0 none 
- 1 clock-wise 
- 2 counter clock-wise */ 
int8 t visible; /**« Can be used to easily hide the model. */ 
3 S3L DrawConfig; 


void S3L drawConfigInit(S3L DrawConfig *config); 
typedef struct 


const S3L Unit *vertices; 

S3L Index vertexCount; 

const SS3L Index *triangles; 

S3L Index triangleCount; 

S3L Transform3D transform; 

S3L Mat4 *customTransformMatrix; /**« This can be used to override the 


transform (if !- 0) with a custom 
transform matrix, which is more 
general. * 


S3L DrawConfig config; 
3 S3L Model3D; ///« Represents a 3D model. 
void S3L model3DInit( 

const S3L Unit *vertices, 

S3L Index vertexCount, 

const SS3L Index Ne 

S3L Index chang Lec Un A 

S3L_Model3D *model); 


typedef struct 


S3L Model3D *models; 
S3L Index modelCount; 
S3L Camera camera; 
} S3L Scene; ///« Represent the 3D scene to be rendered. 
void S3L sceneInit( 
S3L Model3D *models, 
S3L Index modelCount, 
S3L Scene *scene); 


preter struct 
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///< Screen X coordinate. 


S3L ScreenCoord x; 
///« Screen Y coordinate. 


S3L ScreenCoord y; 


S3L Unit barycentric[3]; /**« Barycentric coords correspond to the three 
vertices. These serve to locate the pixel on a 
triangle and interpolate values between its 
three points. Each one goes from 0 to 
S3L FRACTIONS PER UNIT Cine Luding) but due to 
rounding error may fall outside is range (you 
can use S3L_correctBarycentricCoords to fix this 
for the price of some performance). The sum of 
the three coordinates will always be exactly 
S3L FRACTIONS PER UNIT. */ 

S3L Index modelIndex; ///< Model index within the scene. 

S3L Index triangleIndex; ///« Triangle index within the model. 

uint32 t triangleID; /**« Unique ID of the triangle withing the whole 

Scene. This can be used e.g. by a cache to 
quickly find out if a triangle has changed. */ 


S3L Unit depth; ///« Depth (only if depth is turned on). 
S3L Unit previousZ; /**« Z-buffer value (not necessarily world depth in 
S3L Units!) that was in the z-buffer on the 


pixels position before this pixel was 
rasterized. This can be used to set the value 
> i back, e.g. for transparency. ty 
S3L ScreenCoord triangleSize[2]; /**« Rasterized triangle width and height, 
; can be used ed. for MIP mapping. */. 
} S3L_PixelInfo; /**< Used to pass the info about a rasterized pixel 
(fragment) to the user-defined drawing func. */ 


static inline void S3L_pixelInfoInit(S3L_PixelInfo *p); 


/** Corrects barycentric coordinates so that they exactly meet the defined 
conditions (each fall into «0,S3L FRACTIONS PER UNIT», sum = 
S3L FRACTIONS PER UNIT). Note that doing this per-pixel can slow the program 
down significantly . af i : 
ine void S3L correctBarycentricCoords(S3L Unit barycentric[3]); 


static in 

// general helper functions 

static inline S3L Unit S3L abs(S3L Unit value); 

static inline S3L Unit S3L min(S3L Unit v1, S3L Unit v2); 
static inline S3L Unit S3L max(S3L Unit v1, S3L Unit v2); 
static inline S3L Unit S3L clamp(S3L Unit v, S3L Unit vi, S3L Unit v2); 
static inline S3L Unit S3L-wrap(SaL Unit value S3L Unit mod); 
static inline S3L Unit S3L nonZero(S3L Unit value); 

static inline S3L Unit S3L zeroClamp(S3L Unit value); 

S3L Unit S3L sin(S3L Unit x); 

S3L Unit S3L asin(S3L Unit x); 

static inline S3L Unit S3L cos(S3L Unit x); 


S3L Unit S3L vec3Length(S3L Vec4 v); 
S3L Unit S3L sqrt(S3L Unit value); 


/** Projects a single point from 3D space to the screen space (pixels), which 
can be useful e.g. for drawing sprites. The w component of input and result 
holds the point size. If this size is 0 in the result, the sprite is outside 
the view. * 

void S3L project3DPointToScreen( 

S3L Vec4 point, 
S3L Camera camera, 
S3L_Vec4 *result); 


/** Computes a normalized normal of given triangle. */ 
void S3L triangleNormal(S3L Vec4 t0, S3L Vec4 ti, S3L_Vec4 t2, 
S3L_Vec4 *n); 


/** Helper function for retrieving per vertex indexed values from an array, 
e.g. texturing (UV) coordinates. The 'indices' array contains three indices 
for each triangle, each index pointing into 'values' array, which contains 
the values, each one consisting of 'numComponents' components (e.g. 2 for 
UV coordinates). The three values are retrieved into 'vO', 'vi' and 'v2' | 
vectors (into x, z and w depending on 'numComponents'). This function is 
meant to be used per-trian te (typically from a cache), NOT per-pixel, as it 
is not as fast as possible! */ 

void S3L getIndexedTriangleValues( 

S3L Index triangleIndex, 

const S3L Index *indices, 

const S3L Unit *values, 

uint8 t numComponents, 

S3L_Vec4 *v0, 
S3L_Vec4 *v1 
S3L Vec4 *v2); 


/** Computes a normalized normal for every vertex of given model (this is 
relatively slow and SHOUDN'T be done each frame). The dst array must have a 
sufficient size preallocated! The size is: number of model vertices * 3 * 
sizeof(S3L_Unit). Note that for advanced at lowing sharp edges it is not 
sufficient to have per-vertex normals, but must be per-triangle. This 
function doesn't support this. 


The function computes a normal for each vertex by averaging normals of 
the triangles containing the vertex. The maximum number of these triangle 
normals that will be averaged is set with 
S3L NORMAL COMPUTE MAXIMUM AVERAGE. */ 

void S3L computeModelNormals(S3L Model3D model, S3L Unit *dst, 
int8 t transformNormals); 


/** Interpolated between two values, vi and v2, in the same ratio as t is to 
tMax. Does NOT prevent zero division. */ 
static inline S3L Unit S3L_interpolate( 


S3L Unit vi, 
S3L Unit v2, 
S3L Unit 


S3L Unit tMax); 


/** Same as S3L interpolate but with vi -- 0. Should be faster. */ 
static inline S3L Unit S3L interpolateFromo( 
$3L Unit v2, 
S3L Unit t, 
S3L Unit tMax); 


/** Like Sst toterpotate, but uses a parameter that goes from 0 to 
S3L_FRACTIONS_PER_UNIT - 1, which can be faster. * 

static inline S3L_Unit S3L interpolateByUnit( 

S3L Unit vi, 

S3L Unit v2, 

S3L Unit t); 


/** Same as SSL in terpolateByUnit but with v1 == 0. Should be faster. */ 
static inline S3L Unit S3L interpolateByUnitFromO( 

$3L Unit v2, 
S3L Unit t); 


static inline S3L Unit S3L distanceManhattan(S3L Vec4 a, S3L_Vec4 b); 


/** Returns a value interpolated between the three triangle vertices based on 
barycentric coordinates. */ 
static inline S3L Unit S3L interpolateBarycentric( 
S3L Unit valued, 

S3L Unit value1, 

S3L Unit value2, 

S3L Unit barycentric[3]); 


static inline void S3L mapProjectionPlaneToScreen( 


S3L Vec4 point, 
S3L ScreenCoord *screenX 
S3L ScreenCoord *screenY); 


/** Draws a triangle according to given config. The vertices are specified in 
Screen Space Space (pixels). If perspective correction is enabled, each 
vertex has to have à depth (Z position in camera space) specified in the Z 
component. */ 

void S3L drawTriangle( 

S3L Vec4 pointo, 

S3L Vec4 pointi, 

S3L Vec4 point2, 

S3L Index modellndex, 

S3L Index triangleIndex); 


/** This should be called before rendering each frame. The function clears 
buffers and does potentially other things needed for the frame. * 
void S3L newFrame(void); 


void S3L zBufferClear(void); 
void S3L stencilBufferClear(void); 


/** Writes a value (not necessarily depth! depends on the format of z-buffer) 
to z-buffer (if enabled). Does NOT check boundaries! * 
void S3L zBufferWrite(S3L ScreenCoord x, S3L ScreenCoord y, S3L_Unit value); 


/** Reads a value. [not necessarily depth! depends on the format of z-buffer) 
from z-buffer (if enabled). Does NOT check boundaries! */ 
S3L Unit S3L zBufferRead(S3L ScreenCoord x, S3L ScreenCoord y); 


static inline void S3L rotate2DPoint(S3L Unit *x, S3L Unit *y, S3L Unit angle); 


/** Predefined vertices of a cube to simply insert in an array. These come with 
S3L CUBE TRIANGLES and S3L CUBE TEXCOORDS. */ 
#define S3L CUBE VERTICES(m)N 
/* 0 front, bottom, right */\ 
m/2, -m/2, -m/2,\ 
/* 1 front, bottom, left */\ 
-m/2, -m/2, -m/2,\ 


/* 2 front, top, right */N 
m/2, m/2, -m/2,\ 

/* 3 front, top, eft */N 

-m/2, m/2, -m/2,N 

/* 4 back, bottom, right */\ 
m/2, -m/2, m/2,\ 

/* 5 back, bottom, left */N 


-m/2, -m/2, m/2,N 
/* 6 back, top, right */\ 


/* 7 back, top, eft */N 


#define S3L CUBE VERTEX COUNT 8 


/** Predefined triangle indices of a cube, to be used with S3L CUBE VERTICES 
and S3L CUBE TEXCOORDS. */ 
#define S3L CUBE TRIANGLESV 
3, 0, 2, /* front */\ 


1, 0, 3,\ 

8, 4, 2, /* right */\ 
2, 4, 6,N 

4, 5, 6, /* back — */N 
7, 6, 5,N 

3, 7, 1, /* left — */N 
d Ti BN, 

6, 3, 2, /* top — */N 
7, 8, 6,N 

1, 4, 0, /* bottom */N 
5,4, 1 


#define S3L CUBE TRIANGLE COUNT 12 


/** Predefined texture coordinates of a cube, corresponding to triangles (NOT 
vertices), to be used with S3L CUBE VERTÍCES and S3L CÜBE TRIANGLES. */ 
define S3L CUBE TEXCOORDS(m)*N 


0,0, m,m, m,0,\ 
0,m, m,m, 0,0,\ 
m,m, m,O, O,m,N 

7m, m,0, ©0,0,\ 
m,0, 0,0, m,m,\ 
0,m, m,m, 0,0,\ 
0,0, 0,m, m,0,\ 
m,O, O,m, m,m,\ 
0,0, m,m, m,0,\ 
0,m, m,m, 0,0,\ 
m,O, O,m, m,m,\ 
0,0, O,m, m,O 

/[====== 


// privates 
#define S3L_UNUSED(what) (void)(what) ///< helper macro for unused vars 


#define S3L HALF RESOLUTION X (S3L_RESOLUTION_X >> 1 
#define S3L_HALF_RESOLUTION_Y (S3L_RESOLUTION_Y >> 1 


#define S3L PROJECTION PLANE HEIGHTN 
((S3L RESOLUTION Y * S3L F * 2) / S3L RESOLUTION X) 


sif S3L Z BUFFER == 

#define S3L MAX DEPTH 2147483647 

S3L Unit S3L zBuffer[S3L MAX PIXELS]; 

#define S3L_zBufferFormat(depth) (depth) 
#elif S3L_Z_BUFFER == 2 

#define S3L_MAX_DEPTH 255 

uint8 t S3L zBuffer[S3L MAX PIXELS]; 

#define S3L zBufferFormat depth) \ 

degen (285, (depth) >> $3L REDUCED Z BUFFER GRANULARITY) 

#endi 


#if S3L_Z_BUFFER 

static inline int8_t S3L_zTest( 
S3L_ScreenCoord x, 
S3L_ScreenCoord y, 
S3L_Unit depth) 


uint32_t index = y * S3L_RESOLUTION_X + x; 
depth = S3L_zBufferFormat (depth); 


sif S3L Z BUFFER == 2 
#define cmp <= /* For reduced z-buffer we need equality test, because 
otherwise pixels at the maximum depth (255) would never be 
PE over: the background (which also has the depth of 
#else 


#define cmp < /* For normal z-buffer we leave out equality test to not waste 
bende time by drawing over already drawn pixls. */ 
endi 


if (depth cmp S3L zBuffer[index]) 
S3L zBuffer[index] = depth; 


12 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); small3dlib 


return 1; 


#undef cmp 
return 0; 
hendif 
S3L_Unit S3L_zBufferRead(S3L_ScreenCoord x, S3L_ScreenCoord y) 


hir S3L Z BUFFER 
return S3L zBuffer[y * S3L RESOLUTION X + x]; 
#else 
S3L UNUSED(X); 
S3L UNUSED( y); 
return 0; 
ART 


void S3L zBufferWrite(S3L ScreenCoord x, S3L ScreenCoord y, S3L Unit value) 


hir S3L Z BUFFER 
S3L zBuffer[y * S3L RESOLUTION X + x] = value; 
else 
S3L UNUSED(X); 
S3L UNUSED(y 
S3L UNUSED(v 
#endif 


} 


#if S3L_STENCIL_BUFFER 
#define S3L_STENCIL_BUFFER_SIZE\ 
((S3L_RESOLUTION_X * S3L_RESOLUTION_Y - 1) / 8 + 1) 


alue); 


uint8_t S3L_stencilBuffer[S3L_STENCIL_BUFFER_SIZE]; 


static inline int8 t S3L_stencilTest( 
S3L ScreenCoord x 
S3L ScreenCoord y) 


{ 
uint32_t index = y * S3L_RESOLUTION_X + x; 
uint32 t bit = (index & 0x00000007); 
index = index >> 3; 
uint8_t val = S3L_stencilBuffer [index]; 
if ((val >> bit) & 0x1) 
return 0; 
S3L stencilBuffer[index] = val | (0x1 << bit); 
return 1; 
endif 


#define S3L COMPUTE LERP DEPTHN 
(S3L COMPUTE DEPTH && (S3L PERSPECTIVE CORRECTION == 0)) 


#define S3L SIN TABLE LENGTH 128 


#if S3L SIN METHOD == 
static const SSL Unit S3L sinTable[S3L SIN TABLE LENGTH] = 


/* 511 was chosen here as a highest number that doesn't overflow during 
compilation for S3L_F == 1024 */ 


25*S3L F)/511, (31*S3L F)/511, 
37*S3L F)/511, (43*S3L_F)/511, 
50*S3L F)/511, (56*S3L F)/511, 
62*S3L F)/511, (68*S3L F)/511, 
74*S3L F)/511, (81*S3L F)/511, 
87*S3L F)/511, (93*S3L F)/511, 
99*S3L F)/511, (105*S3L F)/511, 
111*S3L /511, (118*S3L /511, 
124*S3L_F)/511, (130*S3L_F)/511, 
136*S3L_F)/511, (142*S3L_F)/511, 
148*S3L_F)/511, (154*S3L_F)/511, 
160*S3L_F)/511, (166*S3L_F)/511, 
172*S3L_F)/511, (178*S3L_F)/511, 
183*S3L_F)/511, (189*S3L_F)/511, 
195*S3L_F)/511, (201*S3L_F)/511, 
207*S3L_F)/511, (212*S3L_F)/511, 
218*S3L_F)/511, (224*S3L_F)/511, 
229*S3L_F)/511, (235*S3L_F)/511, 
240*S3L_F)/511, (246*S3L_F)/511, 
251*S3L_F)/511, (257*S3L_F)/511, 
262*S3L_F)/511, (268*S3L_F)/511, 
273*S3L_F)/511, (278*S3L_F)/511, 
283*S3L_F)/511, (289*S3L_F)/511, 
294*S3L_F)/511, (299*S3L_F)/511, 
304*S3L_F)/511, (309*S3L_F)/511, 
314*S3L_F)/511, (319*S3L_F)/511, 
324*S3L_F)/511, (328*S3L_F)/511, 
333*S3L_F)/511, (338*S3L_F)/511, 
343*S3L_F)/511, (347*S3L_F)/511, 
352*S3L_F)/511, (356*S3L_F)/511, 
361*S3L_F)/511, (365*S3L_F)/511, 
370*S3L_F)/511, (374*S3L_F)/511, 
378*S3L_F)/511, (382*S3L_F)/511, 
386*S3L_F)/511, (391*S3L_F)/511, 
395*S3L_F)/511, (398*S3L_F)/511, 
402*S3L_F)/511, (406*S3L_F)/511, 
410*S3L_F)/511, (414*S3L_F)/511, 
417*S3L_F)/511, (421*S3L_F)/511, 
424*S3L_F)/511, (428*S3L_F)/511, 
431*S3L_F)/511, (435*S3L_F)/511, 
438*S3L_F)/511, (441*S3L_F)/511, 
444*S3L F)/511, (447*S3L_F)/511, 
450*S3L F)/511, (453*S3L F)/511, 
456*S3L F)/511, (459*S3L F)/511, 
461*S3L F)/511, (464*S3L F)/511, 
467*S3L F)/511, (469*S3L F)/511, 
472*S3L F)/511, (474*S3L F)/511, 
476*S3L F)/511, (478*S3L F)/511, 
481*S3L F)/511, (483*S3L F)/511, 
485*S3L F)/511, (487*S3L_F)/511, 
488*S3L F)/511, (490*S3L F)/511, 
492*S3L F)/511, (494*S3L F)/511, 
495*S3L F)/511, (497*S3L F)/511, 
498*S3L F)/511, (499*S3L F)/511, 
501*S3L F)/511, (502*S3L_F)/511, 
503*S3L F)/511, (504*S3L F)/511, 
505*S3L F)/511, (506*S3L_F)/511, 
507*S3L F)/511, (507*S3L F)/511, 
508*S3L F)/511, (509*S3L_F)/511, 
509*S3L F)/511, (510*S3L F)/511, 
510*S3L F)/511, (510*S3L F)/511, 
510*S3L_F)/511, (510*S3L_F)/511 


linair 


#define S3L SIN TABLE UNIT STEPN 
(S3L_F / (S3L.SIN TABLE LENGTH * 4)) 


void S3L vec4Init(S3L Vec4 *v) 


v-2x = 0; v->y = 0; v-»z = 0; v->w = S3L_F; 


vend S3L_vec4Set(S3L_Vec4 *v, S3L Unit x, S3L Unit y, S3L Unit z, S3L Unit w) 


v->X = X; 
v->y = y; 
v->Z = Z; 
v->W = wW; 


H 

void S3L vec3Add(S3L Vec4 *result, S3L Vec4 added) 
result->x += added.x; 
result->y += added.y; 
result->z += added.z; 

void S3L_vec3Sub(S3L_Vec4 *result, S3L_Vec4 substracted) 
result->x -= substracted.x; 
result->y -= substracted.y; 
result->z -= substracted.z; 

poo S3L_mat4Init(S3L_Mat4 m) 


#define M(x m[x 
#define SG ee PII 


Goon 


OOV 


Wong 
euooo 


NOOO 


3k 
c 
5 
a 
o 
> 
ox 


H 
void S3L mat4Copy(S3L Mat4 src, S3L Mat4 dst) 
for (uint8 t j - 
for (uint8 t i 
dst[i][j] = src 
S3L Unit S3L vec3Dot(S3L Vec4 a, S3L Vec4 b) 
return (a.x * b.x + a.y * b.y + a.z * b.z) / SaL F; 


D S3L reflect(S3L Vec4 toLight, S3L Vec4 normal, S3L Vec4 *result) 
S3L Unit d = 2 * S3L_vec3Dot(toLight, normal) 


result-»x - (normal.x * d) / S3L F - toLight.x; 
result->y = (normal.y * d) / S3L F - toLight.y; 
} result->z = (normal.z * d) / S3L F - toLight.z; 
void S3L vec3Cross(S3L Vec4 a, S3L Vec4 b, S3L Vec4 *result) 
result-»x - - a.z * b.y; 
result-»y - - a.x * b.z; 
result-»z - - a.y * b.x; 


void S3L_triangleNormal(S3L_Vec4 t0, S3L_Vec4 t1, S3L_Vec4 t2, S3L_Vec4 *n) 
#define ANTI_OVERFLOW 32 


t1.x = (t1.x - t@.x) / ANTI OVERFLOW; 
ti.y = (tl.y - tO.y) / ANTI OVERFLOW; 
tiiz = (t1:z - t0.2) / ANTI OVERFLOW; 
t2.x = (t2.x - t@.x) / ANTI OVERFLOW; 
t2:y = (t2.y - tO.y) / ANTI OVERFLOW; 
t2.z = (t2.z - t0.z) / ANTI OVERFLOW; 


#undef ANTI OVERFLOW 
S3L_vec3Cross(t1,t2,n); 


S3L_vec3Normalize(n); 


} 


void S3L getIndexedTriangleValues( 

S3L Index triangleIndex, 

const S3L Index *indices, 

const S3L Unit *values, 

uint8 t numComponents, 

S3L_Vec4 *v0, 

S3L_Vec4 *v1 

S3L Vec4 *v2) 


uint32 t i0, ii; 
S3L Unit *value; 


i0 - triangleIndex * 3; 
ii indices[i0] * numComponents ; 
value - (S3L Unit *) v0; 


if (numComponents » 4) 
numComponents - 4; 


for (uint8 t j = 0; j « numComponents; ++j) 


*value = values[ii]; 
iitt; 
value++; 


iO++; —— ; 
ii - indices[i0] * numComponents; 
value = (S3L Unit *) v1; 


for (uint8 t j = 0; j « numComponents; ++j) 
*value = values[ii1]; 


iic; 
value++; 


iO++; — : 
ii - indices[i0] * numComponents; 
value - (S3L Unit *) v2; 
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} 


for ( 


*va 
iit 
val 


} 


uint8 t j = 0; j < numComponents; ++j) 
lue = values[i1]; 

d 

uen; 


void S3L computeModelNormals(S3L Model3D model, S3L Unit *dst, 


int8 


t transformNormals) 


S3L Index vPos - 0; 

S3L VecA n; 

n.w = 0; 

S3L_Vec4 ns[S3L NORMAL COMPUTE MAXIMUM AVERAGE]; 


S3L I 
for ( 


ndex normalCount; 


uint32 t i = 0; i < model.vertexCount; ++i) 


normalCount - 0; 


for 


1 


we 


35355 ww 
N< X 


if 


(uint32 t j = 0; j « model.triangleCount * 3; j += 3) 


model.triangles[] * 1 BI 
model.triangles[j + 2] == i)) 


S3L Vec4 tO, ti, t2; 
uint32 t vIndex; 


( 
nods t: Ertangtes t] == i) || 
=1 


#define getVertex(n)\ 
vIndex = model-friangtesi] +n] * 3;\ 
t##n.x = model.vertices[viIndex];\ 
viIndex++;\ 
t##n.y = model.vertices[vIndex];\ 
viIndex++;\ 
t##n.z = model.vertices[vIndex]; 


getVertex(1 


getVertex(0 
getVertex(2 


#undef getVertex 
S3L_triangleNormal(t0, t1,t2,&(ns[normalCount])); 


normalCount++; 


2f (normatcount >= S3L NORMAL COMPUTE MAXIMUM AVERAGE) 
reak; 


S3L F; 
9; 
9; 


ü (normalCount !- 0) 


// compute average 


for (uint8 t i - 0; i « normalCount; 


235 
< 
" 
" 
=] 
o 
m 


.X += ns[i].x; 
loy 
i].z; 


/- normalCount; 
/- normalCount; 
/= normalCount; 


5235 
N< x 


S3L_vec3Normalize(&n); 


} 


dst[vPos] 
vPos++; 


H 
5 
x 


dst[vPos] 
vPos++; 


H 
5 
< 


dst[vPos] 
vPos++; 


} 
S3L_Mat4 m; 


H 
5 
N 


S3L makeWorldMatrix(model.transform,m); 


if (transformNormals) 


for (S3L_Index i = 0; i < model.vertexCount * 3; i += 3) 


n.x = dst[i]; 
n.y = dst[i + 1]; 
n.z = dst[i + 2]; 


S3L vec4Xmat4(&n,m); 


dst[i] = n.x; 
dst[i + 2] = 


dst[i + 3] 


} 


yoid S3L_vec4Xmat4(S3L_Vec4 *v, S3L_Mat4 m) 


S3L_Vec4 vBackup; 


vBackup.x = v-»x; 
vBackup.y = v->y; 
vBackup.z = v-»z; 
vBackup.w = v-»w; 


#define dotCol(col)\ 

((vBackup.x m[col] [0 +\ 

vBackup.y * m{col][1 +\ 
vBackup.z * m[col][2 
vBackup.w * m[coli[3 


v->x = dotCol(0 
v->y dotCol(1 
V->Z dotCol(2 
v->w = dotCol(3 


+\ 
) / S3L_F 


++i) 


yoid S3L_vec3Xmat4(S3L_Vec4 *v, S3L_Mat4 m) 
S3L Vec4 vBackup; 


#undef dotCol 

#define dotCol(col)\ 
vBackup.x * m[col][6 / S3L_F +\ 
vBackup.y * m{col][1 Z S3L F *N 
vBackup.z * m[{col][2 / S3L F *N 


m[col][3] 

vBackup.x = v-»x; 
vBackup.y = v-»y; 
vBackup.z = v-»z; 
vBackup.w = v->w; 
v->x = dotCol(0); 
v->y = dotCol(1); 
v->z = dotCol(2); 
v->w = S3 E 


H 
#undef dotCol 
EAE S3L abs(SS3L Unit value) 


return value * (((value >= 0) << 1) - 1); 


3 
put S3L min(S3L Unit vi, S3L Unit v2) 


return vi >= v2 ? v2 : v1; 


} 


ae S3L_max(S3L_Unit vi, S3L_Unit v2) 


H 
get unit S3L clamp(S3L Unit v, S3L Unit vi, S3L Unit v2) 


return v1 >= v2 ? v1 : v2; 


return v >= vi? (v <= v2 ? v : V2) : v1; 


H 
ESSE S3L zeroClamp(S3L Unit value) 


return (value * (value >= 0)); 


} 
get Unit S3L_wrap(S3L_Unit value, S3L_Unit mod) 


return value >= 0 ? (value % mod) : (mod + (value % mod) - 1); 


H 
oo S3L_nonZero(S3L_Unit value) 


return (value + (value == 0)); 


} 


get unit S83L interpolate(S3L Unit v1, S3L Unit v2, S3L Unit t, S3L Unit tMax) 


} return v1 + ((v2 - v1) * t) / tMax; 


S3L Unit S3L interpolateByUnit(S3L Unit vi, S3L Unit v2, S3L Unit t) 


{ 


} return v1 + ((v2 - v1) * t) / S3L_F; 


EISE S3L interpolateByUnitFromO(S3L Unit v2, S3L Unit t) 


} return (v2 * t) / S3L_F; 


get unit S3L interpolateFromO(S3L Unit v2, S3L Unit t, S3L Unit tMax) 


return (v2 * t) / tMax; 


H 
co S3L_distanceManhattan(S3L_Vec4 a, S3L_Vec4 b) 
return 
S3L_abs(a.x - b.x) + 
S3L_abs(a.y - b.y) + 
S3L_abs(a.z - b.z); 


void S3L mat4Xmat4(S3L Mat4 mi, S3L_Mat4 m2) 
S3L Mat4 mati; 


for (uinti6 t row = 0; row < 4; ++row) 
for (uinti6 t col = 0; col < 4; ++col) 
mati[col][row] = mifcoi][row|; 


for (uinti6 t row = 0; row < 4; ++row) 
for (uinti6 t col = 0; col < 4; ++col) 


mi[col][row] = 0; 
for footy trey i=0; i < 4; ++i) 


mi sal Hier += ; 
i][row] * m2[col][i]) / S3L F; 


mat 
H 
S3L Unit S3L sin(S3L Unit x) 


{ 
#if S3L_SIN_METHOD == 0 


x = S3L wrap(x / S3L SIN TABLE UNIT STEP,S3L SIN TABLE LENGTH * 4); 


int8 t positive - 1; 


if (x < S3L SIN TABLE LENGTH) 


else if (x < S83L SIN TABLE LENGTH * 2) 
} X = S3L_SIN_TABLE_LENGTH * 2 - x - 1; 
as if (x < S3L_SIN_TABLE_LENGTH * 3) 


X = X - S3L_SIN_TABLE_LENGTH * 2; 
positive - 0; 


else 


X = S3L SIN TABLE LENGTH - (x - S3L SIN TABLE LENGTH * 3) - 1; 


positive - 0; 


return positive ? S3L sinTable[x] : -1 * S3L sinTable[x]; 


#else 
int8_t sign = 1; 


14 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); small3dlib 


a (x < 0) // odd function 


x *- -1 
sign - -1; 
x %= S3L F; 


i (x > S3L_F / 2) 
X -= S3L_F / 2; 
sign *= -1; 
S3L_Unit tmp = S3L_F - 2 * x; 
#define _PI2 ((S3L. Unit) (9.8696044 * S3L F)) 


return sign * // Bhaskara's pi nation 
(32 * x * xt / S3L | F) : gmp) 4 
mp) / 


.PI2 * 5 z Y (a? 
S3L_F sab) F 
#undef ^q i 
TOT 


S3L Unit S3L asin(S3L Unit x) 


if S3L SIN METHOD == 
x = S3L_clamp(x, -S3L_F,S3L_F); 


int8_t sign T? 


if (x « 0) 


sign - -1; 
Hc 
H 


inti6 t low - 0, high - S3L SIN TABLE LENGTH -1, middle; 
while (low «- high) // binary search 
í middle = (low + high) / 2; 

S3L Unit v = S3L sinTable[middle]; 


if (v » x) 

high - middle - 1; 
else if (v « x) 

low = middle + 1; 
else 

break; 


middle *- S3L SIN TABLE UNIT STEP; 


return sign * middle; 
#else 
S3L_Unit pow = -1 * S3L_F / A, 
high S3LF / 4, 
dle; 


ute (low <= high) // binary search 
middle = (low + high) / 2; 
S3L Unit v = S3L sin(middle); 


if (v » x) 

high - middle - 1; 
else if (v « x) 

low = middle + 1; 
else 

break; 


return middle; 
#endif 


S3L Unit S3L_cos(S3L_Unit x) 
return S3L sin(x + S3L F / 4); 


p S3L correctBarycentricCoords(S3L Unit barycentric[3]) 


S3L -ClanbtbarVcentric[4]'0'$3L-E) 


barycentric[0 
S3L clamp(barycentric[11,0,S3L F); 


barycentric[1 


S3L Unit d = S3L F - barycentric[0] - barycentric[1]; 


if (d « 0) 
barycentric[0] += d; 
barycentric[2] = 0; 

else 
barycentric[2] = 


void S3L makeTranslationMat( 
S3L Unit offsetx, 
S3L Unit offsetY, 
S3L Unit of fsetz, 


i SaL Mat4 m) 
#define M(x, D ÉD 
#define S S3 
M(0,0) = S; M(1,0) = 0; M(2,0) = 0; M(3,0) = 6; 
M(0,1) = O; M(1,1) = S; M(2,1) = 6; M(3,1) = 0; 
M(0,2) = 0; M(1,2) = 0; M(2,2) = S; M(3,2) = 0: 
M(0,3) = offsetX; M(1,3) = offsetY; M(2,3) = offsetz; M(3,3) = 
#undef M 
} #undef S 


void S3L Tox AEX 
S3L Unit scaleX 
S3L Unit ScaleY, 
S3L Unit scalez, 
S3L Mat4 m) 


{ 
#define M(x,y) m[x][y] 
scaleX; M(1,0 = 0; M(3,0) = 6; 
0; M Li - 0; M(3, = 
9; M(1,2 = LIE: M(3, m = 0; 
o: M(1,3 ; M(3,3) = S$3L F; 


#undef M 


void S3L makeRotationMatrixZXY( 
S3L Unit byX, 
S3L Unit byY, 
S3L Unit byZ, 


( S3L Mat4 m 
byX *- -1; 
byY *- -1; 
byZ *- -1; 
S3L Unit sx = S3L sin(byX); 
S3L Unit sy - S3L sin(byY); 
S3L Unit sz = S3L_sin(byZ); 
S3L Unit cx = S3L_cos(byX); 
S3L Unit cy = S3L_cos(byY); 
S3L_Unit cz = S3L_cos(byZ); 


#define M(x,y) m[x] Ly] 
#define S S3L_F 


M(Q,0) = (cy * cz) / S + (sy * sx * sz) / (S* S); 
M(1,0) = ox * $2) / 8; (sy LEN ) 
M(2,0) = (cy * sx * sz) / (S * S) - (cz * sy) / S; 
M(3,0) = 0; 

M(0,1) = (cz * sy * sx) / (S* S) - (cy * sz) / S; 
M(1,1) = (cx * ei) / 2 ( TAE ) ' 
M(2,1) = (cy * cz * sx) / (S * S) + (Sy * Sz) / S; 
M(3,1) = 6; 

M(0,2) = (cx * Sy) / S; 

M(1,2) = - SX; 

M(2,2) = (cy * cx) / S; 

M(3,2) = 0; 

M(0,3 

M(1,3 

M(2,3 

M(3,3 

#undef M 

#undef S 


H 
S3L Unit S3L sqrt(S3L Unit value) 
int8 t sign - 1; 


H yvate < 0) 


uint32_t result = 0; 
uint32_t a = value; 
uint32_t b = 1u << 30; 


while (b > a) 
b >>= 2 


i 
while (b != 0) 
if (a >= result + b) 
a -= result + b; 
result = result + 2 * b; 


b >>= 2; 
result >>= ij 


return result * sign; 


} 
S3L_Unit S3L_vec3Length(S3L_Vec4 v) 


return S3L sqrt(v.x * v.x * v.y * v.y + v.z * v.z); 


S3L Unit S3L vec2Length(S3L Vec4 v) 


return S3L sqrt(v.x * v.x + v.y * v.y); 


yoid S3L_vec3Normalize(S3L_Vec4 *v) 


#define SCALE 16 
#define BOTTOM_LIMIT 16 
#define UPPER_LIMIT 900 


/* Here we try to decide if the vector is too small and would cause 
If so, we scale 
it up. We can't scale up everything as big vectors overflow in length 


inaccurate result due to very its inaccurate length. 


calculations. */ 


if ( 
S3L_abs(v->x) <= BOTTOM LIMIT && 
S3L_abs(v->y) <= BOTTOM LIMIT && 
S3L_abs(v->z) <= BOTTOM LIMIT) 


v->x *- SCALE; 
v->y *= SCALE; 
v->z *= SCALE; 


l 

else if ( 
S3L_abs(v->x) > UPPER LIMIT 
S3L_abs(v->y) > UPPER LIMIT 
S3L_abs(v->z) > UPPER LIMIT) 


v-»x /- SCALE; 
v->y /- SCALE; 
} v->z /= SCALE; 


#undef SCALE 
#undef BOTTOM_LIMIT 
#undef UPPER_LIMIT 


S3L Unit l = S3L_vec3Length(*v); 


if (1 == 0) 

return; 
v-»x = (v->x * S3L_F) / l; 
v->y = (v->y * S3L_F) / l; 
v-»z = (v->z * S3L_F) / 1; 
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H 
void S3L vec3NormalizeFast(S3L Vec4 *v) 
S3L Unit l = S3L vec3Length(*v); 


if (1 == 0) 

return; 
v->x = (v->x * S3L_F) / l; 
v->y = (v->y * S3L_F) / l; 
v->z = (v->z * S3L_F) / 1; 


H 
ete S3L_transform3DInit(S3L_Transform3D *t) 
Sat-vecatnit tart. >translation)); 


S3L_vec4Init (&(t->rotation) ); 
t->scale.x S3L_F; 


t->scale.y = S3L_F; 
t->scale.z = S3L_F; 
t->scale.w = 0; 


} 


LE Performs perspecive division (z-divide). Does NOT check for division by 
zero 

static inline void S3L perspectiveDivide(S3L Vec4 *vector 
S3L Unit focalLength) 


if (focalLength == 0) 


return; 
vector->x = (vector->x * focalLength) / vector->z; 
vector->y = (vector->y * focalLength) / vector->z; 


void S3L_project3DPointToScreen( 
S3L_Vec4 point, 
S3L_ Camera camera, 
S3L Vec4 *result) 


// TODO: hotfix to prevent a mapping bug probably to overlfows 
S3L_Vec4 toPoint = point, camForw; 


S3L_vec3Sub(&toPoint, camera.transform. translation) ; 
S3L vec3Normalize(&toPoint); 


S3L —rotationToDirections(camera. transform.rotation,S3L FRACTIONS PER UNIT, 
&camForw, 0,0) ; 


if (S3L_vec3Dot(toPoint,camForw) < S3L FRACTIONS PER UNIT / 6) 


result-»z - -1; 
result-»w - 0; 
} return; 
7/ end of hotfix 
S3L Mat4 m; 


S3L -makeCameraMatrix(camera. transform,m); 

S3L Unit s - point.w; 

point.w = S3L F; 

S3L vec3Xmat4(&point,m); 

point.z = S3L nonZero(point.z); 

S3L perspectiveDivide(&point,camera.focalLlength); 
S3L ScreenCoord x, y; 


S3L mapProjectionPlaneToScreen(point,&x, &y); 


result-»x = x; 
result->y = y;. 
result->z = point.z; 
result->w = 


point.z <= 0) ? 0 : 


camera.focalLength > 0 ?( 
(s * camera. focalLength S3L RESOLUTION X) / 
(point.z * S3L F)) 
((camera.transform. $càle.x * S3L RESOLUTION X) / S3L F) 


1 


H 
bod S3L lookAt(S3L Vec4 pointTo, S3L_Transform3D *t) 
S3L_Vec4 v; 
v.x = pointTo.x - t->translation.x; 
v.y = pointTo.z - t->translation.z; 
S3L Unit dx - v. 
S3L Unit 1 = S3L X ec2Length(v); 
= (v.x * S3L F) / S3L nonzero(1); // normalize 
t->rotation.y = -1 * S3L_asin(dx); 
if (v.y < 0) , 
t- Yrbtatión. y = S3L_F / 2 - t->rotation.y; 
VX = pointTo.y - t->translation.y; 
vey = by 
l = S3L_vec2Length(v); 
= (v.x * S3L F) / S3L nonzero(1); 
} t->rotation.x = S3L asin(dx); 
void S3L_transform3DSet ( 
S3L_Unit tx, 
S3L_Unit ty, 
S3L_Unit tz, 
S3L_Unit rx, 
S3L_Unit ry, 
S3L_Unit rz, 
S3L_Unit sx, 
S3L_Unit Sy; 
S3L Unit 
( S3L Transfokmap *t) 
t->translation.x = tx; 
t->translation.y = ty; 
t->translation.z = tz; 


t->rotation.x = 
t->rotation.y = ry; 


t->rotation.z rz; 
t->scale.x = sx; 
t->scale.y = sy; 

} t->scale.z = sz; 


void S3L_cameraInit(S3L_Camera *camera) 


camera->focalLength = S3L_F; 
S3L _transform3DInit (&(camera- >transform) ); 


} 


void S3L_rotationToDirections( 
S3L_Vec4 rotation, 
S3L_Unit length, 
S3L_Vec4 *forw, 
S3L_Vec4 *right, 
S3L_Vec4 “ups 


S3L_Mat4 m; 
S3L makeRotationMatrixZXY(rotation.x,rotation.y,rotation.z,m); 


if (forw !- 0) 
{ 


forw->x = 0; 
forw->y = 0; 
forw->z = 


S3L AETA m); 


Ü (right != 0) 


right->x Length; 
right->y 9; 
right-»z 0; 

S3 . veca3xmatá (right, m); 


if (up !- 0) 
t u 


up->x 0; 

up-»y length; 
up->z = 0; 

S3L . vec3Xmat4(up, m) ; 


3? 


ene S3L_pixelInfoInit(S3L_PixelInfo *p) 
P= >x = 0; 


a de 0; 
-> vem 


S3L F; 
H 


9; 


be >barycentric[1 
p->barycentric[2 
p->modelIndex = 
p- >triangleIndex = = 0; 
p- >triangleID = 0; 
p->depth = 0; 
p->previousZ = 0; 


} 


void S3L model3DInit( . 
const S3L Unit *vertices, 
S3L Index vertexCount, 
const SS3L Index *triangles, 
S3L Index £riang tsCount, 
S3L Model3D *model) 


model->vertices = vertices; 
model->vertexCount = vertexCount; 
model->triangles = triangles; 
model->triangleCount = triangleCount; 
model->customTransformMatrix = 0; 


S3L_transform3DInit (&(model->transform) ); 
} S3L_drawConfigInit (&(model->config) ); 


void S3L sceneInit( 
S3L Model3D *models, 
S3L Index modelCount, 
S3L Scene *scene) 


scene->models = models; 
scene->modelCount = modelCount; 
S3L cameraInit(&(scene-»camera]); 


} 


void S3L_drawConfigInit(S3L_DrawConfig *config) 


config- >backfaceCulling = = 2; 
config->visible = 1; 


#ifndef S3L_PIXEL_FUNCTION . YU 
error Pixel rendering function (S3L_PIXEL_FUNCTION) not specified! 
#endi 


static inline void S3L_PIXEL_FUNCTION(S3L_PixelInfo *pixel); // forward decl 


/** Serves to accelerate linear interpolation for performance-critical 
code. Functions such as_S3L_interpolate require division to compute each 
interpolated value, while S3L FastLerpState only requires a division for 
the initiation and a shift for retrieving each interpolated value. 


Set EASTER OUR stores a value and a step, both scaled (shifted by 
S3L FAST LERP QUALITY) to increase precision. The Step is being added to the 
value, which achieves the interpolation. This will only be useful for 
interpolations in which we need to get the interpolated value in every step. 


BEWARE! Shifting a negative value is undefined, so handling shifting of 
negative values has to be done cleverly. */ 
typedef struct 


S3L Unit valueScaled; 
S3L Unit stepScaled; 
} S3L FastLerpState; 


#define S3L getFastLerpValue Huh 
(state.valueScaled >> S3L FAST LÉRP QUALITY) 


#define S3L_stepFastLerp(state)\ 
state.valueScaled += state.stepScaled 


static inline S3L_Unit S3L_interpolateBarycentric( 
S3L Unit value, 
S3L Unit valuei, 
S3L Unit value2, 
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S3L Unit barycentric[3]) splitonLeft - 0; 


endY - lPointSS-»y; 


return 
( else 
valueO * barycentric[O * 
valuei * barycentric[1 * splitY - lPointSS-»y; 
value2 * barycentric[2 splitOnLeft = 1; 
) S3L F; endY - rPointSS-»y; 


void S3L mapProjectionPlaneToScreen( 
S3L Vec4 point, 
S3L ScreenCoord *screenx 
S3L ScreenCoord *screenY) 


S3L ScreenCoord currentY = tPointSS->y; 


/* We'll be using an algorithm similar to Bresenham line algorithm. The 
specifics of this algorithm are among others: 


*screenX - 
S3L HALF RESOLUTION X + 
(point.x * S3L HALF RESOLUTION X) / S3L F; 


- drawing possibly NON-CONTINUOUS line 
- NOT tracing the line exactly, but rather CAS TRCLUDIN one the right 
side of it, according to the pixel CENTERS, INCLUDING the pixel 


centers 
*screenY - 


SIL HALF | RESOLUTION_Y - 


The principle is this: 
(point.y * S3L HALF RESOLUTION X) / S3L F; princi preis EIS 


- Move vertically by pixels and accumulate the error (abs dx/ dy 


A E - If the error is greater than one (crossed the next pixe Cent à keep 
void S3L_zBufferClear (void) movin horizontally and Er 1 from the error until it k less 
; an 1 again. 
#if S3L Z BUFFER A : - To make this INTEGER ONLY, scale the case so that distance between 


for (uint32 t i = 0; i < S3L RESOLUTION X * S3L RESOLUTION Y; ++i) pixels. is ea to dy (instead of 1). This way the error becomes 


S3L_zBuffer[i] = S3L MAX DEPTH; dx/dy ^ == dx, and we're comparing the error to (and potentially 
QT subs rack ing 1 * dy == dy. 
; ; l int16_t 
void S3L stencilBufferClear(void) VUA triangle side: 
Hif S3L STENCIL BUFFER it Ms 
for (Uint32 t i = 0; i < S3L STENCIL BUFFER SIZE; ++i) Ux, PDK, M current AEE etat Posi ce 
S3L "StencilBuffer[i] = = 0; lby, rDy, // dy fend point - start point 
#endif linc, rInc, // direction in which to increment (1 or -1) 
j lErr, rErr, // current error (Bresenham) 


lErrCmp, rErrCmp, // helper for deciding comparison (> vs >=) 


void S3L newFrame(void) lErrAdd, rErrAdd, // error value to add in each Bresenham cycle . 
lErrSub, rErrSub; // error value to substract when moving in x direction 

S3L-zBufferc tear Qui 
S3L stencilBufferClear(); S3L FastLerpState lSideFLS, rSideFLS; 

/* the following serves to communicate info about if the triangle has been Mi OD aS Le PSEA  IDepthFLS, rDepthFLS; 

split m 
and how the barycentrics should be remapped. */ : : 

uint8 t S3L projectedTriangleState = 0; // 0 = normal, 1 = cut, 2 = split #define initDepthFLS(s,p1,p2)N 


s##DepthFLS.valueScaled = 
s##DepthFLS.stepScaled = d 
s##DepthFLS.valueScaled) / 


pi##PointSS->z << S3L_FAST_LERP_QUALITY;\ 
Dor OLnESS- >z << S3L FAST LERP QUALITY) - 


#if S3L NEAR CROSS STRATEGY == 3 (s##Dy != © ? s##Dy : 1); 


S3L_Vec4 _S3L_triangleRemapBarycentrics[6]; #else 
#endif #define initDepthFLS(s, p1,p2) 
#endif 


void S3L -ürawTriangle( 


S3L Vec4 point6, /* init side for the algorithm, params: 

$314 vera point, S - which side (l or r) 

S3L Index mode Lindex p3 i poine io e ae qn 

= 1 å 

S3L_Index triangleIndex) down - whether the side Coordinate goes top-down or vice versa */ 
define initSide(s,p1,p2,down)\ 

E RixetInto:p i S##X = p1##PointSs- SX; 

. pixe InfoInit(8p); s##Dx = p2##PointSS->x - p1##PointSS->x;\ 
b. po RM = FETA LEE S d TtHenE ENEI OREA n 
p.triangleID = (modelIndex << 16) | triangleIndex; sHaSiderLs. stepScaled c = (S3L F << S3L FAST LERP QUALITY)N 
(s##Dy '= 0 ? s##Dy : 1);\ 
s##SideFLS. valuescalsa = 0;\ 


S3L_Vec4 *tPointSS, *lPointSS, *rPointSS; /* points in Screen Space (in 
ir (!down)\ 


3L_Units, normalized by 
S3L_F) */ 
s##SideFLS.valueScaled =\ 


S3L Unit *barycentricO; // bar. 
S3L Unit *barycentrici; // bar. 
S3L Unit *barycentric2; // bar. 


// sort the vertices: 

MEE assignPoints(t,a,b)\ 
tPointSS = &point##t;\ 
barycentric2 = &(p. barycentr 


if (S3L_ triangleWinding(point 
xpozntesb. x, point##b.y) >= 


‘points = &point##a; rPoi 

barycentricO = alp. barycen 

barycentricl - &(p.barycen 
b 

lPointSS - point rPoi 

barycentricO - &(p. barycen 

= &(p.barycen 


baryeentract 
H 
if (pointO.y <= pointi.y) 
if (pointO.y <= point2.y) 
asBignPoihts(0, 1,2) 
else 
assignPoints(2,0,1) 
else 
if (pointi.y <= point2.y) 
asbignPoihts(1, 0,2 


else 
assignPoints(2,0,1) 


#undef assignPoints 


Hif S3L FLAT 


*barycentricO = S3L F / 3; 

*barycentrici = S3L_F / 3; 

*barycentric2 = S3L_F - 2 * (S3L_ 
#endif 


p.triangleSize[o rPointSS->x 


p.triangleSize[1 


(rPointSS->y > lPointSS-»y ? rPointSS->y : 


// now draw the triangle line by 


S3L ScreenCoord splitY; // Y of the vertically middle point of the triangle 
// bottom Y of the whole triangle 
/* whether splitY is the y coord. 


S3L ScreenCoord endY; 

int splitOnLeft; 
point 

if (rPointSS-»y «- lPointSS-»y) 


splitY - rPointSS-»y; 


coord that gets higher from L to R 
coord that gets higher from R to L 
coord that gets higher from bottom up 


ic 
ICE X, ir ointwwt. y, point##a.x, point##a.y,\ 


ntss = AppIn pisos N 
tric[b 
tric[a A 


ntSS - &point##a;\ 


gite 


F3) 


- lPointSS-»x; 
lPointSS-»y) - tPointSS-»y; 
line: 


of left or right 


dA 


S3L F «« S3L FAST LERP QUALITY; \ 
cor eerte: stepScaled *= -1;\ 


s##Inc = s##Dx >= 0 ? 1 : -1;\ 


if (s##Dx < 0)\ 
{s##Err = 0; s##ErrCmp = 0;}\ 


else\ 
{s##Err = s##Dy; s##ErrCmp = 1;}\ 
s##ErrAdd = S3L_abs(s##Dx) ; 
s##ErrSub = s##Dy != 0 ? SiH #Dy : 1; /* don't allow ©, could lead to an 


infinite substracting loop */ 


#define stepSide(s)\ 
while (s##Err - s##Dy >= s##ErrCmp)\ 


S##X += s##Inc;\ 
s##Err -= s##ErrSub;\ 


JN 
s##Err += s##ErrAdd; 


initSide(r,t,r,1 
initSide t; t, Ui 


sif S3L PERSPECTIVE, CORRECTION 
/* PC is done by linearly interpolating reciprocals from which the corrected 
velues can be computed. See 
http://www.lysator.liu.se/-mikaelk/doc/perspectivetexture/ */ 


sif S3L PERSPECTIVE CORRECTION == 
#define Z RECIP NUMERATORV 
S3L F * S3L F * S3L F) 
#elif SS3L PERSPECTIVE CORRECTION == 
#define Z_RECIP_NUMERATOR\ 
(S3L_F * S3L_F) 


#endif 
/* ^ This numerator is a number by which we divide values for the 
reciprocals. For PC == 2 it has to be lower because linear interpolation 


scaling would make it overflow -- this results in lower depth precision 
in bigger distance for PC == 2. */ 


S3L_Unit 
tPointRecipZ, lPointRecipZ, rPointRecipZ, /* Reciprocals of the depth of 
each triangle point. */ 

/* Helper variables for swapping 


lRecipO, lRecipi, rRecipo, 
the above after split. 


rRecipi; 


tPointRecipZ = Z RECIP NUMERATOR / SS3L nonZero(tPointSS-»z); 
lPointRecipZ = Z RECIP NUMERATOR / S3L nonZero(lPointSS-»z); 
rPointRecipZ = Z RECIP NUMERATOR / S3L_nonZero(rPointSS->z); 
lRecipO = tPointRecipZ; 
lRecipi = lPointRecipZz; 
rRecipO = tPointRecipZ; 
rRecipi = rPointRecipZ; 
#define manageSp LitPer spective(be, ,b1)\ 
bi##RecipO = bO##PointRecipZ;\ 
bi##Recip1 = bi##PointRecipZ;\ 
bO##RecipO = bO##PointRecipZ; \ 
bo##Recip1 = tPointRecipZ; 
#else 


#define manageSplitPerspective(b0,b1) ; 
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#endif 
// clip to the screen in y dimension: 
endY = S3L min(endY,S3L RESOLUTION Y); 


re clipping above the screen by < 0) can't be easily done here, will be 
handled inside the loop. * 

while (currentY « endY) /* draw the triangle from top to bottom -- the 
bottom-most row is left out because, following 
from the rasterization rules (see start of the 
file), it is to never be rasterized. */ 


if (currentY -- splitY) // reached a vertical split of the triangle? 


#define manageSplit(b0,b1,s0,s1)\ 
S3L Unit *tmp = barycentric##b0;\ 
barycentric##b0 = barycentric##b1; \ 
barycentric##b1 = tmp; 
sO##SideFLS.valueScaled = (S3L_F\ ; 
<< S3L FAST LERP QUALITY) - s0##SideFLS.valueScaled;\ 
sO##SideFLS.stepScaled *- -1;\ 
manageSplitPerspective(s0, s1J 


if (splitOnLeft) 


initSide(l,l,r,0); 
manageSplit(0,2,r,1) 


else 
initSide(r,r,1,0); 
mananeseete (d 8 d 
H 
H 
stepSide(r 
stepSide(l 


if (currentY »- 0) /* clipping of pixels whose y « 0 (can't be easily done 
outside the loop because of the Bresenham- like 
algorithm steps) */ 
p.y = currentY; 
// draw the horizontal line 


Hif !S3L FLAT . 
S3L Unit rowLength = S3L nonZero(rX - 1X - 1); // prevent zero div 


sif S3L PERSPECTIVE CORRECTION 
S3L Unit lOverZ, lRecipZ, rOverZ, rRecipZ, lT, rT; 


lT = S3L getFastLerpValue(lSideFLS); 
rT - S3L getFastLerpValue(rSideFLS); 
lOverz = SS3L interpolateByUnitFromO0(lRecipi,lT); 
lRecipZz = S3L interpolateByUnit(lRecip0, iRecipi, LT); 
rOverZ = S3L interpolateByUnitFromO(rRecipi,rT); 
dei rRecipZ = S3L_interpolateByUnit(rRecip0, rRecip1, rT); 
else 


S3L_FastLerpState bOFLS, b1FLS; 


#if S3L COMPUTE LERP DEPTH 
S3L FastLerpState  depthFLS; 


depthFLS.valueScaled - lDepthFLS.valueScaled; 
depthFLS.stepScaled - 
é a VEDEpERFLS -valuescated - lDepthFLS.valueScaled) / rowLength; 
endi 


bOFLS.valueScaled 
biFLS.valueScaled 


S 
1$ideFLS.valueScaled; 


bOFLS.stepScaled 
b1FLS.stepScaled 
#endif 
#endif 


rSideFLS.valueScaled / rowLength; 
-1 * lSideFLS.valueScaled / rowLength; 


// clip to the screen in x dimension: 


S3L ScreenCoord rXClipped = S3L min(rX,S3L RESOLUTION X), 
1XC lipped 1X; 


if (lXClipped < 0) 
1XClipped = 0; 


sif !S3L PERSPECTIVE CORRECTION && !S3L FLAT 
bOFLS.valueScaled -= 1X * bOFLS.stepScaled; 
biFLS.valueScaled -= 1X * biFLS.stepScaled; 


#if S3L_COMPUTE_LERP_DEPTH 
depthFLS.valueScaled -= 1X * depthFLS.stepScaled; 
#endif 
#endif 


#if S3L_PERSPECTIVE_CORRECTION 
S3L ScreenCoord i = lXClipped - 1X; /* helper var to save one 
substraction in the inner 
loop */ 
#endif 


#if S3L_PERSPECTIVE_CORRECTION == 
S3L_FastLerpState 
depthPC, // interpolates depth between row segments 
bOPC, // interpolates barycentricO between row segments 
b1PC; // interpolates barycentrici between row segments 


/* ^ These interpolate values between row segments (lines of pixels 
of S3L PC APPROX LENGTH length). After each row segment perspective 
correction is recomputed. * 


depthPC.valueScaled - 
Z RECIP NUMERATOR / 
3L_nonZero(S3L_interpolate(lRecipZ, rRecipZ, i, rowLength) ) ) 
<< S3L_FAST_LERP_QUALITY; 


nore /vatuescated = 
pele titerpolacerromo¢roverz;1,rowLength) 
* depthPC.valueScale 
) / (Z_RECIP_NUMERATOR / S3L F); 


biPC.valueScaled = 


( 
(loverz - S8L interpolateFromO(lOverZ,i,rowLength)) 
depthPC.valueScaled 


) / (Z RECIP. NUMERATOR / S3L F); 


int8 t rowCount = S3L PC APPROX LENGTH; 
#endif 


#if S3L_Z_BUFFER . 
F Uint32.t zBufferIndex = p.y * S3L RESOLUTION X + lxclipped; 
#endi 


// draw the row -- inner 109p; 
for (S3L_ScreenCoord x = lXClipped; x < rXClipped; ++x) 


int8 t testsPassed - 1; 


sif S3L STENCIL BUFFER 
if (!SS3L stencilTest(x,p.y)) 
testsPassed - 0; 
#endif 
p.x-x; 
#if S3L COMPUTE DEPTH 
sif S3L PERSPECTIVE CORRECTION == 
p. depth - Z RECIP NUMERATOR / . uw 
S3L nonZero(S3L interpolate(lRecipZz,rRecipZ,i,rowLength)); 
#elif S3L PERSPECTIVE CORRECTION == 2 
if (rowCount >= S3L PC APPROX LENGTH) 


// init the linear interpolation to the next PC correct value 

rowCount - 0; 

S3L Unit nextI = i + S3L PC APPROX LENGTH; 

if (nextI « rowLength) 

y edis nextDepthScaled - 

Z RECIP NUMERATOR / i ] 
S3L_nonZero(S3L_interpolate(lRecipZ, rRecipZ, nextI, rowLength) ) 
) << S3L_FAST_LERP_QUALITY; 


depthPC.stepScaled 
(nextDepthScaled 


depthPC.valueScaled) / S3L_PC_APPROX_LENGTH; 
S3L_Unit nextValue = 


gsl_interpolaterromo(roverZ, next, rowLength) 
* nextDepthScaled 
) / (Z RECIP NUMERATOR / S3L F); 


bOPC.stepScaled = 
(nextValue - bOPC.valueScaled) / S3L_PC_APPROX_LENGTH; 


nextValue = 


( 
(loverz - S3L interpolateFromO(lOverz,nextI,rowLength)) 
nextDepthScaled 
) / (Z RECIP NUMERATOR / S3L F); 


biPC.stepScaled = 
(nextValue - biPC.valueScaled) / S3L PC APPROX LENGTH; 


else 


/* A special case where we'd be interpolating outside the triangle. 
It seems like a valid approach at first, but it creates a bug 
in a case when the rasaterized triangle is near screen 0 and can 
actually never reach the extrapolated screen position. So we 
have to clamp to the actual end of the triangle here. */ 


S3L Unit maxI = S3L_nonZero(rowLength - i); 


Sannir nextDepthScaled = 
Ż_RECIP_NUMERATOR / 


S3L_nonZero(rRecipZ) 
) << S3L FAST. LERP. QUALITY; 


depthPC.stepScaled - 
(nextDepthScaled - depthPC.valueScaled) / maxI; 


S3L Unit nextValue 


rOverZ 
* nextdepthscaled 
) / (Z RECIP NUMERATOR / S3L F); 


bOPC.stepScaled = 
(nextValue - bOPC.valueScaled) / maxI; 


biPC.stepScaled = 
-1 * b1iPC.valueScaled / maxI; 


p.depth = S3L getFastLerpValue(depthPC); 


p.depth = Sst_getFastterpValue(depthFLs); 
die 3L stepFastLerp(depthFLS); 
dendi 


#else // !S3L COMPUTE DEPTH 
Beate p.depth = (tPointSS->z + lPointSS-»z + rPointSS->z) / 3; 
endi 


sif S3L Z BUFFER 
p.previousZ = S3L zBuffer[zBufferIndex]; 


zBufferIndex++; 


if (!S3L_zTest(p.x,p.y,p.depth) ) 
testsPassed = 0; 
#endif 


if (testsPassed) 


Hif !S3L FLAT 
sif S3L PERSPECTIVE CORRECTION == 0 
*barycentricO - S3L getFastLerpValue(bOFLS); 
*barycentrici = S3L getFastLerpValue(b1FLS 
#elif SSL PERSPECTIVE CORRECTION == 1 
*barycentricO = 


1 


S3L interpolateFromO(rOverZ,i,rowLength) 
s p, depth 
) / (Z RECIP NUMERATOR / S3L F); 
*barycentrici = 
(loverz - S83L interpolateFromO(lOverz,i,rowLength)) 


p, depth 
) / (Z RECIP NUMERATOR / S3L F); 
#elif S3L PERSPECTIVE CORRECTION == 
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*barycentricO 


S3 L-BetraecLerbVa lue bibe]: 


i *barycentric1 S3L getFastLerpValue(b1PC); 
#endif 
*barycentric2 = 
J S3L F - *barycentricO - *barycentrici; 
#endif 


#if S3L_NEAR_CROSS_STRATEGY == 
if (_S3L_projectedTriangleState != 0) 


S3L_Unit newBarycentric[3]; 


newBarycentric[0] = S3L_interpolateBarycentric( 
_S3L_triangleRemapBarycentrics[0].x, 
_S3L_triangleRemapBarycentrics[1].x, 
_S3L_triangleRemapBarycentrics[2].x, 
p.barycentric); 


newBarycentric[1] = S3L_interpolateBarycentric( 
_S3L_triangleRemapBarycentrics[0].y, 
_S3L_triangleRemapBarycentrics[1].y, 
_S3L_triangleRemapBarycentrics[2].y, 
p.barycentric); 


newBarycentric[2] = S3L_interpolateBarycentric( 
_S3L_triangleRemapBarycentrics[0].z, 
_S3L_triangleRemapBarycentrics[1].z, 
_S3L_triangleRemapBarycentrics[2].z, 


p.barycentric); 


p.barycentric[0] = newBarycentric[0]; 
p.barycentric[1] - newBarycentric[1]; 
p.barycentric[2] = newBarycentric[2]; 


#endif 
S3L PIXEL FUNCTION(&p); 
} // tests passed 


Hif !S3L FLAT 
if S3L PERSPECTIVE CORRECTION 


itt; 
sif S3L PÉRSPECTIVE CORRECTION == 
rowCount++; 


S3L_stepFastLerp(depthPC); 
S3L stepFastLerp(bOPC); 
S3L stepFastLerp(b1PC); 
#endif 

#else 
S3L stepFastLerp(bOFLS); 
S3L stepFastLerp(b1FLS); 

#endif 

#endif 


} // inner loop 
3 // y clipping 


sif !S3L FLAT 
S3L stepFastLerp(lSideFLS); 
S3L stepFastLerp(rSideFLS); 
#if S3L COMPUTE LERP DEPTH 
S3L stepFastLerp(lDepthFLS); 
S3L stepFastLerp(rDepthFLS 
#endif 
#endif 


r 


++currentY; 
3 // row drawing 


#undef manageSplit 
#undef initPC 
#undef initSide 
#undef stepSide 
} #undef Z_RECIP_NUMERATOR 


void S3L_rotate2DPoint(S3L_Unit *x, S3L_Unit *y, S3L_Unit angle) 


if (angle < S3L_SIN_TABLE_UNIT_STEP) 
return; // no visible rotation 


S3L_Unit angleSin 
S3L_Unit angleCos 


S3L sin(angle); 
S3L cos(angle); 


S3L Unit xBackup - *x; 


"(eges t C9) 7 BEE 


ty = 


angleSin * xBackup) / S3L_F + 
angleCos * (*y)) / S3L_F; 


void S3L makeWorldMatrix(S3L Transform3D worldTransform, S3L_Mat4 m) 


S3L makeScaleMatrix( 
wor LdTransform.scale.x, 
worldTransform.scale.y, 
ine dTransform.scale.z, 
m); 


S3L_Mat4 t; 


S3L makeRotationMatrixZXY( 
worldTransform.rotation.x, 
worldTransform.rotation.y, 
worldTransform.rotation.z, 


S3L mat4Xmat4(m,t); 


SaL makerrans lat ionMat ( A 

wor ldTransform. translation. x, 
worldTransform.translation.y, 
worldTransform.translation.z, 


S3L mat4Xmat4(m,t); 


os S3L_mat4Transpose(S3L_Mat4 m) 
S3L_Unit tmp; 


for (uint8 t = 0; y < 3; tty) 
for (uints_t x ='1 + y; x <4; Hx) 


{ 
tmp = mb] Ly] 
n] = my4 [x]; 


m[y][x] = tmp; 
H 
void S3L makeCameraMatrix(S3L Transform3D cameraTransform, S3L_Mat4 m) 


t S3L_makeTranslationMat( 
-1 * cameraTransform.translation.x, 
-1 * cameraTransform.translation.y, 
a * cameraTransform.translation.z, 
m); 


S3L Mat4 r; 


S3L makeRotationMatrixZXY( 
cameraTransform.rotation.x, 
cameraTransform.rotation.y, 
En nore ee One 
r); 


S3L mat4Transpose(r); // transposing creates an inverse transform 
S3L Mat4 s; 


S3L makeScaleMatrix 
cameraTransform.scale.x, 
cameraTransform.scale.y, 
cameraTransform.scale.z,s); 


S3L mat4Xmat4(m,r); 
S3L mat4Xmat4(m,s 


} 


int8 t S3l_triangleWinding( 
S3L_ScreenCoord x0, 
S3L ScreenCoord yo, 
S3L ScreenCoord x1, 
S3L ScreenCoord y1, 
S3L ScreenCoord x2 
S3L ScreenCoord y2) 


$ 


int32_t winding = 
YL- yO) * (x2 - xi) - (xi - x0) * (y2 - y1); 
/ ^ cross product for points with z == 0 


return winding » 0 ? 1 : (winding « 0 ? -1: 0); 


/** Checks if given triangle (in Screen Space) is at least partially visible, 
i.e. returns false if the triangle is either completely outside the frustum 
(left, right, top, bottom, near} or is_invisible due to backface culling. */ 

static inline ints_t S3L_triangleIsVisible( 
S3L_Vec4 po, 

S3L_Vec4 pi, 
S3L Vec4 p2 i 
uint8_t backfaceculling) 


#define clipTest(c,cmp,v)\ 
(pO.c cmp (v) && pi.c cmp (v) && p2.c cmp (v)) 


if // outside frustum? 
sif S3L NEAR CROSS STRATEGY == 0 
pO.z <= S3L NEAR || pi.z <= S3L NEAR || p2.z <= S3L NEAR || 
// ^ partially in front of NEAR? 
#else 
clipTest(z,<=,S3L_NEAR) || // completely in front of NEAR? 
#endif 
clipTest(x,<,0) || 
clipTest(x,»-,$3L RESOLUTION X) || 
clipTest(y,<,0) || 
clipTest(y,»,S3L RESOLUTION Y) 


return 0; 
#undef clipTest 
if (backfaceCulling != 0) 


int8 t winding - 
S3L_triangleWinding(p0.x,p0.y,p1.x,p1.y,p2.x,p2.y); 


if ((backfaceCulling == 1 && winding > 0) || 
backfaceCulling == 2 && winding < 0)) 
return 0; 


return 1; 


} 


#if S3L_SORT != 0 
typeder struct 


uint8_t modelIndex; 
S3L Index triangleIndex; 
uinti6 t sortValue; 

} _S3L_TriangleToSort; 


_S3L_TriangleToSort S3L sortArray[S3L MAX TRIANGES DRAWN]; 
uintio-t S3L sortArrayLength; 
endi 


void _S3L_projectVertex(const S3L Model3D *model, S3L Index triangleIndex, 
( uint8 t vertex, S3L_Mat4 projectionMatrix, S3L Vec4 *result) 


uint32 t vertexIndex = model->triangles[triangleIndex * 3 + vertex] * 3; 


result-»x - model-»vertices[vertexIndex]; 

result->y = model->vertices[vertexIndex + 1]; 
result->z = model->vertices[vertexIndex + 2]; 
result->w = S3L_F; // needed for translation 


S3L vec3Xmat4(result,projectionMatrix); 


result-»w - result-»z; : 
/* We'll keep the non-clamped z in w for sorting. */ 


} 


ad _S3L_mapProjectedVertexToScreen(S3L_Vec4 *vertex, S3L Unit focalLength) 
vertex->z = vertex->z >= S3L_NEAR ? vertex-»z : S3L_NEAR; 5 
/* ^ This firstly prevents zero division in the follwoing z-divide and 
secondly "pushes" vertices that are in front of near a little bit forward, 


which makes them behave a bit better. If all three vertices end up exactly 
on NEAR, the triangle will be culled. */ 


S3L perspectiveDivide(vertex, focalLength); 
S3L ScreenCoord sX, sY; 
S3L mapProjectionPlaneToScreen(*vertex, &sX, &sY) ; 


SX; 
SY; 


vertex-»x 
vertex->y 
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} } _S3L_mapProjectedVertexToScreen(&transformed[2],focalLength) ; 


/** Projects a triangle to the screen. If enabled, a triangle can be 


potentially .— DE 3 ; : void S3L_drawScene(S3L_Scene scene) 
subdivided into two if it crosses the near plane, in which case two projected { 
triangles are returned pe info about splitting or cutting the triangle is S3L Mat4 matFinal, matCamera; A 
passed in global variables, see above). */ S3L_Vec4 transformed[6]; // transformed triangle coords, for 2 triangles 


void  S3L project Triangle 


const S3L Model3D "model, const S3L Model3D *model; 
S3L- Index triangleindex, S3L Index modelIndex, triangleIndex; 
oT 1 
yants2—t teansForfied[e]) S3L makeCameraMatrix(scene.camera.transform,matCamera); 
_S3L_projectVertex(model, triangleIndex,0,matrix,&(transformed[0])); Hif SS3L SORT != 0 
.S3L projectVertex(model, triangleIndex,1,matrix, &(transformed[1 A uint16_t previousModel = 0; 
_S3L_projectVertex(model, triangleIndex, 2,matrix, &(transformed[2 ; S3L sortArrayLength - 0; 
_S3L_projectedTriangleState = 0; #endif 
#if S3L_NEAR_CROSS_STRATEGY == 2 || S3L_NEAR_CROSS_STRATEGY == 3 for (modelIndex = 0; modelIndex « scene.modelCount; ++modelIndex) 
uint8 t infront - 60; 
uint8 t behind = 0:. if (!scene.models[modelIndex].config.visible) 
uint8 t infrontI[3]; continue; 
uint8 t behindI[3]; 
sif S3L SORT != 0 
for (uint8 t i = 0; i < 3; ++i) if (S3L_sortArrayLength >= S3L MAX TRIANGES DRAMN) 
if (transformed[i].z < S3L NEAR) break; 
infrontI[infront] - i; previousModel - modelIndex; 
infront++,; #endif. 
else if (scene.models[modelIndex].customTransformMatrix == 0) 
behind [behind] = i; qSaLsmakeworiLaMaEr 1x (scene «models [model Index]. transform matrinal) 
behind++; I etse 
S3L_Mat4 *m = scene.models[modelIndex].customTransformMatrix; 
#if S3L_NEAR_CROSS_STRATEGY == 3 i i20: 7 4j 
for (int i= 0; i < 3; eti) RN ree ot CURE d Sg] 1 car dai 
S3L vec4Init(&( S3L triangleRemapBarycentrics[i])); mátFinal[i][j] = (Cn) (4105 ; 
-S3L-triangleRemapBarycentrics 0].x = S3L_F; 
_S3L_triangleRemapBarycentrics[1].y = S3L F; i 
_S3L_triangleRemapBarycentrics[2].z = S3L F; S3L_mat4Xxmat4(matFinal, matCamera); 


#endif S3L Index triangleCount = scene.models[modelIndex].triangleCount; 


#define interpolateVertex \ 
S3L Unit edo EN triangleIndex - 0; 
transformed[be].z - S3L NEAR) * S3L_F) /\ 
traneeorned bfl - tPanerornd inus model = &(scene.models[modelIndex]); 
ARM cM e - transformed[be[.x - 


(CEransformedibe] .x - transformed[in].x) * ratio) /N while (triangleIndex « triangleCount) 


/* Some kind of cache could be used in theory to not project perviously 


ER 
transformed[in].y = transformed[be].y -\ F alread - : 
x A y projected vertices, but after some testing this was abandoned 
(Ceransformed [be] .y transformed[in].y) ratio) /\ no gain was seen. */ 
F7 
transformed[in].z = S3L_NEAR;\ P y , 
if (bel != 8) i^ _S3L_projectTriangle(model, triangleIndex,matFinal 
beI->x = el-»x * ratio) / S3L_F;\ scene.camera.focalLength, transformed); 
beI-»y = fpei) $ ratio) / S3L F;N 
beI->z = (beI->z * ratio) / S3L_F;\ if (S3L_triangleIsVisible(transformed[0], transformed[1], transformed[2] 
ratio = S3L F - ratio; model->config.backfaceCulling) ) 
beI->x += (beB->x * ratio) / S3L_F;\ { 
beI->y += (beB->y * ratio) / S3L_F;\ #if S3L_SORT == 0 
beI-»z += (beB->z * ratio) / S3L_F; } // without sorting draw right away 


if (infront == 2) S3L drawTriangle(transformed[0], transformed[1], transformed[2],modelIndex 


I . triangleIndex); 
// shift the two vertices forward along the edge 


for (uint8_t i = 0; i« 2; ++i) if (_S3L_projectedTriangleState == 2) // draw potential subtriangle 
uint8 t be = behindI[0], in = infrontI[i]; #if s3t_NEAR_CROSS_STRATEGY = 
. siehst riangleRemapBarygentrics[9] = 
#if S3L_NEAR_CROSS_STRATEGY == 3 . | .S3L triangleRemapBarycentrics[ 
S3L_Vec4 *beI = &( S3L triangleRemapBarycentrics[in]), .  .S3L triangleRemapBarycentrics[1] = 
*beB = &(_S3L_triangleRemapBarycentrics[be]); _S3L_triangleRemapBarycentrics[4]; 
#else í siegt riangleRemapBarygentrics[2] = 
S3L_Vec4 *beI = 0, *beB = 0; _S3L_triangleRemapBarycentrics[ 
#endif #endif 
interpolateVertex S3L_drawTriangle(transformed[3], transformed[4], transformed[5] 
modeliIndex, triangleIndex); 
_S3L_projectedTriangleState = 1; 
#else 
} va ya 
else if (infront == 1) ir (S3L-sortArrayLength >= S3L MAX TRIANGES DRAWN) 
reak; 
// create another triangle and do the shifts 
transformed[3] transformed[behindI Wd A // with sorting add to a sort list 
transformed[4] = transformed[infront [ li S3L sortArray[S3L sortArrayLength].modellndex = modelIndex; 
transformed[5 transformed[infrontI[0]]; S3L sortArray[S3L sortArrayLength].triangleIndex = triangleIndex; 
i S3L_sortArray[S3L_sortArrayLength].sortValue = S3L zeroClamp( 
#if S3L NEAR CROSS STRATEGY == 3 transformed[0].w + transTormed[1i].w + transformed[2].w) >> 2; 
_S3L_triangleRemapBarycentrics[3] = . /[* ^ 
.S3L triangleRemapBarycentrics|behindI[1]]; The w component here stores non-clamped z. 
.S3L triangleRemapBarycentrics[4| = 
.S3L triangleRemapBarycentrics|infrontI[0]]; As a simple approximation we sort by the triangle center point, 
_S3L_triangleRemapBarycentrics[5][ = which is a mean coordinate -- we don't actually have to divide by 3 
___S3L_triangleRemapBarycentrics|infrontI[0]]; (or anything), that is unnecessary for sorting! We shift by 2 just 
#endif as a fast operation to prevent overflow of the sum over uint_16t. */ 
for (uint8_t i = 0; i < 2; ++i) i S3L_sortArrayLength++; 
d : A , y #endif 
uint8_t be = behindI[i], in = i + 4; 
#if S3L_NEAR_CROSS_STRATEGY == 3 . i triangleIndex++; 
S3L_Vec4 *beI = &(_S3L_triangleRemapBarycentrics[in]), 
mn *beB = &(_S3L_triangleRemapBarycentrics[be]); } 
else 
__S3L_Vec4 *beI = 0, *beB = 0; #if S3L_SORT != 0 
#endif 2 ` 
interpolateVertex ERT 
#else 
A #define cmp > 
#if S3L_NEAR_CROSS_STRATEGY == 3 g #endif 
_S3L_triangleRemapBarycentrics[infrontI[0]] = 
,,-93L triangleRemapBarycentrics[4]; /* Sort the triangles. We use insertion sort, because it has many advantages, 
#endif especially for Mete arrays (better than bubble sort, in-place, stable 
simple, ; 


transformed[infrontI[0]] = transformed[4]; 
for (inti6 t i = 1; i < S3L_sortArrayLength; ++i) 


_S3L_mapProjectedVertexToScreen(&transformed[3], focalLength); 
_S3L_mapProjectedVertexToScreen(&transformed[4], focalLength) ; _S3L_TriangleToSort tmp = S3L_sortArray[i]; 
_S3L_mapProjectedVertexToScreen(&transformed[5],focalLength) ; 

inti6é_t j =i - 1; 
_S3L_projectedTriangleState = 2; 

while (j >= © && S3L sortArray[j].sortValue cmp tmp.sortValue) 


#undef interpolateVertex S3L sortarray[j + 1] = S3L sortarray[j]; 
#endif // S3L NEAR CROSS STRATEGY == j psy 


_S3L_mapProjectedVertexToScreen(&transformed[0], focalLength) ; ^ 
S3L sortArray[j * 1] - tmp; 


.S3L mapProjectedVertexToScreen(&transformed[1], focalLength 


20 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); small3dlib 


' 


} 


_S3L_projectTriangle(model, triangleIndex, matFinal, scene.camera.focalLength, 


#undef cmp transformed); 
for (SSL Index i = 0; i < S3L_sortArrayLength; ++i) // draw sorted triangles S3L_drawTriangle(transformed[0], transformed[1], transformed[2],modelIndex, 
t modelIndex = S3L_sortArray[i] .modelIndex; friangIeInaex)y 

triangleIndex = S3L sortArray[i].triangleIndex; if (_S3L_projectedTriangleState == 2) 

model = &(scene.models[modelIndex]); #if S3L_NEAR_CROSS_STRATEGY == 3 


_S3L_triangleRemapBarycentrics[0] = _S3L_triangleRemapBarycentrics[3]; 
_S3L_triangleRemapBarycentrics[1] = 4 


: = : _S3L_triangleRemapBarycentrics 
if (modelIndex != previousModel) ___S3L_triangleRemapBarycentrics[2 _S3L_triangleRemapBarycentrics[5 

// only recompute the matrix when the model has changed #endif 

eS Snatanand ETE aT aora a d S3L drawTriangle(transformed[3], transformed[4], transformed[5] 

previousModel = modelIndex; modelIndex, triangleIndex) ; 
/* Here we project the points again, which is redundant and slow as they've and 

already been projected above, but saving the projected points would 

require a lot of memory, which for small resolutions could be even 

worse than z-bufer. So this seems to be the best way memory-wise. */ #endif // guard 


SAF 


Readme 


Small Abstract Fish (SAF) 
kd tiny public domain suckless portable console for small games 


IMAGES 
If you create a game with SAF, I'll be glad if you let me know! 
in browser games: MicroTD, Minigames 


Philosophy 

SAF wants to provide you with a distilled joy of simple nostalgic game programming with as little friction and frustration as possible (no 
complicated APIs, no bloat, no legal conditions, ...), while also supporting creation of ethical games that can run even on very simple devices, 
games that people can easily study, share and improve without frustration or fear, games that will survive forever, games that are here for you 
and not any corporation's profit. SAF follows and promotes the philosophy of peace, social anarchy, free software and mainly of "less is more", 
which is related to technology minimalism, suckless, Unix and KISS philosophies. SAF is taking a step back to the times at which technology 
was still sane, so that we can step forward in a new, better direction. 


What and why? 
SAF is a very minimal C interface for programming mainly small games that will run on many small gaming consoles, but SAF will also run on 
PCs and other "big" platforms, and can be used to create not just games but also other "toy" programs. You can look at SAF in different ways: 


e It's a bit like SDL for tiny computers, mainly open consoles such as Pokitto and Arduboy, it provides abstraction, portability and convenience functions. 
It spares people of constantly having to manually port games over and over to new consoles. 
e It's a bit like a fantasy console, it intentionally limits you so that the programming is simple, comfy, and your games will inevitably be nostalgic and 
"retro". Thanks to this, SAF can be supported even on very small 8 bit consoles. 
e It's a library that will save you from implementing and debugging many things over and over. And it will make it much easier to program games for 
platforms that don't come with emulators. 
e Itis an API, an interface, a standard, which has many advantages, it is e.g. easy to switch backends, automatically process the code etc. 
* [t behaves a bit like an emulator, it gives you the possibility to record inputs, speed up or slow down time, use pixel art upscaling etc. 
How exactly does this work? SAF is wholly implemented in a single C header file: saf.h. In it the library functions (such as shape drawing) 
are implemented, as well as all supported backends (i.e. platform specific code such as writing pixels to the screen). Which backend 
implementation is used is chosen with a define before including saf.h, the code for other than the chosen backend will then be ignored. The 
game rode along with saf.h then together form source code that can be compiled for the chosen platform, just as any other program for that 
pla ; 


"n such low specs? You may ask why SAF doesn't support a higher resolution, color depth, more advanced sound effects, networking and 
similar features. This is on purpose: sometimes less is more, and the decision for lower specs comes with many advantages and benefits. For 
example, ne ey of programming increases as you, the programmer, can deal with less complexity, fewer headaches from complex APIs and 
libraries, smaller friction, you finish your projects faster (and, in fact, actually finish them), ie can create assets super quickly, see the results 
very early. You don't deal with resizeable windows, mouse cursor, opening sockets and similar things, you just write the game with focus on its 
pure essence, a fun gameplay. We currently have an abundance of big, feature-heavy engines and frameworks, but very few small, minimalist 
and lightweight ones, which is why | created SAF. Another reason is portability -- since SAF aims to run on many simple platforms, its set of 
features must be the lowest common denominator of these platforms (basically every console has at least the 64x64 etc.). 


When to use this? If ou want to create a pretty simple platform independent game and don't mind giving up the full control and 
performance of the specific HW. 


But can SAF power something more advanced than "tetris"? Yes, technically you are only limited by the few hardcoded parameters of 
SAF, i.e. the hardcoded number of buttons, display resolution etc. SML" power is not limited, so you can in neon create a ray traced 3D 
game with advanced puen simulation in SAF, and nothing is apong you from using big 3rd party libraries, even if that's not recommended. 
În this case the small consoles with simple HW will prona ly not be able to run your game, which a little bit kills the purspose of SAF, but 
nothing is stopping you from going wild and hacking this in ways that go against recommendations, if that is what you want. 


Why choose this over a framework like Godot? A game written in a "big" engine will always be burdened by many dependencies and 
bloat which makes it too much dependent on the engine and unable to run on very simple HW, even if the gome is extremely simple and could 
otherwise run on it, the heavyweight engine underneath will discriminate against many platforms, and will kind of hold you project "hostage", 
you need to believe a third patty will for a long time continue to develop and maintain a very expensive engine for you. This way your game 
may have a minimalistic look, but it will never be beautiful and efficient on the inside, you will always drag along a huge burden. With SAF you 
can create a game that's not only art from the player's point of view, but also from the engineer's, you keep all the advantages of having 
simple internals: speed, portability, low HW demands, independence, hackability, simplicity of compilation and so on, and you can also actually 
understand and change anything in the code of SAF itself. 


When NOT to use this? If you're creating something that needs all the power and capabilities of a specific HW, when pushing the console 
towards its limits or needing some of the specs of "big" computers, such as high resolution and HQ sound. Choosing to program with the 
platform's specific library instead of SAF is similar to choosing to program in assembly instead of a higher level language: you get the full 
control and power for the price of portability, comfortable programming, safety and other things. 
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So is this a fantasy console? Kinda yes but also not strictly. The goal of SAF primarily isn't to create an imaginary HW platform but more to 
unify, simplify, standardize and help porting, to free games of specific HW dependencies, to find a common denominator platform. That 
actually goes along well with the idea of a fantasy console, and SAF in fact does intentionaly artificially limit some parameters such as 
resolution or number of buttons, just ibe any consoles do, however it doesn't limit the HW power (memory, CPU frequency etc.) and it 
doesn't strictly enforce things like exclusion of 3rd party libraries, it doesn't create any sandboxes or virtual environments, the goal is to 
produce lightweight programs that run natively. 


Can I ignore your philosophy and just "steal" this for my proprietary commercial project? Yes, you can, I've willingly given up the 
option to enforce any "rights" over this, and | wouldn't do it even if | could, | strongly reject the idea of intellectual property. If you profit from 
this, that's great, if you send me something back I'll be glad, if you credit me I'll be glad, but if you don't | don't care, it's purely your business, 
do what you think is right. 


Features, Advantages, Limitations e Well behaved games are deterministic. With these demo recording 
* 64x 64 display with 256 colors (332 palette) and framebuffer can be used for saving and loading states. 
(double buffering). * Three image formats that help save memory: uncompressed color, 
* 25FPS. compressed color and monochromatic. 
* 7 buttons (arrows, A, B, C). * Auto conversion of color games to monochromatic for platforms 
* Simple 4x4 ASCII bitmap font. with 1bit displays. 


* Supported platforms (frontends): 


* Very simple interface and library with essential functions (e.g. LUT : , m 
e SDL2 (two versions: feature-rich and minimal) 


sin/cos etc.). 


e SAF is written in pure C99, depends on no libraries (not even stdlib), k CSFML (SFML binding for C) ! 
mostly works with only 8 bit integer values, so it is extremely e  Emscripten (web browser JavaScript) 
friendly to porting to any platform. XH ] 

* Single header in « 5 KLOC, self contained, well documented. i SA (terminal) 

. okitto 


e 32 bytes of persistent storage (for save/load). 

e Asounds to play. 

* Mainloop running at correct FPS is taken care of by SAF as well as 
other things like CLI parameter parsing, volume control, game 
controller support etc. With some frontends you get other features 
for free, e.g. time manipulation, pixel-art upscaling, input recording 
(allowing tool-assisted speedruns) etc. 


e  Arduboy 

e Gamebuino META 

* ESPBoy 

e  Circuitmess Nibble 

e  Circuitmess Ringo 

* unofficial experiment: TI80 calculator by themisch 
e Completely public domain, absolute legal freedom. 
SAF does not guarantee portability to all of its supported platforms as the program resource usage (memory, CPU, ...) isn't limited and the use 
of on ortable libraries isn't enforced. SAF is a tool that will help you achieve very high portability (along with other advantages) if you use it 
correctly. 


SAF game running on many hardware platforms: 

IMAGE 

Example of auto-converting a game from color to monochrome and applying pixel art upscaling: 
IMAGE 


Tutorial 
This explains the basics of creating a SAF game (or another program). It shows the typical and recommended process, however SAF doesn't 
enforce anything so it is up to you whether and to what degree you follow it. 


For programming in SAF you need to be familiar with basic C programming. SAF games are written in C (following a C99 or C89 standard is 
recommended for maximum portability). Even though C++ can also be used, it is not recommended because it's not as portable as C, its 
bloated nature goes against the philosophy of SAF and for simple programs its extra features are completely unnecessary anyway. 


Let's now write a simple "hello" program in SAF: 


Firstly we create a source file for the program, let's name it hello. c. In it we write the source: 


#define SAF PROGRAM NAME "hello" 
define SAF PLATFORM SDL2 


#include "saf.h" 


void SAF init(void) 


uint8 t SAF loop(void) 
SAF clearScreen(SAF COLOR WHITE); 


SAF drawText("HELLO!",4,15, 
SAF frame() & 0x04 ? SAF COLOR RED : SAF COLOR BLACK, 2); 


return 1; 


At the beginning we define some things for the SAF: SAF PROGRAM NAME tells SAF the name of our program (to e.g. show in the window 
title), SAF PLATFORM SDL2 tells it which frontend implementation to use, in this case SDL2 uod can try different ones). These values must be 
defined before including saf .h! There are also other optional settings you can set like this (they are documented in the saf .h file itself). 


Next we are required to implement two functions (this is similar to how Arduino works): SAF init in which we initialize our program (in our 
case we don't need any initialization so the function is left empty) and SAF. loop, a function that will be called by SAF once every game frame 
-- aues like the "main" body of our program. SAF automatically handles calling the loop function at the right FPS, so you don't have to deal 
with this. 


Note that we do not write the main function like in "normal" C program, that is implemented inside the SAF library. Of course, you can define 
any additional functions for your program besides these required two. 


It is recommended vou don't include anything else than saf .h, not even standard libraries such as stdio.h (there is one exception to which | 

will get). Including libraries decreases portability and introduces complexity, linking etc. If only a little possible, try to just use the functions 

that SAF offers. All of these functions are documented in the saf.h file itself. Now there is an exception: including simple "header only" 

tele that pee compiled separately and can be distributed along in source form are okay, so you can use these (just beware of their 
ependencies). 


Inside the loop function we just clear screen and write out some text using the functions that SAF provides. You can find all of these functions 
documented in the saf .h file itself. 


Now we have our program complete. The two files hello.c and saf .h together form a source code that can be compiled, and you compile it 
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the same way as you would any other SDL program (since we're using the SDL frontend). For example on GNU/Linux you may compile this 

program with gcc -o hello hello.c -lSDL2, then run it with ./hello. If you're using another system, camper or frontend, just look up 
ow to compile such program (brief details about compilation are mentioned under each platform section in saf .h). 

Congratulations, you should now have completed your first SAF program! 


There is one more pro tip for you: it may be more comfortable to write the game in a header file (.h), e.g. game.h instead of game.c, and 
without defining any SAF. PLATFORM ... in it: this will be a frontend neutral source file of your game. Then you can create files such 
as main sdl.c in which you simply define SAF. PLATFORM. SDL2 and then include game .h, and you will be compiling this C file to get the 
SDL frontend. For another platform, let's say Arduboy, you will create a similar file main arduboy.inoin which you similarly 
define SAF PLATFORM ARDUBOY and include game.h. And so on for each platform. But the organization of source code is ultimately up to 
you. 


Advice 

SAF doesn't enforce its recommendations, it relies on you not programming badly. This is a feature, not a bug. The following advice will help 
you make your programs portable, deterministic and with accordance to the spirit of SAF. Of course, it is only up to you whether you follow it or 
not. Hacking is a a valid option too. 


* Program in C (C99 or C89), not C++. Even if you think C++ is a good language, which it isn't, this library is for simple things and for these simpler is 
definitely better. It is best if you write in C99 subset of C++ (i.e. don't use C++ keywords as identifiers etc.) so that your code is C but can still be 
compiled as C++ as well (many platforms are based on C++). 

* Don't use libraries (not even the standard library) unless absolutely necessary, and if you do, it should follow the same rules as your program, 
including this one (i.e. the library should be a single header one, and shouldn't not use other libraries). Try to limit yourself to only including "saf.h". 

* Write your game in a single file if possible, it's just simpler and better to deal with one file. Having many source files may have some justification in 
huge projects and in projects composed of multiple compilation units, it makes sense to separate a general library from a game, but for a simple game 
there's no real reason to split the source even if it's 50k lines of code long, you can still open and edit the single file in multiple windows just like you 
would open multiple files. Just think about it, there's no reason for fragmenting your source. 

* Don't use what you don't need and keep it simple, e.g. if you don't need to use floating point (you don't), don't use it and rather stick to integers. If 
your game can work without the C button, don't use it (because e.g. Arduboy doesn't have it). If your game doesn't use sound, disable the functionality 
via the library macro. This is all for the sake of portability and indiscrimination. Program for the weakest platform (i.e. try to use 8 bit numbers, use as 
litle RAM as possible etc.). 

* Don't use platform-specific functionality. E.g. the Arduino's mi llis ( ) or PROGMEM. If you really really need to use it, use macros (tif defs) to 
only allow these on the specific platform. 

* Make your creation free as in freedom, preferably public domain under CCO, as is this project. Clearly state your license, it is best to be as clear as 
possible that you're applying a specific license to specific files you have created. By this you support sharing, hacking, improvement, education and 
other important things as others won't be afraid to reuse your game if they're clearly protected by your license. With public domain you're keeping the 
spirit of this library (but note that a simple "public domain" is not legally safe, use CCO). Of course, this decision is not and cannot be enforced, it is 
only up to you. 

* Optimize for the weakest platform you want to support. I.e. if you want your program to run on 8bits with tiny RAM, prefer 8bit data types and 
save as much RAM as possible, even if this means the program won't be optimal on faster platforms. The fast platform will be able to handle the cost, 
the slower one might not. 

* Watch out for undefined behavior and platform-defined behavior (such as bit shifts by more than the data type width etc.). This is an advice that 
applies basically to any C programming in general, but it is especially important for SAF as we're aiming for high portability. Tools like cppcheck and 
valgrind can help you spot these errors. 

* Keepit simple also legally. Prefer creating your own assets before using third party ones, it is very simple to create tiny pixel art and you won't have to 
deal with someone else's license, correct attributions etc. 


Usage Rights 

Everything in this repository is released under CCO 1.0 (public domain, https://creativecommons.org/publicdomain/zero/1.0/) + a waiver of all 
other IP rights (including patents and trademarks). 

l've written the code and created all the assets completely myself, from scratch. 


This project is made out of love and to be truly helpful to everyone, not for any self interest. | want it to forever stay completely in the public 
domain, not owned by anyone. 


This is not mandatory but please consider supporting free software and free culture by using free licenses and/or waivers. 
If you'd like to support me or just read something about me and my projects, visit my site: www.tastyfish.cz. 
The additional waiver of all IP rights follows: 


The intent of this waiver is to ensure that this work will never be encumbered by any exclusive intellectual property rights and will always be in 
the public domain world-wide, i.e. not putting any restrictions on its use. 


Each contributor to this work agrees that they waive any exclusive donis, including but not limited to copyright, patents, trademark, trade 
dress, industrial design, plant varieties and trade secrets, to any and all ideas, concepts, ae discoveries, improvements and inventions 
conceived, discovered, made, designed, researched or developed by the contributor either solely or jointly with others, which relate to this 
work or result from this work. Should any waiver of such right be judged legally invalid or ineffective under applicable law, the contributor 
Hate grants to each affected person a royalty-free, non transferable, non sublicensable, non exclusive, irrevocable and unconditional license 
to this right. 


saf.h 


#ifndef SAF_H Some attributes of the SAF console are: 
#define SAF_H 
- 64 x 64 pixels display 


Les - framebuffer 
@file saf.h - 256 colors, RGB332 palette 
- 25 FPS 
Small Abstract Fish (SAF) - 7 buttons 


- simple speaker | 
nna - Von Neumann architecture (single memory space for program and data) 
H H - no limit on resource usage (RAM, cycles, cores, ... 
H - behavior such as rasterization should be the same on all platforms (i.e. 
rasterization or circle is implemented internally rather than relying on 
the platform's circle rasterization) 


XXXX - without extensions, SAF programs should be deterministic 
Heal by drummyfish, 2021 
Simple interf f i ll tabl : ially f Released under CCO 1.0 (https://creativecommons.org/publicdomain/zero/1.0/) 
SPP etes But adeo the PC and ot er platforms. S pame Sn -especta ty Tor open plus a waiver of all other intellectual property. The goal of this work is 
e and remain completely in the public domain forever, available for any use 
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whatsoever. */ 


/* user settings, these can be redefined before including the library (platform 
specific settings are listed under each platform implementation tater): f 


#ifndef SAF SETTING FORCE 1BIT 
/** Forces monochrome (1 bit) graphics even on platforms that can display 
more 
than 2 colors. This can be good for testing how a color game would look like 
on 1 bit displays. */ 
#define SAF SETTING FORCE 1BIT 0 
#endif 


#ifndef SAF_SETTING_1BIT_DITHER 

Mh Sch Says if dithering should be used for monochrome (1 bit) platforms. 
ether 
to use dithering or not depends on each program, some look better with it, 
some don't. Dithering consumes significantly more CPU power.*/ 

" sderine SAF SETTING iBIT DITHER 0 
endi 


#ifndef SAF SETTING FASTER 1BIT 
/** If non-zero, the conversion of color to ibit (monochromatic) will be done 
with an approximation that is faster but gives a slightly different 
incorrect) result. 1 will set a mild approximation, 2 will set a faster one, 
a fastest one. This may be good for slow platforms. */ 
M pacing SAF_SETTING_FASTER_1BIT 1 
endi 


#ifndef SAF_SETTING_ENABLE_SOUND 
/** Can be used to disable sound at compile time. This is good to do if your 
game doesn't use any sounds so that the frontend doesn't have to 
unnecessarily manage sound libraries. Disabling sound may increase 
performance. */ 
#define SAF_SETTING_ENABLE_SOUND 1 

#endif 


#ifndef SAF_SETTING_ENABLE_SAVES 
i If 0, persistent memory for saves will be disabled so that saved data 
wl 
only last during the program run. Disabling saves for games that don't use 
them may help the compiler optimize the program and not include libraries it 
won't need. */ 
#define SAF SETTING ENABLE SAVES 1 
#endif 


#ifndef SAF_SETTING_BACKGROUND_COLOR 
/** Specifies the color that should be used as a background, e.g. on 
platforms 
that_have regions on screen where the game isn't drawn due to non-square 
resolution. */ 
#define SAF_SETTING_BACKGROUND_COLOR 0 
#endif 


#include <stdint.h> 


FOR PROGRAMS 


These are resources (functions, macros, 
client 

programs. If you are creating a program (a game etc.), only use these. A 

program is REQUIRED to implement: 


...) that are to be used by SAF 


ame -PROGRAM_NAME macro: this must be set to a string with the program's 
nam 


h {¢.9. #define SAF PROGRAM NAME "My game"). All version of the program 
snou 


i keer the same name as this name may be used e.g. to compute a hash that 
wl 
determine its save address in EEPROM. eden 
- SAF init function: in this function program should be initialized 
- SAF loop function: this function handles the main loop 


Before including saf.h a platform also needs to be specified by defining one 
of the possible SAF PLATFORM * macros. 


The program must NOT implement the main() function. */ 


// do NOT redefine these macros, they're read-only: 
#define SAF SCREEN WIDTH 64 
#define SAF SCREEN HEIGHT 64 


#define SAF FPS 25 ///« A divisor of 1000 prevents desync with RT. 
#define SAF SAVE SIZE 32 

#define SAF MS PER FRAME 1000 / SAF FPS) 
#define SAF VERSION STRING "1.0d" 

#define SAF BUTTON UP 0x00 
#define SAF BUTTON DOWN 0x01 
#define SAF BUTTON LEFT 0x02 
#define SAF BUTTON RIGHT 0x03 
#define SAF BUTTON A 0x04 
#define SAF BUTTON B 0x05 
#define SAF BUTTON C 0x06 
#define SAF BUTTONS x ///« number of buttons 
#define SAF COLOR BLACK 0x00 
#define SAF COLOR WHITE Oxff 
#define SAF COLOR GRAY 0x92 
#define SAF COLOR GRAY DARK 0x49 
#define SAF_COLOR_RED 0xe0 
#define SAF_COLOR_RED_DARK 0x80 
#define SAF_COLOR_GREEN Oxic 
#define SAF COLOR GREEN DARK 0x10 
#define SAF COLOR BLUE 0x03 
#define SAF COLOR BLUE DARK 0x01 
#define SAF COLOR YELLOW Oxf8 
#define SAF COLOR ORANGE Oxfo 
#define SAF COLOR BROWN O0x8d 


#define SAF COLOR RGB(r,g,b) (((r / 32) << 5) | ((g Z 32) << 2) | (b / 64)) 


#define SAF SOUND BEEP 0x00 ///« beep sound for special events 
#define SAF SOUND CLICK 0x01 ///« click sound, e.g. for menu 

define SAF SOUND BOOM 0x02 ///« boom sound, e.g. for shooting 
#define SAF SOUND BUMP 0x03 ///« bump sound, e.g. for hitting walls 
#define SAF SOUNDS 4 ///« number of sounds 

#define SAF TRANSFORM NONE 0x00 


#define SAF_TRANSFORM_ROTATE_90 0x01 
#define SAF_TRANSFORM_ROTATE_180 0x02 
#define SAF_TRANSFORM_ROTATE_270 0x03 


#define SAF_TRANSFORM_FLIP 0x04 ///< horizontal flip before rotation 
#define SAF_TRANSFORM_SCALE_2 0x08 

#define SAF_TRANSFORM_SCALE_3 0x10 

#define SAF TRANSFORM SCALE 4 0x18 

#define SAF TRANSFORM INVERT 0x20 ///« invert colors 


#define SAF INFO STRING \ . . 
"made with SAF (SmallAbstractFish) library v. " SAF VERSION STRING 


// these will potentially be redefined by each platform 
#define SAF PLATFORM NAME "platform" 

#define SAF PLATFORM COLOR COUNT 256 

#define SAF PLATFORM BUTTON COUNT 7 

#define SAF PLATFORM RAM 
#define SAF PLATFORM FREQUENCY 
#define SAF PLATFORM HAS SAVES 
#define SAF PLATFORM HAS SOUND 
#define SAF PLATFORM HARWARD 


ORROO 


///< Harward architecture 
#define SAF LOGO IMAGE Oxbee3c1938dcie3be ///« 8x8 1b logo as 64 bit int 


#ifndef SAF PROGRAM NAME 
WEE SAF PROGRAM NAME has to be defined before including the library. 
endi 


/** Implement this function in your program and put initialization code in it. 
Frontend will call this when the program starts to initialize it. 
void SAF init(void); 


/** Implement this function in your program and put main loop code inside it. 
This function will be called periodically SAF FPS times per second. When the 
function finishes, the framebuffer is presented to screen. The frame buffer 
is NOT cleared before this function is called. The function should return 
.non-zero if the program continues or 0 if the program has ended. */ 

uint8 t SAF Loop(void) ; 


/** Returns the number of frames for which a button has been continuously held, 
jue to 255. If button >= SAF BUTTONS, 0 will be returned. */ 
uint8_t SAF_buttonPressed(uint8_t button); 


/** Checks if the button has been pressed fact ly in the current frame. */ 
static inline uint8_t SAF_buttonJustPressed(uint8_t button); 


/** Plays given sound. */ 
void SAF_playSound(uint8_t sound); 


/** Saves a_byte of data to persistent storage (e.g. 5a file, cookie etc.). If 

i index >= SAF SAVE SIZE, nothing happens. WARNING: it may potentially be bad 

o 

b call this function extremely often as on some platforms the save memory may 

e 
Slow (disk) or prone to wearing off (EEPROM). The function tries to eliminate 
the writes, but you should also try to reduce the calls if possible. */ 

void SAF_save(uint8_t index, uint8_t data); 


/** Loads a byte from persistent storage (saved with SAF_save). If no data were 

E ever saved with SAF save at the index, is returned. 0 is always returned 

or 
index >= SAF SAVE SIZE. WARNING: The function keeps a cache of loaded values 
so that loading from the actual save memory only happens at most once per 
program run. * 

uint8 t SAF load(uint8 t index); 


/** Gets the number of frames from start of the program. */ 
static inline uint32 t SAF frame(void); 


/** Gets the time from start of the program in milliseconds. */ 
static inline uint32 t SAF time(void); 


/** Returns a simple pseudorandom number. The number sequence will be the same 
in each program run and will repeat after 256 calls. SAF randomSeed() can be 
called to seed this pseudorandom generator. */ 

uint8 t SAF random(void); 


/** Seeds the pseudorandom generator with an initial number. Numbers returned 
bY SAF_random depend on this value. The generator is automatically seeded 
wl 


© at the start of a program. */ 
static inline void SAF randomSeed(uint8 t seed); 


/** Computes sin function of the argument (295 corresponds to 2*pi, i.e. the 
full angle). Returns a value between -127 to 127 (including). */ 
int8 t SAF sin(uint8 t phase); 


int8 t SAF cos(uint8 t phase); 


/** Computes integer square root of a number. */ 
uinti6 t SAF sqrt(uint32 t number); 


/** Returns a 332 color closest to given RGB values. */ 
uint8 t SAF colorFromRGB(uint8 t red, uint8 t green, uint8 t blue); 


/** Converts 
aligns the 
true gray. : : : : 

Ypid if _colorTORGB(uint8_t colorIndex, uint8 t *red, uint8 t *green, uint8_t 

ue); 


iven 332 color to amount of red, green and blue. This conversion 
lue levels with red/green levels So that it is possible to get 


/** Converts given 332 color to an approximate 8bit grayscale value. Note that 
doing this per-pixel can negatively affect performance, in which case you may 
consider creating a lookup table using this function. */ 

static inline uint8 t SAF colorToGrayscàale(uint8 t colorIndex); 


/** Converts given 332 color to a 1 bit value (black&white). The result 
returned 


pelt either be © (black) or non-zero (white). The conversion performed by 

1s 
function is affected by SAF SETTING FASTER 1BIT. */ 

static inline uint8 t SAF colorToiBit(uint8 t colorIndex); 


/** Returns an "opposite" color of given 332 color. */ 

static inline uint8 t SAF colorInvert(uint8 t color); 

/** Sets a single pixel of the frame buffer to given color. */ 
void SAF drawPixel(int8 t x, int8 t y, uint8 t Color); 


/** Draws a rectangle. */ 
void SAF drawRect t9 t x, int8 t y, int8 t width, int8 t height, uint8 t 


t(in 
color, uint8 t filled); 


/** Draws a line using the DDA algorithm. */ 
void SAF drawLine(int8 t x1, int8 t y1, int8 t x2, int8 t y2, uint8 t color); 


/** Draws a circle. */ 
youd d)r-nnaweire e(int8 t x, int8 t y, uint8 t radius, uint8 t color, uint8 t 
illed); 


fate Clears the screen with given color, typically called before rendering a new 
rame. 
static inline void SAF clearScreen(uint8 t color); 


/** Draws given text with the built-in 4x4 font. */ 


int8 t SAF drawText(const char *text, int8 t x, int8 t y, uint8 t color 
uint8 t size); 


/** Gets the built-in character mask, in case you want to draw the font. 
, character yourself. The 4x4 character is returned as a 2 byte binary image. 


void SAF getFontCharacter(uint8 t asciilndex, uint8 t result[2]); 
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/** Draws an uncompressed 332 color image. Transformation can be applies by 
passing a bitwise or value or SAF TRANSFORM * values. 


The image format is following: ist byte unsigned width, 2nd byte is unsigned 
height, following bytes each hold the 332 color of pixels starting from top 
left of the image and going right and down. */ X 

void SAF drawImage(const uint8 t *image, int8 t x, int8 t y, uint8_t transform, 

uint8 t transparéntColor); 


/** Same as SAF drawImage but takes a compressed image as an input. This will 
most likely be slower than SAF drawImage but will Save -2/3 memory on images. 


E compressed format is both lossy (palette reduction) and lossless (RLE). 


is following: ist byte is unsigned width, 2nd byte is unsigned height, the 
b following 16 bytes are the image palette, then RLE bytes follow: eàch RLE 
yte 


specifies the palette color index in its lower 4 bits and the number of 
repetitions of that color in upper 4 bits (so e.g. value 0 means 1 pixel will 
be arawn): Images can be compressed to this format by tools that come with 
SAF. 
void SAF drawImageCompressed(const uint8 t *image, int8 t x, int8 t y, uint8 t 
transform, uint8 t transparentColor); 


/** Same as SAF drawImage but for 1bit (monochrome) images. Transparency mask 
(in the same format as the drawn image) can be used. 


The ibit image format is following: 1st byte is unsigned width, 2nd byte is 
unsigned height, following bytes encode bits if the image, each byte holds 
8 bits, MSB coming as 1st bit of the byte, going from top left of the image 
to the right and down. */ 1 . : i 
void SAF dràwImageiBit(const uint8 t *image, int8 t x, int8 t y, const uint8 t 
*mask, uint8 t colori, uint8 t color2, uint8 t transform); 


/** Converts integer to string. The string must have enough space allocated 
" (safe size is 12). The string will be zero terminated by the function. 
ointer 

identical to aa ea will be returned. */. 
char *SAF intToStr(int32 t number, char *string); 


/** Same as SAF intToStr but for floats. The safe allocated size for the string 
is 23. Maximum decimals in the result will be 10. */ : 
char *SAF_floatToStr(float number, char *string, uint8_t decimals); 


/** RESERVED for possible future implementation of extension via a text 
protocol, at the moment this function does nothing. 


The extension should work like this: the client program will send a string 
(call this function) and receive a string from the frontend (the return 
value). This may be exploited e.g. for network communication or file system 
operations. Empty string means an empty answer and will returned if the 

the extension is unsupported or similar cases. 


qhe string passed to the function can be dealocated or changed after the 
call, 


the frontend should make a copy if it needs it. */ 
const char *SAF_extension(const char *string); 


FOR FRONTENDS 


These functions are NOT to be used by SAF client programs, they are for 
frontend implementations, i.e. if you're adding a new platform support. A 
frontend is normally required to do the following (but see below): 


- Redefine some or all_of SAF_PLATFORM_* macros (e.g. the platform name, 
button count etc.). First undefine the macro and define again (to prevent 
warnings). 

- Sep lendnt the specific SAF FE * functions that are required to be 
implemented (see below); The functions mostly corres ond to the client 
functions (e.g. SAF drawPixel vs SAF FE drawPixel), but don't have to 
preform parameter checks. Call SAF FE init and SAF FE loop in the right 
places. The remaining SAF FE * functions are for the convenience of 
frontends that you may or may not_use as you wish. . 

- The frame buffer should be initialized to all zeros at the beginning of 

your 
frontend program. 
- Implement the main program body (e.g. the main() function or setup/loop 
h Arduino functions) and call SAF FE init and SAF FE loop. Frame buffer 
shou 
be presented to the screen after SAF FE loop finishes. Do NOT clear the 
frame buffer in main loop, the program is Supposed to do this. 

- Init the console's state, i.e. cleàr screen to all black, buttons states to 
0 etc. 

- Try to respect and take into account SAF SETTING * macros. 

- Try to make your global identifiers unlikely to collide with the user 
program, i.e. you may e.g. prefix them with ' '. 


When implementing a new frontend take a look at already implemented ones to 
see how it's done. 


Another way to implement a frontend is to use a part ly preimplemented PC 
stdlib generic frontend with advanced. For details look at 
SAF_FE_GENERIC_FRONTEND. */ 


//~~~ IMPLEMENT THE FOLLOWING ~~~ 


/** DO NOT USE_IN PROGRAMS, this is for frontends only! Programs should use 
SAF_drawPixel instead. 


Implement this function in your platform. 


Draws pixel to the screen back buffer, i.e. this shouldn't be visible on the 
pigga right after calling this function, but only when the screen is 
u 
by the frontend at the end of the frame. The coordinates passed are 
guaranteed to be from © to 63, therefore no bound check is needed to be 
performed by this function. */ . 3 
static inline void SAF FE drawPixel(uint8 t x, uint8 t y, uint8 t color); 


/** DO NOT USE IN PROGRAMS, this is for frontends only! Programs should use 
SAF playSound instead. 


Implement this function in your platform. */ 
static inline void SAF FE playSound(uint8 t sound); 


/** DO NOT USE IN PROGRAMS, this is for frontends only! Programs should use 
SAF save instead. 


Implement this function in your platform. 


This function should save given data byte to a specified address (index) in 
the persistent storage to last between HW resets. You can use e.g. files, 
;qookies or EEPROM to implement this memory. Index passed to this function 
wl 
always be « SAF SAVE SIZE. You don't have to implement any optimizations 
(e.g. buffers, ignoring overwrites of same values etc.) as SAF already does 
them internally. kd 
static inline void SAF FE save(uint8 t index, uint8 t data); 


/** DO NOT USE IN PROGRAMS, this is for frontends only! Programs should use 
SAF load instead. 


Implement this function in your platform. 


This function should load and return data byte from specified address (index) 
in the persistent storage. This data was saved with SAF FE save. If no 
data have ever been written to that memory address, © should be returned. 
Index passed to this function will always be « SAF SAVE SIZE. You don't have 
to implement any optimizations (e.g. buffers) as SAF already does this 
internally. */ 

static inline uint8 t SAF FE load(uint8 t index); 


/** DO NOT USE IN PROGRAMS, this is for frontends only! Programs should use 
SAF buttonPressed instead. 


Implement this function in your platform. 


This function should return a non-zero value if given button is pressed, or 0 
if the button is not pressed. The function will be called for each button 
exactly one per frame (so there is no need to worry about returning a : 
consistent value during a frame). Button number passed to this function will 
always be « SAF BUTTONS. */ 

static inline uint8 t SAF FE buttonPressed(uint8 t button); 


/* RESERVED, at this moment this function should always return an empty string 
(a pointer to value 0). */ 
static inline const char *SAF FE extension(const char *string); 


// ~~~ CALL THE FOLLOWING IN RIGHT PLACES ~~~ 

/** pO NOT USE IN PROGRAMS, this is for frontends only! 
In your platform implementation call this function once in SAF MS PER FRAME. 
This function calls the client program's SAF loop (don't call thas ,ornecely ys 


If this function returns 0, halt the program, otherwise continue. 
static inline uint8_t SAF FE loop(void); 


/** DO NOT USE IN PROGRAMS, this is for frontends only! 


In your platform implementation call this function at the start of the 
program. */ 
static inline void SAF_FE_init(void); 


// ~~~ FOR FRONTEND CONVENIENCE ~~~ 
/* The following macros can optinally be defined by your frontend: 
SAF_FE_GENERIC_FRONTEND enables a partly preimplemented generic frontend 


that uses stdio functions and has advanced 
features (screenshot taking, volume 


If this is defined, you don't have to implement 
SAF FE save, SAF FE load, SAF FE drawPixel, 

SAF FE buttonPressed, SAF FE extension and the 
main function, but you need to implement some 
other functions: see SAF FE GF * functions. This 


frontend also handles emscripten integration. 


control, ...). 


SAF FE STDIO SAVE LOAD includes the stdio.h library and implements 
SAF FE save and SAF FE load using stdio files (so 
you don't have to implement these). With | 
emscripten cookies are used instead of stdio 


files. */ 


char SAF FE emptyString[1] = {0}; 


#define _SAF_UNUSED(identifier) (void)(identifier) ///« for suppressing 
warnings 


the Returns a simple 16bit hash of given string, useful for e.g. determining 
e 


h Save location in EEPROM based on the program's name. If you need an 8bit 
ash, 


„just take the lower 8 bits of this hash. */ 
uint16_t SAF FE hashStr(const char *str); 


/** Parses CLI arguments of form '-x' or '-xN' (x and N poing chars): After 


calling, paramValues will hold the value of corresponding ags, e.g. if -s2 
was passed, paramValues['s'] will hold value '2'. If paràmeter wasn't 
present, 


the value will be 0. If the parameter was present without a value (-x), the 
value will be 1. */ . 
void SAF FE paramParse(int argc, char **argv, uint8 t paramValues[128]); 


/** Converts a 332 color to monochrome (abit) color, taking into account 
, Potential dithering. This function should be used by monochromatic platforms. 


static inline uint8 t SAF FE colorToiBit(uint8 t color, uint8 t x, uint8 t y); 


Ant Uses the pixel art scaling algorithm "scale2x" to expand a single pixel 
into 


four pixels depending on its neighbouring pixels. To scale whole screen use 
SAF FE scale2xScreen. */ 

void SAF FE scale2xPixel(uint8 t middle, uint8 t top, uint8 t right, 
uint8 t bottom, uint8 t left, uint8 t result[4]); 


Le Quickly Scales the whole SAF screen 4 times (twice in each dimention) using 
the smart "scale2x" pixel art scaling algorithm. 

void SAF_FE_scaleaxScreen( 
const uint8_t screen[SAF_SCREEN_WIDTH * SAF_SCREEN_HEIGHT], 
uint8 t result[SAF SCREEN WIDTH * SAF SCREEN HEIGHT * 4]); 


#define SAF FE SOUND SAMPLE COUNT 1024 


/** The function returns an 8 bit 8 KHz sample of a default built-in sound of 
this library, for implementing SAF FE playSound. If you're using custom 
external sounds or the platform's built-in beeps, don't use this. Each sound 
has SAF FE SOUND SAMPLE COUNT samples. * 

int8 t SAF FE getSoundSample(uint8 t sound, uinti6 t sampleNumber); 


/** If SAF FE GENERIC FRONTEND is defined, you need to implement this function 
in which you initialize your frontend. CLIParameters holds values of parsed 
command line arguments of format as returned by SAF FE paramParse. Certain 

mE (see generic frontend's help) are used by the generic frontend and 

S 

are guaranteed to hold only valid values when accessed (e.g. 's' will always 

have values '1' to '8'). Your frontend can use the rest of the flags as it 

wishes (to include these into help define SAF_FE_GF_EXTRA_HELP). * 

void SAF_FE_GF_init(uint8_t CLIParameters[128]); 


/** If SAF FE GENERIC FRONTEND is defined, you need to implement this function 
in which you free your allocated resources. This function will be called 
before the program exit. */ 

void SAF FE GF end(); 


/** If SAF FE GENERIC FRONTEND is defined, you need to implement this function 
in which you handle the main loop (only t ings that your frontend needs, the 
rest us handled by the generic frontend). CLIParameters is the same array as 
CLIParameters in SAF_FE_GF_init. The function should return a non-zero value 
if the program keeps running and 0 if the program has been exited (e.g. by 
closing the Window). A 
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uint8 t SAF FE GF loop(uint8 t params[128]); 
const uint8 t *SAF FE GF getScreenPointer(); 


/** If SAF FE GENERIC FRONTEND is defined, you need to implement this function 
in which you copy the passed screen datà into your frontend's screen. */ 
void SAF FE GF present 
const uint8 t screen[SAF SCREEN WIDTH * SAF SCREEN HEIGHT]); 


/** If SAF FE GENERIC FRONTEND is defined, you need to implement this function 
which should return a bool value indicating ne hen specific key board key As 
pressed or not. Lowercase letters ('a', " Sp represent letter keys, 

'U', 'D', 'L', 'R' represent arrow keys, Pet is escape, 'Xx', 'Y', CZ! are 
controller buttons. */ 

uint8 t SAF FE GF keyPressed(char keyChar); 


/** If SAF FE GENERIC FRONTEND is cerios vou need to implement this function 
which should do two things: Sleep (yield & Pu) for sleep s milliseconds, then 
return the current number of milliseconds (after the s veep) from the start of 
the program. */ 

uint32 t SAF FE GF sleep(uinti6 t sleepMs); 


/** If SAF FE GENERIC FRONTEND is defined, You need to implement this function 
which should behave the same as SAF FE | extension (at this moment should only 
return an empty string pointer).*/ 

const char *SA E GF “extension(const char *string); 


/// SAF palette as 565 values. 

#define SAF_FE_PALETTE_565 \ 

0,9,18, 31, 288, 297, 306, 319, 576, 585, 594, 607, 864, 873, 882, 895, 1152, 1161, 1170, 1183, V 
1440, 1449, 1458, 1471, 1728, 1737, 1746, 1759, 2016, 2025, 2034, 2047, 8192,8201,8210,N ” 
8223, 8480, 8489, 8498, 8511, 8768, 8777, 8786, 8799, 9056, 9065, 9074, 9087, 9344, 9353, V 
9362, 9375, 9632, 9641, 9650, 9663, 9920, 9929, 9938, 9951, 10208, 10217, 10226, 10239, S 
18432, 18441, 18450, 18463, 18720, 18729, 18738, 18751, 19008, 19017, 19026, 15039, 19296, N 
19305, 19314, 19327, 19584, 19593, 19602, 19615, 19872, 19881, 19890, 19903, 20160, 20169, N 
20178, 20191, 20448, 20457, 20466, 20479, 26624, 26633, 26642, 26655, 26912, 26921, 26930, N 
26943, 27200, 27209, 27218, 27231, 27488, 27491, 27506, 27519, 27116, 27185, 27194, 27807, X 
28064, 28073, 28082, 28095, 28352, 28361, 28370, 28383, 28640, 28649, 28658, 28671, 36864, N 
36873, 36882, 36895, 37152, 37161, 37170, 37183, 37440, 37449, 37458, 37471, 37728, 37737, \ 
37746, 37759, 38016, 38025, 38034, 38047, 38304, 38313, 38322, 38335, 38592, 38601, 38610, x 
38623, 38880, 38889, 38898, 38911, 45056, 45065, 45074, 45087, 45344, 45353, 45362, 45375, \ 
45632, 45641, 45650, 45663, 45920, 45929, 45938, 45951, 46208, 46217, 46226, 46239, 46496, \ 
46505, 46514, 46527, 46784, 46793, 46802, 46815, 47072, 47081, 47090, 47103, 55296, 55305, N 
55314, 55327, 55584, 55593, 55602, 55615, 55872, 55881, 55890, 55903, 56160, 56169, 56178, N 
56191, 56448, 56457, 56466, 56479, 56736, 56745, 56754, 56767, 57024, 57033, 57042, 57055, X 
57312, 57321, 57330, 57343, 63488, 63497, 63506, 63519, 63716, 63785, 63794, 63807, 64064, X 
64073, 64082, 64095, 64352, 64361, 64370, 64383, 64640, 64649, 64658, 64671, 64928, 64937, N 
64946, 64959, 65216, 65225, 65234, 65247, 65504, 65513, 65522, 65535 


= PLATFORM FRONTENDS 


sif defined(SAF PLATFORM SDL2) || defined(SAF PLATFORM SDL2 TINY) 
#include <SDL2/SDL.h> 
// code common to all SDL frontends 


uint8_t _SDL_volume = 0; 
int8 t _SDL_ CurrentSound = -1; 
uinti6 t _SDL_soundPosition = 0; 


sif SAF SETTING ENABLE SOUND 
void SAF SDL playSound(uint8 t sound) 
Seite ti a 
void SAF SDL audioFillCallback(void *userdata, uint8_t *s, int 1l) 
_SAF_UNUSED(userdata) ; 
inti6 t *s16 = (inti6 t *) s; 
i422» 
for (int i- 0; i« 1; ++i) 


if (.SDL currentSound < 0) 
*616 = 0; 
else 


*s16 = SAF FE getSoundSample( SDL currentSound, SDL soundPosition); 
_SDL_soundPosition++; 


if (_SDL_soundPosition >= SAF FE SOUND SAMPLE COUNT) 


_SDL_currentSound = -1; 
_SDL_soundPosition = 0; 


s16++; 


yinta_t SAF_SDL_initAudio(void) 
SDL AudioSpec audioSpec; 


SDL memset (&audioSpec sizeof(audioSpec 
audioSpec.callback = 


bar! SDL Sud ott TERT back; 
audioSpec.freq - 8000; 


audioSpec.format = AUDIO S16; 
audioSpec.channels - 1; 


#ifdef ^ EMSCRIPTEN . 
audioSpec.samples - 1024; 
#else 
audioSpec.samples = 256; 
#endif 


if (SDL_OpenAudio(&audioSpec,NULL) < 0) 
return 0; 


SDL PauseAudio(9); 
return 1; 
endif // SAF SETTING ENABLE SOUND 
#endif // SAF PLATFORM SDL2 || SAF PLATFORM SDL2 TINY 
#ifdef SAF PLATFORM NULL 
/* Null frontend, has no I/O implemented and runs at highest reachable FPS 


instead of SAF FPS. This can be useful for testing, e.g. if you want to see 
the compiled size or performance of just the game without any frontend. 


void SAF_FE_drawPixel(uint8_t x, uint8_t y, uint8_t color) 


_SAF_UNUSED(x); .SAF UNUSED(y); 
void SAF FE | uBtay ySound uint8_ t sound) 
_SAF_UNUSED( sound) ; 
void SAF FE . save(uint& t index, uint8 t data) 
.SAF UNUSED(index); _SAF_UNUSED(data); } 
uint8 t SAF FE load(uint8 t index) 
{ .SAF UNUSED(index); return 0; } 
uint8 t SAF FE _buttonPressed(uints_ t button) 
_SAF_UNUSED(button); return 0; 
const char *SAF FE _extension(const char *string) 
{ _SAF_UNUSED(string); return SAF_FE_emptyString; } 


_SAF_UNUSED(color); } 


int main(void) 


SAF_FE_init(); 
while (SAF_FE_loop()); 
return 0; 


} 


#elif defined(SAF_PLATFORM Sp?) 
/* SDL2 platform using the SAF_FE_GENERIC_FRONTEND, also usable with emscripten 
(browser Javascript). 


requirements: libsdl2-dev, stdio.h, unistd.h, stdlib.h 
compiling: link SDL2, e.g. -lSDL2 (emscripten: -s USE SDL-2) 


#undef SAF PLATFORM NAME 
#define SAF PLATFORM NAME "SDL2" 


#define SAF FE GENERIC FRONTEND 


#include <SDL2/SDL.h> 
#include <stdlib.h> // for malloc/free 
#include <unistd.h> // for usleep 


const uint8_t *_SDL_keyboardState; 


SDL_Window *_SDL_window; 

SDL_Renderer *_SDL_renderer; 

SDL_Texture *_SDL_texture; 

uint8_t _SDL. _pixelArtUpscale = = 0; 

uint8 t * SDL upscaleScreen = 0; 

SDL GameController * SDL controller 29; 


void SAF FE playSound(uint8 t sound) 
SAF SDL playSound(sound); 


void SAF FE GF init(uint8 t CLIParameters[128]) 


í SDL Init( 
SDL INÍT EVENTS | 

Hif SAF SETTING ENABLE SOUND 
SDL INIT AUDIO | 


#endif 
SDL INIT JOYSTICK); 
.SDL volume = CLIParameters['v'] - '0'; 


if (CLIParameters['u'] != 2E 
_SDL. . pixelArtUpscale = 1; 
_SDL_upscaleScreen = malloc (SAF SCREEN_WIDTH * SAF_SCREEN_WIDTH * 4); 


uint16_t screenScale = CLIParameters['s'] - '0'; 
uint8_t fullscreen = screenScale == 0; 
if (screenScale == 0) 


screenScale = 1; 


SDL window = SDL CreateWindow(SAF PROGRAM NAME, SDL WINDOWPOS UNDEFINED, 
SDL WINDOWPOS UNDEFINED, SAF SCREEN WIDTH * screenScale, 
SAF_SCREEN_HEIGHT * screenScale, SDL WINDOW SHOWN); 


if (fullscreen) 
SDL SetWindowFullscreen( SDL window,SDL WINDOW FULLSCREEN DESKTOP); 


_SDL_renderer = SDL CreateRenderer( SDL window, -1,0); 


.SDL texture - SDL CreateTexture( SDL renderer, 
SDL | PIXELFORMAT RGB332,SDL TEXTUREACCESS : STATIC, 
SAF SCREEN WIDTH * (_: SDL. _pixelArtU scale ? 2 : 
SAF SCREEN HEIGHT * ( SDL pixelArtUpscale ? 2 : 1h; 


SDL keyboardState - SDL GetKeyboardState(NULL); 


.SDL controller = SDL GameControllerOpen(90); 


SBL-PumpEvents(); 
SDL GameControllerUpdate(); 


sif SAF SETTING ENABLE SOUND 
if (!SAF SDL initAudio()) 
puts("SDL: could not initialize audio"); 
"bond 


void SAF FE GF end() 
if SAF SETTING ENABLE SOUND 
SDL -Paus studio (7 


SDL CloseAudio(); 
#endif 


if (_SDL_controller != 0) 
SDL GameControllerClose( SDL controller); 


SDL DestroyTexture( SDL texture); 
SDL DestroyRenderer( SDL _renderer); 
SDL_DestroyWindow(_SDL_window) ; 
if (_SDL_pixelArtUpscale) 

ieee: SDL_upscaleScreen) ; 

uint8 t SAF FE GF loop(uint8 t params[128]) 

.SDL volume = params['v'] - '0'; 
SDL Event event; 
while (SDL PollEvent(&event) 

if (event.type == SDL QUIT 

return 0; 


return 1; 
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void 
SAF FE GF present(const uint8 t screen[SAF SCREEN WIDTH * SAF SCREEN HEIGHT]) 


if ( SDL pixelArtUpscale) 


Sor-DEgscalexSereen(Screen -SDI üpscalesereeny; 
. SDL UpdateTexture( SDL texture,NULL, SDL upscaleScreen,SAF SCREEN WIDTH * 


H 


else 
SDL_UpdateTexture(_SDL_texture, NULL, screen, SAF SCREEN WIDTH); 


SDL RenderClear( SDL renderer); 
SDL RenderCopy( SDL renderer, ': SDL texture, NULL, NULL); 
SDL_RenderPresent(_SDL_renderer); 


H 
uint8 t SAF FE GF keyPressed(char keyChar) 


if (keyChar «- 'z' && keyChar »- 'a ve 
return _SDL_keyboardState[SDL_: SCAN ODE A + (keyChar - 'a')]; 


#define b(x) (( SDL controller != NULL) && N 
SDL GameControllerGetButton( SDL controller,SDL CONTROLLER BUTTON ## x)) 
Dm (keyChar ) 


case 'U': return 
.SDL keyboardState[SDL SCANCODE UP] || 
b(DPAD UP); 
break; 


case 'R': return 
.SDL keyboardState[SDL SCANCODE RIGHT] || 
b(DPAD RIGHT); 
break; 


case 'D': return 
,SDL keyboardState[SDL SCANCODE DOWN] || 
b(DPAD DOWN); 
break; 


case 'L': return 
.SDL keyboardState[SDL SCANCODE LEFT] || 
b(DPAD LEFT); 


break; 
case 'E': return Bre ~keyboardstate[SDL_ SCANCODE_ESCAPE]; break; 
case 'X': return ; break 
case 'Y': return b TOF break; 
case 'Z': return START); break; 
} default: return 0; break; 
#undef b 


uint32_t SAF FE GF sleep(uinti6 t sleepMs) 


if (sleepMs != 0) 
u$leep(sleepMs * 1000); 


return SDL GetTicks(); 


const char *SAF FE GF extension(const char *string) 


. SAF. UNUSED string) 
return SAF_FE_emp yétring; 


#elif defined(SAF_PLATFORM_SDL2_TINY) 

/* Minimal SDL2 frontend, this frontend does NOT work with Emscripten (use 
normal SDL2 platform for that). 
requirements: libsdl2-dev, stdio.h, stdlib.h 

compiling: link SDL2, e.g. -lSDL2 


unistd.h, 


#undef SAF PLATFORM NAME 
#define SAF PLATFORM NAME "SDL2 tiny" 


#define SAF FE STDIO SAVE LOAD 


#include <SDL2/SDL.h> 
#include <unistd.h> // for usleep 


#ifndef SAF SETTING SDL2 TINY SCALE 
3 aop Tine SAF_SETTING_SDL2_TINY_SCALE 4 
endi 


#define SDL UPSCALE 
#define SDL SCREEN WIDTH \ 

(SAF SCREEN WIDTH * SAF SETTING SDL2 TINY SCALE) 
#define SDL SCREEN HEIGHT \ 

(SAF SCREEN HEIGHT * SAF SETTING SDL2 TINY SCALE) 


const uint8 t * SDL keyboardState; 
uint8 t SDL screen[SDl SCREEN | WIDTH * SDL SCREEN HEIGHT]; 


void SAF FE drawPixel(uint8 t x, uint8 t y, uint8 t color) 
hir SAF SETTING SDL2 TINY SCALE == 

.SDL screen[y * SDL SCREEN WIDTH + x] = color; 
#else 

uint8_t *pixel = _SDL_screen + 


* (SDL SCREEN WIDTH * SAF SETTING SDL2 TINY SCALE) + 
X * S$AF SETTING SDL2 TINY SCALE; 


for (int y = 0; y « SAF SETTING SDL2 TINY SCALE; ++y) 
for (int x = 0; x « SAF SETTING SDL2 TINY SCALE; ++x) 


*pixel = 


D color; 
pixelt++; 


} pixel += SDL_SCREEN_WIDTH - SAF_SETTING_SDL2_TINY_SCALE; 
#endif 
H 


void SAF FE playSound(uint8 t sound) 
SAF SDL playSound(sound); 


vintect SAF_FE_buttonPressed(uint8_t button) 


switch (button) 


case SAF_BUTTON_UP: 
_SDL_keyboardState 
_SDL_keyboardState 
break; 


return 
SDL_SCANCODE_W 
SDL SCANCODE UP]; 


case SAF BUTTON DOWN: return 
.SDL keyboardState[SDL SCANCODE S 
.SDL keyboardState[SDL SCANCODE DOWN|; 
break; 


case SAF BUTTON LEFT: return 
.SDL keyboardState[SDL SCANCODE A 
-SDL keyboardState[SDL SCANCODE LEFT]; 
break; 


case SAF BUTTON RIGHT: return 
..SDL . keyboardState SDL SCANCODE D 
pSDL Keyboardstate SDL_SCANCODE_RIGHT]; 
reak; 


case SAF_BUTTON_A: retu 
_SDL_keyboardState SDL. . SCANCODE Y] 
—SDL keyboardState[SDL SCANCODE Z] 
_SDL_keyboardState[SDL_SCANCODE_J 
pebL,keyboardst tate[SDL SCANCODE SPACE]; 
reak; 


case SAF BUTTON B: return 

SDL keyboardState SDL SCANCODE X] 

SDL keyboardState[SDL SCANCODE K 

p3DL KeyboardState SDL SCANCODE RETURN]; 
reak; 


case SAF BUTTON C: return 
—SDL keyboardState[SDL SCANCODE C] 
.SDL keyboardState[SDL SCANCODE L]; 
break; 


default: return 0; break; 


} } 


static inline const char *SAF_FE_extension(const char *string) 


_SAF_UNUSED(string) ; 
return SAF_FE_emptyString; 


int main(int argc, char _**argv) 


{ uint8 t fullscreen = 0; 
.SDL volume = 8; 
if (argc > 1 && argv[1][0] == '-' && argv[1][2] == 0) 
if (argv[1][1] == 'f' 
TARRE T cto 
else i argv[1 == 'm' 
_SDL_vol Tune = = {a 
ae if (argv[1][1] = == 'h') 
puts SAF_ PROGRAM NAME ", " SAF . INFO: STRING " (" SAF PLATFORM NAME ")"); 
puts("-f - fullscreen, -m - mute" 
puts("controls: WSAD (arrows), JKL’ (XYZC), ESC = exit"); 
} return 0; 
} 
SDL Init( 


SDL INIT EVENTS | 

sif SAF SETTING ENABLE SOUND 
SDL INIT AUDIO | 

#endif 
SDL INIT JOYSTICK); 


SDL Window *window = SDL CreateWindow(SAF PROGRAM NAME, 
SDL WINDOWPOS UNDEFINED, SDL WINDOWPOS UNDEFINED, 
SDL SCREEN WIDTH, SDL . SCREEN | HEIGHT, SDL WINDOW | SHOWN) ; 


if (fullscreen) 


SDL SetWindowFullscreen(window,SDL WINDOW FULLSCREEN DESKTOP); 


SDL Renderer *renderer - SDL CreateRenderer(window, -1,0); 


SDL Texture *texture - 
SDL CreateTexture(renderer 
SDL PIXELFORMAT RGB332, SDL” TEXTUREACCESS_STATIC, 
SDL_SCREEN_WIDTH 
SDL_SCREEN_HEIGHT) ; 


_SDL_keyboardState = SDL GetKeyboardState(NULL); 


for (int i = 0; i < SDL_SCREEN_WIDTH * SDL_SCREEN_HEIGHT; 
_SDL_screen[i] = 0; 


SBL-PumpEvents(); 
SDL GameControllerUpdate(); 


sif SA ERE LING ENABLE SOUND 


if (!SAF SDL initAudio()) 
puts("SDL: could not initialize audio"); 
#endif 


SAF_FE_init(); 
uint32_t SAF_FE_GF_nextFrameTime = 0; 
while (1) 


// SDL_PumpEvents(); 
SDL_Event event; 


while (SDL_PollEvent(&event ) 
if (event.type == SDL_QUIT 
return 0; 


if ( SDL keyboardState[SDL SCANCODE ESCAPE]) 
break; 


uint32 t time - SDL GetTicks(); 
while (time »- SAF FE GF nextFrameTime) 


if (!SAF FE loop()) 
break; 


SAF FE GF nextFrameTime += SAF MS PER FRAME; 


SDL UpdateTexture(texture,NULL, SDL screen,SDL SCREEN WIDTH); 


SDL RenderClear(renderer); 
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SDL RenderCopy(renderer, texture, NULL, NULL) ; inti6 t samples[SAF FE SOUND SAMPLE COUNT]; 
SDL RenderPresent(renderer); 


for (int j = 0; j < SAF_SOUNDS; ++j 
usleep(((SAF FE. GF nextFrameTime - time) * 3 / 4) * 1000); // relieve CPU or (ios =ar] i Pj) 
H for (int i = 0; i < SAF FE SOUND SAMPLE COUNT; ++i) 
y samples[i] = ((int16_t) SAF_FE -getSoundSampte(j, 1)) << 7; 
Hif SAF SETTING ENABLE SOUND 


SDL-eloseAudint]]! —CSPML soundstil s = sfSoundBuffer _createFromsamples( 
; 


SDL CloseAudio samples, SAF_| SOUND_SAMPLE_COUNT, 1, 8000); 
#endif 


SDL_DestroyTexture(texture); #endif 
SDL_DestroyRenderer (renderer); } 
SDL DestroyWindow(window); 


void SAF FE GF end() 


{ 

#if SAF_SETTING_ENABLE_SOUND 
elif defined(SAF PLATFORM CSFML) sfSound destroy( CSFML sound); 
/* CSFML (C binding for SFML) platform with SAF FE GENERIC FRONTEND. 


return 0; 


for (int i = 0; i < SAF SOUNDS; ++i) 
requirements: libscfml-dev i i SfSoundBuffer  destroy( | CSFML_ _sounds[i]); 
com mpi ling: DK CSFML, usually -lcsfml-graphics -lcsfml-window -lcsfml-system #endif 
csfml-audio 


Qui add EE IM M ey ays KM CEU A USE sfClock destroy (— CSFML clock); 
sfRenderWindow | CESPME .CSFML window 
sfSprite destroy( CSFML -windowSprite): 

#undef SAF PLATFORM NAME sfTexture destroy( CSFML _windowTexture) 


#define SAF_PLATFORM_NAME "CSFML" 
if (_CSFML_SDL_pixelArtUpscale) 


#define SAF_FE_GENERIC_FRONTEND } free(_CSFML_upscaledScreen) ; 
#include <SFML/Audio.h> : 
#include <SFML/Graphics.h> uint8 t SAF FE GF loop(uint8 t params[128]) 
#include <SFML/System.h> 
#include <SFML/Audio/Types.h> sfEvent event; 
#include <stdio.h> 
#include <stdlib.h> // for malloc/free while (sfRenderWindow_pollEvent (_CSFML_window, &event)); 
sfClock *_CSFML_clock; if (!sfRenderWindow isOpen( CSFML windo 
sfRenderwindow* ~CSEML. . Window; 2 LALSTR 0 indow-isOpen(.. -window)) 
sfTexture* | CSFML windowTexture; 
sfSprite* _CSFML_windowSprite; #if SAF_SETTING_ENABLE_SOUND 

int v = params['v'] - '0' 


uint8 t _CSFML_screenSize = SAF SCREEN WIDTH; 
s . if (_CSFML_previousVolume !- v) 
uint8 t _CSFML_SDL_pixelArtUpscale = 0; 
uint8_t *_CSFML_upscaledScreen = 0; sfSound. setvolume(- CSFML. Sound, (v * 100) / 8) 
_CSFML_previousVo lume = v; 


#if SAF_SETTING_ENABLE_SOUND Ti. 

sfSound * CSFML sound; #endif 

sfSoundBuffer * CSFML' _sounds [SAF SOUNDS]; 

uint8_t _CSFML_previousVolume = 0; return 1; 
#endif 
uint32_t _CSFML_windowPixels[SAF_SCREEN_WIDTH * SAF_SCREEN_HEIGHT * 4]; void SAF_FE_GF_present 
uint32_t _CSFML_paletteRGB32[256]; // SFML can't do 332, so precompute RGB here ( const uint8 t screen[SAF SCREEN WIDTH * SAF SCREEN HEIGHT]) 

i i const uint8 t *pixel - screen; 
Co SAF_FE_playSound(uint8_t sound) uint32_t *pixel2 = CSFML _windowPixels; 
#if SAF_SETTING_ENABLE_SOUND i 

sfSound setBuffer( CSFML sound, CSFML sounds[sound]); if ( .CSFML SDL pixelArtUpscale) 

sfSound play( CSFML sound); 
#else SAF FE scale2xScreen(screen, CSFML upscaledScreen); 
y moai- UNUSED (sound); } pixel = _CSFML_upscaledScreen; 

endi 


} 


for (int i = 0; i < CSFML screenSize * _CSFML_screenSize; ++i) 
void SAF FE GF init(uint8 t CLIParameters[128] ) 


*pixel2 = _CSFML_paletteRGB32[*pixel]; 


for (int i = 0; i < 256; ++i) // precompute RGB palette pixelt++; 
pixel2++; 
uint8_t r,g,b; 
SAF colorToRGB(i,&r,&g,&b); sfTexture updateFromPixels( CSFML windowTexture 
(const sfUint8 *)  CSFML windowPixels, 
wr E IRTE S Weed | (((uint32 t) b) «« 16) | —CSFML screenSizé, CSFML screenSize,0,0); 
uint32 t) g) «« 8 E> 
} ^ sfRenderWindow drawSprite( CSFML window, CSFML windowSprite, NULL) 
sfRenderWindow display(. CSFML window); 
if (CLIParameters['u'] != 0) } 
_CSFML_SDL_pixelArtUpscale = uint8_t SAF FE GF keyPressed(char keyChar ) 
_CSFML_upscaledScreen = ma Loc {SAF SCREEN_WIDTH * SAF_SCREEN_WIDTH * 4); { 
“CSFML_screenSize *- 2; if (keyChar <= 'z' && keyChar >= 'a') 


return sfKeyboard isKeyPressed(sfKeyA + (keyChar - 'a')); 


for (int i = 0; i« CSFML screenSize * _CSFML_screenSize; ++i) #define k(x) sfKeyboard isKeyPressed(sfKey ## x) 
_CSFML_windowPixels[i] = 0; 


CSFML clock = sfClock create(); Switch q KeyChar) 


SfClock restart( CSFML clock); case 'U': 
D return k(Up) || (sfJoystick getAxisPosition(0,sfJoystickY) «- -50); 
uinti16 t screenScale = CLIParameters['s'] - '0'; break; 
uint8 t fullscreen - screenScale -- 0; case 'D' 
return k(Down) || (sfJoystick getAxisPosition(0,sfJoystickY) >= 50); 
_CSFML_windowTexture = sfTexture create( CSFML screenSize, break; 
.CSFML screenSize); 
case 'L': . ; "e 
sfTexture setSmooth( CSFML windowTexture, sfFalse); perurn k(Left) || (sfJoystick getAxisPosition(0,sfJoystickX) <= -50) 
; 
.CSFML windowSprite = sfSprite create(); case 'R' 
sfVideoMode mode = ( CSFML screenSize, _CSFML_screenSize, 32); return (Right) Ul: CSfJoystick-gerAxisPositlon(GrsTJoyStICkX) o 9) 
i 
_CSFML_window = sfRenderWindow create(mode, SAF PROGRAM NAME, 
fullscreen ? sfFullscreen : (sfResize | SfClose ), NULL); gase EE return KDC aps ek Dren resse 0,0 
2E StJo/stick isBUttonPressed 9,3); break; 
sfVector2i winPos; case 'Y': return sfJoystick isButtonPressed(0,1); break; 
winPos.x - 1; case 'Z': return sfJoystick isButtonPressed 9, 2); break; 
winPos.y - 1; 
A "E A A default: break; 
sfWindow_setPosition(_CSFML_window, winPos) ; } 
sfSprite setTexture( CSFML windowSprite, CSFML_windowTexture, sfTrue) ; #undef k 
sfWindow setVerticalSyncEnabled((sfWindow *) | CSFML window,sfFalse); return 0; 
if (screenScale != 0) 
sfVector2u winSize; pO SAF FE GF sleep(uinti6 t sleepMs) 
winSize.x - ~CSFML_ screenSize * screenScale; sfTime t; 
winSize.y = winSize.x; | ee t. mico erona. = sleepMs * 1000; 
sfWindow_setSize(_CSFML_window, winSize); sfSleep (&i 
H } return PM Lock __getElapsedTime(_CSFML_clock).microseconds / 1000; 
#if SAF_SETTING_ENABLE_SOUND 
—CSFML sound = sfSound create(); const char *SAF_FE_GF_extension(const char *string) 
_SAF_| string); 
SAF_UNUSED(stri 
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return SAF FE emptyString; 


#elif defined(SAF PLATFORM POKITTO) 
/* Pokitto platform using the official PokittoLib. 


requirements: PokittoLib 
compiling: as any other pokitto program, leave My settings.h empty 


#ifndef SAF SETTING POKITTO SCALE 
#define SAF SETTING POKITTO SCALE © /**« type of screen scale for Pokitto, 
possible values: 0 (176x176), 1 
(128x128), 2 (220x176) */ 
#endif 


#ifndef SAF_SETTING_POKITTO_VOLUME 
Fe woctine SAF_SETTING_POKITTO_VOLUME 4 //< 1 to 8 volume (if sound is on) 
endi 


#ifndef SAF SETTING POKITTO JOYHAT 
» wactine SAF_SETTING_POKITTO_JOYHAT 0 
endi 


#undef SAF PLATFORM NAME r 
#define SAF_PLATFORM_NAME "Pokitto" 


#undef SAF_PLATFORM_RAM 
#define SAF_PLATFORM_RAM 36000 


#undef SAF_PLATFORM_FREQUENCY 
#define SAF PLATFORM FREQUENCY ((_OSCT !- 2) ? 48000000 : 72000000) 


#include "Pokitto.h" 
#include "POKITTO HW/HWLCD.h" 
include "POKITTO CORE/PokittoCookie.h" 


#if SAF SETTING ENABLE SOUND 
#include "POKITTO HW/HWSound.h" 
#include "POKITTO HW/clock 11u6x.h" 
sane IUe "POKITTO HW/timer 11u6x.h" 
#endi 


#if SAF_SETTING_POKITTO_JOYHAT 
#include "JoyHat/JoyHat.h" 


JoyHat pokittoJoy; 


uinti6 t pokittoAxisThreshold1,  pokittoAxisThreshold2; 
uinti6- t pokittoRumbleCooldown - 0; 
#endi 


uint8_t *pokittoScreen; 


static const uinti6 t pokittoPalette[256] = // 332 palette in 565 format 
SAF_FE_PALETTE_565 


3; 


#define CUSTOM SCREEN BUFFER \ 
(PROJ SCREENBUFFERSIZE « SAF SCREEN WIDTH * SAF SCREEN HEIGHT) 


#if CUSTOM SCREEN BUFFER 

// if PokittoLib doesn't have large enough screen buffer, we create our own: 
unter pokittoScreenBuffer[SAF SCREEN WIDTH * SAF : SCREEN | HEIGHT]; 

#endi 


#if SAF SETTING ENABLE SAVES 
Class SaveCookie: public Pokitto::Cookie 


public: 
uint8 t data[SAF SAVE SIZE]; 


; 
SaveCookie pokittoSave; 
#endif 


#if SAF_SETTING_ENABLE_SOUND 
int8_t pokittoCurrentSound = -1; 
uinti6 t pokittoSoundPos = 0; 


void pokittoOnTimer() // for sound 
if (Chip_TIMER_MatchPending(LPC_TIMER32_0,1)) 
Chip_TIMER_ClearMatch(LPC_TIMER32_0, 1); 


if (pokittoCurrentSound >= 0) 


Pokitto: : dac. napas A ra FE -gatSgundsamp re (pokittocurrentsound, 
pokittoSoundPos) >> AF SETTING POKITTO VOLUME) 
& (Oxff >> (8 - SAF ferre POKITTO VOLUME)))); 


pokittoSoundPos++; 


if (pokittoSoundPos >= SAF FE SOUND SAMPLE COUNT) 


pokittoCurrentSound - -1; 
pokittoSoundPos - 0; 


3 
3 
3 


D pokittoTimerInit(uint32 t samplingRate) 


Chip TIMER Init(LPC TIMER32 0 
Chip TIMER Reset(LPC TIMER32 0); 
Chip. TIMER P M TÍMERS2 0, 1); 
Chip TIMER SetMatch(LPC TIMER32 
(Chip. Clock GetS Stenc lockfste( 7 samplingRate)); 
Chip TIMER ResetOnMatchEnable(LPC TIMER32 0, 1); 
Chip TIMER Enable(LPC TIMER32 9); 


#define weirdNumber ((IRQn_ Rude?) 18) 
rcceecut eonun weirdNum 

NVIC SetVector(weirdNumber (uinthà t) &pokittoOnTimer); 
NVIC EnableIRQ(weirdNumber]); 

#undef weirdNumber 


} 
#endif // if SAF SETTING ENABLE SOUND 


void SAF FE drawPixel(uint8 t x, uint8 t y, uint8 t color) 


if SAF SETTING POKITTO JOYHAT 
, pokittoscreen[x * SAF SCREEN WIDTH + (SAF SCREEN HEIGHT - 1 - y)] = color; 
i-i 


pokittoScreen[y * SAF SCREEN WIDTH * x] - color; 
#endif 


} 


void SAF_FE_playSound(uint8_t sound) 


{ 
#if SAF_SETTING_ENABLE_SOUND 
pokittoCurrentSound = sound; 


sif SAF SETTING POKITTO JOYHAT 
if (sound -- SAF SOUND BOOM && pokittoRumbleCooldown -- 0) 


pokittoJoy. Rumb te o 9251 
pokittoRumbleCooldown = 


endif 
#else 

SAF _UNUSED(sound) ; 
#endif 


void SAF_FE_save(uint8_t index, uint8_t data) 


{ 

#if SAF_SETTING_ENABLE_SAVES 
pokittoSave.data[index] = data; 
pokittoSave.saveCookie(); 


sif SAF SETTING | ENABLE : SOUND 

// PokittoLib bu saving disables timer, so re-enable it: 
à porittoTimerInit 8000); 

endi 


#else 
_SAF_UNUSED index); 
LSAF UNUSED( data); 
sendite 


uint8_t SAF_FE_load(uint8_t index) 


{ 
#if SAF_SETTING_ENABLE_SAVES 
return pokittoSave.data[index]; 
#else ! 
_SAF_UNUSED( index); 
return 0; 
#endif 


H 

uint8 t SAF FE buttonPressed(uint8 t button) 
switch (button) 

Be Er eee AE Vlen poki 


case SAF BUTTON RIGHT: return Poki 
case SAF BUTTON DOWN: return Poki 


::Core::upBtn(); break; 
m ww break; 


Cor de BERI break; 


case SAF BUTTON LEFT: return Pokit Cor leftBtn(); break; 
case SAF BUTTON , return Pokit Cor aBtn reak; 
case SAF BUTTON | return Poki Cor bBtn(); break; 
1 case SAF BUTTON C: return Poki :Core: :cBtn( ) ; break; 
#else 


case SAF BUTTON UP: return Pokitto::Core::rightBtn() || 
peat Eodeys Joyx() < pokittoAxisThresho dij; 
rea 


case SAF BUTTON RIGHT: return Pokitto::Core::downBtn() || 
SPORE EcoJoy: JoyY() » pokittoAxisThreshold2); 
rea 


case SAF BUTTON DOWN: return Pokitto::Core::leftBtn() || 
pois Fadoy., JoyX() » pokittoAxisThreshold2); 
rea 


case SAF BUTTON LEFT: return Pokitto::Core::upBtn() || 
SEEELEROJOY, JoyY() « pokittoAxisThresho di); 
rea 


case SAF BUTTON A: 
return Pokitto::Core::aBtn() || pokittoJoy.Button1(); break; 


case SAF BUTTON B: 
return Pokitto::Core::bBtn() || pokittoJoy.Button2(); break; 


case SAF BUTTON C: 
#endif 
default: return 0; break; 


return Pokitto::Core::cBtn(); break; 


ipd AXIS THRES 


static inline const char *SAF FE extension(const char *string) 


return SAF FE emptyString; 


sif SAF SETTING POKITTO SCALE == | SAF SETTING POKITTO SCALE -- 
static const uint8 t upscaleMap[176 


0,0,0,1,1,1,2,2,2,3,3,3,4,4,5,5,5,6,6,6,7, 7, 7,8,8,9,9, 9, 10, 10, 10, 11, 11, 11, 12, 


12,13, 13, 13, 14, 14, 14, 15, 15, 15, 16, 16, 17, 17, 17, 18, 18, 18, 19, 19, 19, 20, 20, 21, 21, 21, 
22,22,22,23,23,23,24,24,25,25,25,26,26,26,27,27,27,28,28,29, 29, 29, 30, 30, 30, 31, 
31,31, 32, 32, 33, 33, 33, 34, 34, 34, 35, 35, 35, 36, 36, 37, 37, 37, 38, 38, 38, 39, 39, 39, 40, 40, 
41, 41, 41, 42, 42, 42, 43, 43, 43, 44, 44, 45, 45, 45, 46, 46, 46, 47, 47, 47, 48, 48, 49, 49, 49, 50, 


50, 50, 51, 51, 51, 52, 52, 53, 53, 53, 54, 54, 54, 55, 55, 55, 56, 56, 57,57, 57,58, 58, 58, 59, 59, 
59, 60, 60, 61, 61, 61, 62, 62, 62, 63, 63 


endif 
#if SAF_SETTING_POKITTO_SCALE == 2 
static const uint8_t upscaleMap2[220] = 
0,0,0,0,1,1,1,2,2,2,2,3,3,3,4,4,4,4,5,5,5,6,6,6,6,7,7,7,8,8,8,9,9,9,9,10,10, 
10, 11, 11, 11, 11, 12, 12, 12, 13, 13, 13, 13, 14, 14, 14, 15, 15, 15, 16, 16, 16, 16, 17, 17, 17, 18, 
18, 18, 18, 19, 19, 19, 20, 20, 20, 20, 21, 21, 21, 22, 22, 22, 22, 23, 23, 23, 24, 24, 24, 25, 25, 25, 
25,26, 26, 26, 27, 27, 27, 27, 28, 28, 28, 29, 29, 29, 29, 30, 30, 30, 31, 31, 31, 32, 32, 32, 32, 33, 
33, 33, 34, 34, 34, 34, 35, 35, 35, 36, 36, 36, 36, 37, 37, 37, 38, 38, 38, 38, 39, 39, 39, 40, 40, 40, 
41, 41, 41, 41, 42, 42, 42, 43, 43, 43, 43, 44, 44, 44, 45, 45, 45, 45, 46, 46, 46, 47, 47, 47, 48, 48, 
48, 48, 49, 49, 49, 50, 50, 50, 50, 51, 51, 51, 52, 52, 52, 52, 53, 53, 53, 54, 54, 54, 54,55, 55,55, 


56, 56, 56, 57, 57, 57, 57, 58, 58, 58, 59, 59, 59, 59, 60, 60, 60, 61, 61, 61, 61, 62, 62, 62, 63, 63, 
63 


linair 


int main() 
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{ 

#if SAF SETTING ENABLE SAVES 
pokittoSave.begin( 

" are SAF PROGRAM NAME, sizeof(pokittoSave),(char*) &pokittoSave); 
endi 


Pokitto::Core: :begin(); 


#if SAF SETTING ENABLE SOUND 
pokittoTimerInit(8000); 
#endif 


#if CUSTOM SCREEN BUFFER 

à okittoScreen - pokittoScreenBuffer; 
else 
pokittoScreen = Pokitto::Display::screenbuffer; 

#endif 


Pok iito :Core: ;setFrameRate(SAF - FPS); 
Pokitt HDisplay: :persistence = 1; 
Pokitto::Display: :setInvisibleColor(- 1); 


for (uinti6 Yx 9! < 176; ++y) 
for (Uintió 9; Ped 259; ++x) 
Pokitto: ee COME ane 
pokittoPalette[SAF SETTING BACKGROUND COLOR]); 


sif SAF SETTING POKITTO JOYHAT 

pokittoAxisThresholdi - pokittoJoy.joyScale / 4; 

pok ittoAxisThresholda = pokittoJoy.joyScale - pokittoAxisThresholdi; 
#endi 


SAF_FE_init(); 
uint32_t nextFrame = 0; 


while (Pokitto::Core::isRunning()) 


Pokitto::Core: :update(true); 


Hif SAF SETTING POKITTO JOYHAT 
if KEETA A > 0) 
ittoRumbleCooldown--; 
#endif” 


uint32 t time = Pokitto::Core::getTime(); 
// we handle FPS ourselves as Pokittolib has a bug 


if (time >= nextFrame) 
while (time >= nextFrame) 


SAF FE loop() 
nextFrame += ÉAF. MS PER FRAME; 


const uint8 t *p - pokittoScreen; 


#if SAF SETTING POKITTO SCALE == || SAF SETTING POKITTO SCALE -- 
// 176x176, 220x176 


sif SAF SETTING POKITTO SCALE == 
#define SCR W 176 
define SCR X 22 
#else 
#define SCR W 220 
#define SCR_X 0 
#endif 
uinti6 t line[SCR W]; 
uint8 t previousLine = 255; 


for (int16 t j = 0; j « 176; **j) 
inti6 t upscaleMapRow = upscaleMap[j]; 


if (previousLine != upscaleMapRow) 


const uint8 t *l = pokittoScreen + SAF SCREEN WIDTH * upscaleMapRow; 


uinti6 t *1l = line; 

const uint8 t *m = 

sif SAF SETTING POKITTO SCALE == 0 
upscaleMap; 

else 


upseateMap2; 
#endif 


for (inti6 t i = 0; i < SCRW; ++i) 
uint16_ t c = pokittoPalette[*(l + *m)]; 


} } 


previousLine = upscaleMapRow; 


Pokitto::setDRAMpoint(SCR X, addi 
Pokitto: :pumpDRAMdata( line, SCR W); 


#elif bag SETTING_POKITTO_SCALE == 1 // 128x128 


uint16_t Line [SAF | SCREEN_WIDTH * 2]; 
inti6 t yPos = 24; 


for (inti6 t j = 0; j « SAF SCREEN WIDTH * 2; j += 2) 
uinti6 t *l = line; 
id (inti6 t i = 0; i < SAF SCREEN WIDTH; ++i) 


yint16_ t c = pokittoPalette[*p]; 
= €; 


Pokitto: :setDRAMpoint (46, yi n 
Pokitto: :pumpDRAMdata he SAL SCREEN | WIDTH * 2); 


yPos++; 


Pokitto: :setDRAMpoint (46, yPos); 
Pokitto: :pumpDRAMdata( line, SAF SCREEN WIDTH * 2); 


yPos++; 


sendir! 


3 
3 


return 0; 


#elif defined(SAF_PLATFORM_NCURSES 


/* ncuses (terminal, text-based) Bat oris this does not offer a "full" 
experience as terminal real time I/O handling and image displaying are 


limited, but some games are playable 


requirements: libncurses-dev, sys/time.h, stdio 
compiling: link ncurses, e.g. -lncurses 


#define SAF_FE_STDIO_SAVE_LOAD 


#undef SAF_PLATFORM_NAME 
#define SAF_PLATFORM_NAME "ncurses" 


#undef SAF_PLATFORM_COLOR_COUNT 
#define SAF_PLATFORM_COLOR_COUNT 2 


#include <ncurses.h> 
#include <sys/time.h> 
#include <stdio.h> // for files 


#define OFFSET_X 1 
#define OFFSET_Y 1 


uint8_t ncScreen[SAF_SCREEN_WIDTH * SAF_SCREEN_HEIGHT]; 
uint8_t ncButtonStates[SAF_BUTTONS]; 


uint8_t ncCurrentSound = 0; 
uint32_t ncSoundEnd = 0; 


uint32 t ncGetTime() 
struct timeval now; 


ger timeo Ry (enw, NULL i 
return now.tv_sec * 1000 + now.tv_usec / 1000; 


void SAF_FE_drawPixel(uint8_t x, uint8_t y, uint8_t color) 
ncScreen[y * SAF SCREEN WIDTH + x] = color; 


void SAF_FE_playSound(uint8_t sound) 


ncCurrentSound = sound; 
ncSoundEnd - ncGetTime() * 1000; 


uint8 t SAF FE buttonPressed(uint8 t button) 


return ncButtonStates[button]; 


const char *SAF FE extension(const char *string) 
return SAF FE emptyString; 


yoid printHelp(void) 
f puts(gae. PROGRAM_NAME 
" SAF_INFO_STRING " (" SAF_PLATFORM_NAME ")" A 
"An controls: WSAD arrows, JKL YZXC space, Q - quit" 
"\n possible arguments: -h (help), -i (invert colors)" 
; 
H 
rake main(int argc, char **argv) 
int invert = 0; 
for (int i= IO i< anges a ++i) 
if (argv[i == ' 
argv[i = o && 
argv[i 0) 
switch (argv[i][1]) 
case 'h': ert n return 0; break; 


case 'i': invert 
default: break; 


H 
H 
for PERDE i= 9; F < SAF_SCREEN_WIDTH * SAF_SCREEN_HEIGHT; 
creen[i] = 0; 
initscr( 


hatfdels 
keypad(s 


sig TRUE); 

noecho 
curs se (o); 
SAF FE init(); 
uint32 t nextFrame - ncGetTime(); 
char co = ' ', cO1 = ',', c10 = 'N'', cdd = ';'.5; 
if (invert) 

c00.— pF COL 2 N'' E610 2 "P5 C13 — ^ 5j 


while (1) 


for (int i = 0; i < SAF _ BUTTONS; ++i) 
nc uttonstatésli] = 


int c = getch(); 
int goOn = 1; 
switch (c) 


case KEY UP: case 'w': 
ReBüttonStates|SAP.. BUTTON UP] = 1; break; 


case KEY LEFT: case 'a': 
ncButtonStates[SAF BUTTON LEFT] = 1; break; 


case KEY RIGHT: case 'd': 
ncButtonStates[SAF BUTTON RIGHT] - 1; break; 
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++i) 


case KEY DOWN: case 's': 
ncButtonStates[SAF BUTTON DOWN] 


case ' ': case 


case 'z' 


cas 


- 1; break; 


e" 


ReButtanStates|sAF | BUTTON À] = 21; d cup 


case 'x': case 'k' 
ncButtonStates[SAF BUTTON B] - 


case 'c': case 'l' 


ncButtonStates[SAF BUTTON C] 


case "q': 


goOn = 0; break; 


default: break; 


} 


uint32 t time = ncGetTime(); 


while (time »- nextFrame) 


if 


(!SAF FE loop()) 


oon = 0; 
reak; 


nextFrame += SAF MS PER FRAME; 


if ( 


!goOn) 


break; 


/* One terminal character will correspond: to_two_ pixels vertically nexto 
i 


to each other, so we'll be scanning two 


const uint8_t* scr = ncScreen; 
const uint8_t* scr2 = ncScreen + SAF_SCREEN_WIDTH; 


erase(); 


move 


for 
ad 


for 


ad 
fo 


H 
ad 


sc 
sc 


} 


(OFFSET_Y, OFFSET_X + 1); 


1; break; 


1; break; 


int i = 0; i < SAF SCREEN WIDTH; ++i) 


ch('_"); 


(int y = 0; y < SAF_SCREEN_HEIGHT / 2; ++y) 
move(y + OFFSET_Y + 1,1); 


dch('|'); 


r (int x = 0; x « SAF SCREEN WIDTH; ++x) 


uint8 t pixels - ( 


SAF_colorTo1Bit(*scr) 


(SAF e Aetolis *scr2) !- 0); 


char p; 


switch (pixels) 


case 0: p = c00; break; 
case 1: p = c01; break; 
case 2: p = c10; break; 
case 3: p = cii; break; 
default: p = ' '; break; 

H 

addch(p); 

scrtt; 

scr2t+; 

dch('|'); 

r += SAF SCREEN WIDTH; 


r2 *- SAF SCREEN WIDTH; 


È 


move(OFFSET Y + 1 + SAF SCREEN HEIGHT / 2,2); 


for 
ad 


move( 


prin 
if ( 


SW. 


} } 


refr 


H 
endwin 
return 


leur de 
/* X11 ( 


requi 
compi 


include 
include 
include 
#include 
#include 


#undef S. 
#define 


#define 


#define 
#define 
#define 


int i = 0; i < SAF SCREEN WIDTH; ++i) 


ch('="); 


9,1); 
tw(SAF. PROGRAM, NAME) ; 


time « ncSoundEnd) 


itch (ncCurrentSound) 


case SAF SOUND CLICK: printw(" 


click)"); break; 


case SAF_SOUND_BEEP: printw(" ny break; 


case SAF SOUND BOOM: printw 
case SAF SOUND BUMP: printw 
default: break; 


esh(); 


QO; 
9; 


fined(SAF PLATFORM X11) 
xwindow, XLib) frontend 


z 


00M!)^ "break; 
bump! break; 


rements: XLib, stdio.h, unistd.h, sys/time.h 


ling: link XLib, e.g. -1X11 


<X11/X1ib.h> 

Sur Keysym h> 

<stdio 

<sys/time.h> 

<unistd.h> // for usleep 


AF PLATFORM NAME 
SAF PLATFORM NAME "X11" 


SAF FE STDIO SAVE LOAD 


SOUND BOOM "BOOM!" 
SOUND CLICK "click" 
SOUND BEEP "Beep" 


splay lines at once. 


12 0) << 1) 


#define SOUND BUMP "bump!" 
uint8 t x11Scr[SAF SCREEN WIDTH * SAF SCREEN HEIGHT]; 
uint8 t xi1Buttons[SAF BUTTONS]; 


uint8 t _x11CurrentSound = 0; 
uint32 t _x11SoundEnd = 0; 


uint32 t _x11GetTime() 
struct timeval now; 


gett imeotoay anol, HULL); 
return now.tv sec * 6 + now.tv_usec / 1000; 


void SAF_FE_drawPixel(uint8_t x, uint8_t y, uint8_t color) 
_x11Scr[y * SAF SCREEN WIDTH + x] = color; 


void SAF_FE_playSound(uint8_t sound) 


_x1iCurrentSound = sound; 
~x11SoundEnd = Sxiigetrine() + 1000; 


switch (sound) 


case SAF SOUND CLICK: puts(SOUND ! M break; 


case SAF SOUND BEEP: puts(SOUND_BEEP ; break; 
case SAF SOUND BOOM: puts(SOUND BOOM break; 
case SAF SOUND BUMP: puts(SOUND BUMP); break; 


} default: break; 
J 
uint8 t SAF FE buttonPressed(uint8 t button) 


return _x11Buttons[button]; 


const char *SAF_FE_extension(const char *string) 
_SAF_UNUSED(string) ; 
return SAF_FE_emptyString; 
void printHelp(void) 
f puts(gae. PROGRAM_NAME 
" SAF_INFO_STRING " (" SAF_PLATFORM_NAME ")" 
"An controls: WASD arrows, JKL YZXC space return, Esc - quit" 
"\n possible arguments: -h (print help), -N (N = 1..8, scale)" 
; 
H 
unsigned long  palette[256]; 
int main(int argc, char **argv) 
int scale - 4; 
for (int i = 0; i < argc; ++i) 
char *arg = argv[i]; 
if (arg[0] != © && arg[1] != © && arg[2] == 0) 
if (arg[1] == 'h') 
printhetp(); 
return 0; 
if (arg[1] >=_'1' ES aro[t] <= '8') 
} scale = arg[1] 'o' 
H 
for (int i = 0; i < SAF SCREEN WIDTH * SAF SCREEN HEIGHT; ++i) 
_xi11scr[i] = 0; 


for (int i=0; i< oo BUTTONS; ++i) 
x iButtons[i] = 


SAF FE init(); 
Display *display = XOpenDisplay(0); 
if (display == 0) 


puts("could not open a display"); 
return 0; 


int screen - DefaultScreen(display); 


Window window = XCreateSimpleWindow(display,RootWindow(display, screen), 10,10, 


SAF SCREEN WIDTH * scale,SAF SCREEN HEIGHT * scale,1 
BlackPixel(display, screen), wWhitePixel(display,screen]); 


XMapwindow(display, window); 
XSelectInput(display,window,KeyPressMask | KeyReleaseMask); 
// create the palette: 
for (int i = 0; i « 256; ++i) 

XColor color; 

uint8_t r, g, b; 

SAF colorToRGB(i,&r,&g,&b); 


color.red - ((uint16_ t) r) * 256; 
color.green = ((uinti6 t) g) * 256; 
color.blue = ((uinti16 t) b) * 256; 
color.flags - DoRed | DoGreen | DóBlue; 


XAllocColor(display,DefaultColormap(display,9),&color); 


_palette[i] = color.pixel; 


H 
GContext context - DefaultGC(display,screen); 
uint32 t nextFrame = _x11GetTime(); 


int goOn - 1; 
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uint8 t previousSound - 255; 


while (1) // main loop 
uint32 t time = _x11GetTime(); 


while (time »- nextFrame) 
if (!SAF FE loop()) 
oon = 0; 
reak; 


nextFrame += SAF MS PER FRAME; 


usleep(((nextFrame - time) * 3 / 4) * 1000); // relieve CPU 


if (!goOn) 
break; 


const uint8 t *pixel = _x11Scr; 

int drawX - 0, drawY - 0; 

for (int y - 
drawX = 0; 


0; y < SAF_SCREEN_HEIGHT; ++y) 


for (int x = 0; x < SAF_SCREEN_WIDTH; ++x) 
XSetForeground(display, context, palette[*pixel]); 


Api tRectangto( display: window, context, draw dr awy; 
scale, scale); 


pixelt++; 
drawX += scale; 
drawY += scale; 
if (time >= _x11SoundEnd) 
_x1iCurrentSound = 255; 
if (_x11CurrentSound != previousSound) 
switch (_x11CurrentSound) 
case SAF_SOUND_BEEP: 


XStoreName(display, window, SAF_PROGRAM_NAME " " SOUND_BEEP); break; 
case SAF_SOUND_CLICK: 
XStoreName(display, window, SAF PROGRAM NAME " " SOUND CLICK); break; 
case SAF SOUND BOOM:  . 
XStoreName(display, window, SAF PROGRAM NAME " " SOUND BOOM); break; 
case SAF SOUND BUMP: 
XStoreName(display, window, SAF PROGRAM NAME " " SOUND BUMP); break; 
} default: XStoreName(display, window, SAF_PROGRAM_NAME); break; 
H 
previousSound = _x11iCurrentSound; 


XEvent event; 


while Serer Ee ee caer Lay window, ,KeyPressMask | 
KeyRe LeaseMask, &event) != 


uint8_t state = event.xkey.type == KeyPress; 
switch (XKeycodeToKeysym(display, event .xkey.keycode, 0) ) 
case XK_Escape: goOn = 0; break; 


case XK_Up: case XK_w: 
_x11Buttons[SAF_BUTTON_UP] = state; break; 


case XK_Left: case XK a: 
 .xiiButtons[SAF BUTTON LEFT] = state; break; 


case XK Right: case XK d: 
 xiiButtons[SAF BUTTON RIGHT] = state; break; 


case XK Down: case XK s: 
 xiiButtons[SAF BUTTON DOWN] = state; break; 


case XK y: case XK z: case XK j: case XK space: 
_x11Buttons[SAF_BUTTON_A] = state; break; 


case XK x: case XK k: case XK Return: 
_x11Buttons[SAF_BUTTON_B] = state; break; 


case XK c: case XK 1l: 
_x11Buttons[SAF_BUTTON_C] = state; break; 


} default: break; 
H 
if (!goOn) 
breàk; 


XCloseDisplay(display); 


return 0; 


#elif defined(SAF PLATFORM ARDUBOY) 
/* Arduboy platform using the official Arduboy2 library. 


requirements: Arduino environment, Arduboy2 library 
compiling: compile with Arduino IDE 


#undef SAF PLATFORM NAME 
#define SAF PLATFORM NAME "Arduboy" 


#undef SAF PLATFORM COLOR COUNT 
#define SAF PLATFORM COLOR COUNT 2 


#undef SAF PLATFORM BUTTON COUNT 


#define SAF PLATFORM BUTTON COUNT 6 


#undef SAF PLATFORM HARWARD 
#define SAF PLATFORM HARWARD 1 


#undef SAF PLATFORM RAM 
#define SAF PLATFORM RAM 2500 


#undef SAF PLATFORM FREQUENCY 
#define SAF PLATFORM FREQUENCY 16000000 


#include <Arduboy2.h> 
Arduboy2 arduboy; 


#if SAF_SETTING_ENABLE_SOUND 
BeepPini arduboyBeep; 
#endif 


void SAF_FE_drawPixel(uint8_t x, uint8_t y, uint8_t color) 


{ 
arduboy.drawPixel(32 + x,y,color ? WHITE : BLACK); 


void SAF_FE_playSound(uint8_t sound) 


{ 

#if SAF_SETTING_ENABLE_SOUND 
uinti6_t f = 0; 
uint8_t t = 0; 


switch (sound) 


case SAF SOUND BEEP: f = 300; t = 10; break; 
case SAF SOUND CLICK: f - 5800} = 1; break; 
case SAF SOUND BOOM: f = = 8; break; 
case SAF SOUND BUMP: f = 105; ES b; beak: 
default: break; 


arduboyBeep.tone(arduboyBeep.freq(f),t); 
#endif 


3 
#define SAVE_VALID_VALUE 133 


uint16_t saveAddress = 0; 
uint8_t saveLoaded = 0; 


void arduboyLoadSave(void) 
if (!saveLoaded) 
if (EEPROM.read(saveAddress) != SAVE_VALID_VALUE) 
EEPROM. update(saveAddress, SAVE VALID VALUE); 


for (uint8 t i - 0; i « SAF SAVE SIZE; 


++i) 
EEPROM.update(saveAddress * 1 * 1,0); 


} saveLoaded = 1; 
H 
void SAF FE save(uint8 t index, uint8 t data) 


arduboyLoadSave( ); 
EEPROM. update(saveAddress + 1 + index, data); 


uint8_t SAF_FE_load(uint8_t index) 


arduboyLoadSave() ; 
return EEPROM. read(saveAddress + 1 + index); 


uint8 t SAF FE buttonPressed(uint8 t button) 
TUE (button) 


case SAF BUTTON UP: button - UP BUTTON; break; 

case SAF BUTTON RIGHT: button - RIGHT | BUTTON; ' break; 
case SAF BUTTON DOWN: button DOWN BUTTON; break; 
case SAF BUTTON LEFT: button - LEFT BUTTON; break; 
case SAF BUTTON A: button A BUTTON; break; 

case SAF BUTTON B: button B | BUTTON; break; 
default: return 0; break; 


} 


return arduboy.pressed(button) ; 


const char *SAF_FE_extension(const char *string) 


_SAF_UNUSED(string) ; 
return SAF_FE_emptyString; 


void setup() 


arduboy.begin(); 
AEMET 


#if SAF_SETTING_ENABLE_SOUND 
arduboyBeep.begin(); 
arduboy.audio.on(); 

#endif 


uint8 t c = SAF_colorTo1Bit(SAF_SETTING_BACKGROUND_COLOR) ? WHITE : BLACK; 


for (uint8 t = 0; ol < 64; tty) 
Tor. uint8 x=0; x < 128; MX) 
rduboy. EEORRECI 


arduboy. setFrameRate(SAF | FPS); 
SAF FE init(); 


saveAddress = SAF FE hashStr(SAF PROGRAM NAME) & Ox03ff; 


if (saveAddress > (1024 - SAF SAVE SIZE - 1)) // -1 for valid value 
saveAddress - 1024 - SAF SAVE SIZE - 1; 


void loop() 


if (!(arduboy.nextFrame())) 
return; 


sif SAF SETTING ENABLE SOUND 
arduboyBeep.timer(); 
#endif 


ardubo ollButtons 
SAF "EE" ibop(); O; 
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arduboy.display(); 


elif defined(SAF PLATFORM ESPBOY) 
/* ESPBoy platform. 


requirements: Arduino environment and required libraries 
compiling: compile with Arduino IDE 


#undef SAF PLATFORM NAME 
define SAF PLATFORM NAME "ESPBoy" 


#undef SAF PLATFORM RAM 
define SAF PLATFORM RAM 4000000 


#undef SAF PLATFORM FREQUENCY 
define SAF PLATFORM FREQUENCY 80000000 


#undef SAF PLATFORM HARWARD 
#define SAF PLATFORM HARWARD 1 


#include <Arduino.h> 
#include <Adafruit_MCP23017.h> 
#include <Adafruit_MCP4725.h> 
#include <TFT_eSPI.h> 


#if SAF SETTING ENABLE SAVES 
#include <ESP_EEPROM.h> 

uint8 t espboySaveValidValue = 0; 
EEPROMClass espboyEeprom; 

#endif 


#define MCP23017address 0 
#define MCP4725address 0x60 


Adafruit_MCP23017 espbo Mcp; 
Adafruit_MCP4725 espboybac; 

TFT. eSPI E Spas Tft; 

uint8 t espboyScreen[SAF SCREEN WIDTH * SAF SCREEN HEIGHT]; 
uint8 t espboyKeys - 0; 


PROGMEM uinti6 t espboyPalette[256] - 
SAF FE PALETTE 565 


; 
void SAF FE drawPixel(uint8 t x, uint8 t y, uint8 t color) 
espboyScreen[y * SAF SCREEN WIDTH + x] = color; 


void SAF FE playSound(uint8 t sound) 
hir SAF SETTING ENABLE SOUND 

int freq - 400; 

int dur - 75; 


switch (sound) 


case SAF SOUND CLICK: freq - 400; dur - 20; break; 
case SAF SOUND BEEP: freq = 300; dur = 150; break; 
case SAF_SOUND_BOOM: freq = 70; dur = 200; break; 
case SAF SOUND BUMP: freq = 130; dur = 50; break; 


} default: break; 


tone(D3, freq, dur); 
#else 

_SAF_UNUSED( sound); 
#endif 


#if SAF_SETTING_ENABLE_SAVES 
void espboyCheckEeprom(void) 


if (espboyEeprom.read(0) == espboySaveValidValue) 
return; 


espboyEeprom.write(0,espboySaveValidValue); 


for (uint8 t i = 0; i « SAF SAVE SIZE; ++i) 
espboyEeprom.write(i + 1,0); 


espboyEeprom.commit(); 
#endif 


void SAF_FE_save(uint8_t index, uint8_t data) 


if SAF_SETTING_ENABLE_SAVES 
espboyCheckEeprom() ; 
espboyEeprom.write(index + 1,data); 
espboyEeprom.commit(); 

#else 
_SAF_UNUSED( index); 
—SAF UNUSED( data); 

pendit 


uint8_t SAF_FE_load(uint8_t index) 


if SAF_SETTING_ENABLE_SAVES 
espboyCheckEeprom() ; 
return espboyEeprom.read(index + 1); 
#else 
_SAF_UNUSED( index) ; 
sendis 


uint8_t SAF_FE_buttonPressed(uint8_t button) 
coe (button) 


case SAF_BUTTON_UP: return espboyKeys & 0x02; break; 
case SAF_BUTTON_DOWN: return espboyKeys & 0x04; break; 
case SAF_BUTTON_RIGHT: return espboyKeys & 0x08; break; 
case SAF_BUTTON_LEFT: return espboyKeys & 0x01; break; 
case SAF_BUTTON_A: return espboyKeys & 0x10; break; 
case SAF BUTTON B: return espboyKeys & 0x20; break; 
case SAF BUTTON C: return espboyKeys & 0x80; break; 
default: return 0; break; 


3 
3 


const char *SAF_FE_extension(const char *string) 


_SAF_UNUSED(string) ; 
return SAF_FE_emptyString; 


ti setup() 


espboybac beain(MCPArzoaddness); 
delay(100); 
espboyDac.setVoltage(0, false); 
dapboyMcp;begin(MCP23017addreSs); 
delay(100); 


Hif SAF SETTING ENABLE SAVES 
x espboySaveVaLidValue = SAF FE hashStr(SAF PROGRAM NAME); 
endi 


// buttons 
for (uint8 t i = 0; i < 8; i++) 


espboyMcp.pinMode(i, INPUT); 
esp boVMcb pul tU C AE 


espboyMcp.pinMode(8, OUTPUT) ; 
espboyMcp.digitalwrite(8, LOW); 
espboyTft.begin(); 

delay} 100); ginQ; 
espboyTft.setRotation(0); 


espboyTft.setAddrwindow(0,128,0, 
espboyTft.fillScreen(TFT_BLACK) ; 


espboyDac.setVoltage(4095, true); // backlight 


128); 


#if SAF SETTING ENABLE SOUND 
pinMode(D3, OUTPUT); 
#endif 
#if SAF_SETTING_ENABLE_SAVES 
espboyEeprom. begin( SAF_SAVE_SIZE Fou) 
#endi 


for (uint16_t 


i= 0; 
espboyScreen[i] = 


0: 


SAF FE init(); 


uint32 t espboyNextFrame - 0; 
a loop() 
uint32 t time - millis(); 


if (time « espboyNextFrame) 
return; 


while (time »- espboyNextFrame) 

SAF FE loop(); 

espboyNextFrame += SAF MS PER FRAME; 
espboyKeys - -espboyMcp.readGPIOAB() & 255; 
const uint8 t *pixel - espboyScreen; 
uinti6 t line[SAF SCREEN WIDTH * 2]; 
for (int y = 0; y « SAF SCREEN HEIGHT; ++y) 

uinti16 t *p = line; 

Pal (int x = 0; x < SAF SCREEN WIDTH; ++x) 


uinti6 t c = pgm read word(espboyPalette + *pixel); 
*p = c; 


espboyTft.pushColors(line,SAF SCREEN WIDTH * 2); 
espboyTft.pushColors(line,SAF SCREEN WIDTH * 2 


f 


leur defined(SAF PLATFORM NIBBLE) 


/* Circuitmess Nibble prem: Persistent save/load isn't supported (EEPROM 


somehow doesn't work 


requirements: Arduino environment and required libraries 
compiling: compile with Arduino IDE 


*/ 

#include <Arduino.h> 
#include <CircuitOS.h> 
#include <Nibble.h> 


#undef SAF_PLATFORM_HARWARD 
#define SAF_PLATFORM_HARWARD 1 


#undef SAF_PLATFORM_NAME 
#define SAF_PLATFORM_NAME "Nibble" 


#undef SAF_PLATFORM_FREQUENCY 
#define SAF_PLATFORM_FREQUENCY 160000000 


#undef SAF_PLATFORM_RAM 
#define SAF_PLATFORM_RAM 80000 


#undef SAF_PLATFORM_HAS_SAVES 
#define SAF_PLATFORM_HAS_SAVES 0 


Display “pibbleDisp lay ; 
uinti6 t *nibbleFrameBuffer ; 
uint8 t nibbleButtons[SAF BUTTONS]; 


poe uinti6 t nibblePalette[256] = 
SAF_FE_PALETTE_565 


i 
void SAF_FE_drawPixel(uint8_t x, uint8_t y, uint8_t color) 


uint16_t c = pgm_read_word(nibblePalette + color); 


cç = ((c << 8) | (c >> 8)); // endien, TODO: could rather switch in the 


palette 


i « SAF SCREEN WIDTH * SAF SCREEN HEIGHT; 
; 


++i) 


uinti6 t *p = nibbleFrameBuffer + y * SAF_SCREEN_WIDTH * 4 + x * 2; 


*p = c; 
pr; 


p =c; 
p += SÁF SCREEN WIDTH * 2 - 1; 
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; 
"p-c; 


H 
void SAF FE playSound(uint8 t sound) 


{ 
#if SAF SETTING ENABLE SOUND 
switch (sound) 


t case SAF_SOUND_CLICK: Piezo.tone(400,20); break; 
case SAF SOUND BEEP: Piezo.tone 300,150); break; 
case SAF_SOUND_BOOM: Piezo.tone(70,200); break; 
case SAF_SOUND_BUMP: Piezo.tone(130,50); break; 
default: break; 


#else 
—SAF_UNUSED( sound); 
#endif 


void SAF_FE_save(uint8_t index, uint8_t data) 


_SAF_UNUSED(index) ; 
LSAF UNUSED( data) 


uint8 t SAF FE load(uint8 t index) 


.SAF. UNUSED(index); 
return 0; 


uint8 t SAF FE buttonPressed(uint8 t button) 


return nibbleButtons[button]; 


const char *SAF FE extension(const char *string) 


. SAF. UNUSED string); . 
} return SAF_FE_emp yString; 


// create button callbacks: 


#define cbf(b,n)\ 
void b ## spot f Maps dr 


255; }\ 
void b ## _up() nibbleButtons[n PE 


9 


Cbf(BTN UP,SAF BUTTON UP) 
Cbf(BTN RIGHT,SAF BUTTON RIGHT) 
cbf BTN- DOWN, SAF. BUTTON. DOWN 
Cbf(BTN LEFT, SAF BUTTON LEFT 
cbf BTN A, SAE. BUTTON A 

Cbf(BTN B,SAF BUTTON B 

Cbf(BTN C,SAF BUTTON C 

#undef cbf 


yoia setup() 


PUER EAE bbl lay() 
ni eDisplay = Ni e.getDispla š 
nibbleFrameBùffer =. 9 rige 
(uinti6 t *) nibbleDisplay-»getBaseSprite()-»frameBuffer(0); 


for (uint8 t i = 0; i < SAF BUTTONS; ++i) 
nibbleButtons[i] = 0; 


// register button callbacks: 


define cb(b) N 
Input::getinstance()-»setBtnPressCallback( 
Input::getInstance()-»setBtnReleaseCallbac 


nao 


cb(BTN_UP 


Cb(BTN 8) 


#undef cb 


; SAF FE init(); 


uint32 t nibbleNextFrame - 0; 
void loop() 
uint32 t time - millis(); 
Input: :getInstance()->Lloop(0); 


if (time < nibbleNextFrame) 
return; 


while (time >= nibbleNextFrame) 
SAF FE loo 


0; 
} nabb leNexterame += SAF_MS_PER_FRAME; 


nibbleDisplay-»commit(); 


elif defined(SAF PLATFORM GAMEBUINO META) 
/* Gamebuino META frontend. 


requirements: Arduino environment, Gamebuino-Meta.h 
compiling: compile with Arduino IDE 


#undef SAF_PLATFORM_NAME 
#define SAF_PLATFORM_NAME "GB META" 


#undef SAF_PLATFORM_RAM 
#define SAF_PLATFORM_RAM 32000 


#undef SAF_PLATFORM_FREQUENCY 
#define SAF_PLATFORM_FREQUENCY 48000000 


#undef SAF_PLATFORM_HARWARD 
#define SAF_PLATFORM_HARWARD 1 


#include <Gamebuino-Meta.h> 
sif SAF SETTING ENABLE SAVES 


const Gamebuino Meta::SaveDefault metaSaveDefault[] = 
{ { 0, SAVETYPE BLOB, SAF SAVE SIZE, © ) }; 


#endif 
uint8_t metaLEDCountdown = 0; 


VORNE uinti6 t gbmPalette[256] - 
SAF FE PALETTE 565 


F 


void SAF_FE_drawPixel(uint8_t x, uint8_t y, uint8_t color) 


t gb.display.drawPixel(8 + x,y,(Color) pgm read word(gbmPalette + color)); 


void SAF FE playSound(uint8 t sound) 


{ 
#if SAF_SETTING_ENABLE_SOUND 
switch (sound) 


case SAF_SOUND_CLICK: pb: Sound tone (800,60 ; break; 
case SAF_SOUND_BEEP: gb.sound.tone(300,150); break; 
case SAF SOUND BUMP: gb.sound.tone(130,50); break; 
case SAF SOUND BOOM: 

gb.sound.playCancel(); 

gb. lights.fill(RED); 

metaLEDCountdown = 5; 

break; 
default: break; 


#else 


_SAF_UNUSED( sound); 
#endif 


uint8_t SAF_FE_buttonPressed(uint8_t button) 
i Gamebuino Meta::Button b; 
switch (button) 
t case SAF_BUTTON_UP: b = BUTTON_UP; break; 
case SAF_BUTTON_RIGHT: b = BUTTON_RIGHT; break; 


case SAF_BUTTON_DOWN: b = BUTTON_DOWN; break; 
case SAF_BUTTON_LEFT: b = BUTTON_LEFT; break; 


case SAF BUTTON A: b = BUTTON A; break; 
case SAF BUTTON B: b - BUTTON B; break; 
case SAF BUTTON C: b = BUTTON MÉNU; break; 


default: return 0; break; 


} 


} return gb.buttons.timeHeld(b) > 0; 


const char *SAF_FE_extension(const char *string) 


_SAF_UNUSED string); 4 
return SAF_FE_emptyString; 


uint8_t SAF FE load(uint8 t index) 


hir SAF SETTING ENABLE SAVES 
uint8 t data SAF SAVE SEL: 
gb.save.get(0,data,SAF SAVE SIZE) 
return data[index]; 

#else 
_SAF_UNUSED( index) ; 

#endif 


H 
void SAF FE save(uint8 t index, uint8 t data) 


{ 
1 BE iss i 
"att PETRI ENE SES 
uint8 m a 
gp save get (a d, SAF_SAVĒ SIZE); 
index] = data; 
2 [iode set(ó d SAF SAVE. SIZE); 
else 
_SAF_UNUSED( index); 
LSAF UNUSED( data); 
vendir 


void setup() 


gb.begin(); 
gb.setFrameRate(SAF FPS); 


for (uint8 t y = 0; y < 64; ++y) 
for (uint8 t x = 0; x « 80; ++x) 
gb.display.drawPixel(x,y,(Color) pgm read word(gbmPalette + 
SAF SETTING BACKGROUND COLOR)); 


sif SAF SETTING ENABLE SAVES 
gb.save.config(metaSaveDefault); 
#endif 


SAF_FE_init(); 


void loop() 


if (!gb.update()) 
return; 


if (metaLEDCountdown > 0) 


metaLEDCountdown- -; 


if (metaLEDCountdown -- 0) 
gb. lights.clear(); 


SAF FE loop(); 


l 
#elif defined(SAF PLATFORM RINGO 
/* Circuitmess Ringo (MAKERphone) frontend. 


requirements: Arduino environment, required libraries 
compiling: compile with Arduino IDE 


#include <Arduino.h> 
#include <MAKERphone.h> 
//#include <utility/soundLib/MPWavLib.h> 


#undef SAF_PLATFORM_NAME 
#define SAF_PLATFORM_NAME "GB META" 


#undef SAF_PLATFORM_RAM 
#define SAF_PLATFORM_RAM 520000 
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#undef SAF PLATFORM FREQUENCY 
#define SAF PLATFORM FREQUENCY 160000000 


#define RINGO SAVE FILE NAME ("/" SAF PROGRAM NAME ".sav" 


uinti6 t ringoPalette[256] = 
SAF FE PALETTE 565 
; 

MAKERphone mp; 


#if SAF SETTING ENABLE SOUND 
Oscillator *ringoOsc; 
#endif 


uint8_t ringoArrows; 
//uint8 t ringoScreen[SAF_SCREEN_WIDTH * SAF SCREEN HEIGHT]; 


void SAF FE drawPixel(uint8 t x, uint8 t y, uint8 t color) 


mp.display.fillRect(16 + x * 2,y * 2,2,2,ringoPalette[color]); 


void SAF FE playSound(uint8 t sound) 


{ 

#if SAF_SETTING_ENABLE_SOUND 
uint8_t wave = SINE; 
uint16_t freq = 1000; 
float dur = 0.2; 


switch (sound) 


1 case SAF_SOUND_BEEP: freq = 500; dur = 0.08; wave = SINE; break; // 
plasma 
case SAF_SOUND_CLICK: freq = 900; dur = 0.003; wave = = SAW; break; // click 
case SAF_SOUND_BOOM: freq = 100; dur = 0.06; wave = SAW; ' break; 
// explosion 
case SAF_ SOUND BUMP: freq - 200; dur - 0.02; wave - SQUARE; 


break; / plasma 
default: break; 


ringoOsc-»setWaveform(wave); 
ringoOsc-»beep(freq,dur); 
#else 
_SAF_UNUSED(sound) ; 
poe 


aaa SAF_FE_buttonPressed(uint8_t button) 
oo (button) 


#define P (but) 


(mp.buttons.timeHeld(but) » 0) 
#define r(but 


return b(but); break; 


case 
case 
case 


SAF BUTTON UP: 
SAF. BUTTON. DOWN: 
SAF. BUTTON RIGHT: 


return (ringoArrows & 0x04) 
return (ringoArrows & 0x08 


|| b(BTN_2); break; 
return (ringoArrows & 0x01) 


b(BTN_5 break; 
D(BTN ! break; 


case SAF BUTTON LEFT: return (ringoArrows & dH b(BTN . 4); break; 
case SAF BUTTON A: return b(BTN A b(BTN 8 reak; 
case SAF BUTTON B: return b(BTN B b(BTN 9 break; 
case SAF BUTTON C: r(BTN 7); 
default: return 0; break; 
#undef b 
#undef r 
H 
return 0; 
return 0; 


const char *SAF FE extension(const char *string) 


_SAF_UNUSED(string); 
return SAF FE | emptyString; 


sif 1//SAF SETTING ENABLE SAVES 
uint8 t ringoSaveLoaded = 0; 
uint8 t ringoSaveData[SAF . SÁVE | SIZE]; 


void ringoCheckSave() 
if (!ringoSaveLoaded) 
if (SD.exists(RINGO SAVE FILE NAME)) 


File f - SD.open(RINGO SAVE FILE NAME,FILE READ); 
f. read(ringoSaveData, SAF SAVE SIZE); 
f.close(); 


else 
for (uint8 t i = 0; i < SAF SAVE SIZE; ++i) 
ringosavébata[i] = 
ringoSaveLoaded = 1; 


hendif 


uint8_t SAF_FE_load(uint8_t index) 


if SAF_SETTING_| Oo SAVES 
ringoCheckSave( ) 
return FingosavéData [index]; 
#else 
_SAF_UNUSED (index); 
return 0; 
and 


void SAF FE save(uint8 t index, 


{ 
#if SAF SETTING ENABLE SAVES 
ringoSaveData[index] - data; 


uint8 t data) 


ringoCheckSave(); 


EM te Se open SAVE FILE rear: 
File f = SD.open(RINGO_SAVE_FILE_NAME, FILE_WRITE); 
f.write ringogavebata, SAF SAVE SIZE); 
f.close(); 
#else 
_SAF_UNUSED( index); 
-SAF UNUSED( data); 
2 


void setup() 


mp.begin(); 

sif SAF SETTING ENABLE. SOUND 
ringoOsc - new Oscillator(SINE); 
Pinqaneeccetvoluretaay 
ringoosc >setVolume(64 

#endi 


SAF_FE_init(); 


uint32_t ringoNextFrame = 0; 
yoid loop() 
uint32_t time = millis(); 


if (time < ringoNextFrame) 
return; 


mp.display.fillRect( 


0,0, LCDWIDTH, LCDHEIGHT, ringoPalette[SAF SETTING BACKGROUND COLOR]); 


while (time »- ringoNextFrame) 


SAF FE loop(); 
ringoNextFrame += SAF MS PER FRAME; 


ringoArrows = 0x00 | 
mp.buttons.getJoystickX « 200 << 0 
mp.buttons.getJoystickX > 900 «« 1 
mp.buttons.getJoystickY « 200 << 2 
mp.buttons.getJoystickY > 900 << 3; 


mp.update(); 
else 


#error No known SAF frontend specified. 
#endif // platform frontends 


FUNCTION IMPLEMENTATIONS 


#ifdef SAF_FE_GENERIC_FRONTEND 


#ifndef SAF_FE_STDIO_SAVE_LOAD 
#define SAF_FE_STDIO_SAVE_LOAD 
#endif 


#include <stdio.h> 


#define SAF FE GF SAVE FILE NAME (SAF PROGRAM NAME ".rec") 
uint8 t SAF FE GF running - at 
uint8 t SAF FE GF volume = 4; 
uint8 t SAF FE GF “Sereen[ SAF’ SCREEN_WIDTH * SAF_SCREEN_HEIGHT]; 
uint8_t SAF_FE_GF_parame ers[128]; 7/ CLI parameters 
uint32 t SAF FE GF keyStates = 9; 
uint8_t SAF_FE_GF_buttonStates = ‘0; 
uint8_t SAF FE GF paused = 0; 
uint32 t SAF FE GF demoNextFrame - n // when to load the next record item 
uint8 t SAF FE GF | demoNextButtons = 0; 
int32_t SAF_FE_GF_frameTimes = 0; H "for debug, measures time spent in a frame 
uint32 t SAF FE GF | nextFrameTime'- 0; 
FILE *SAF FE GF recordFile; 
/** Records a specific Key state and returns O if the key is not pressed, 1 if 
it was just pressed or if it's been pressed for multiple frames. * 
[ct SAF FE GF handleKey(char key, uint8 t position) 
position - 0x01 «« position; 
uint8 t previous - (SAF FE GF keyStates & position) !- 0; 
if (SAF FE GF keyPressed(key)) 
SAF FE GF keyStates |- position; 
return previous ? 2 : 1; 
Qs 
SAF FE GF keyStates &- -position; 
return 0; 
y 
H 
uint8 t SAF FE buttonPressed(uint8 t button) 
char key = 0, key2 = 0, key3 = 0, key4 = 0; 
uint8_t bit = 255; 
switch (button) 
case SAF_BUTTON_UP: key = 'w'; key2 = 'U'; bit = 0; break; 
case SAF_BUTTON_RIGHT: key = 'd'; key2 = 'R'; bit = 1; break; 
case SAF BUTTON DOWN: key = 's'; key2 = 'D'; bit = 2; break: 
case SAF BUTTON LEFT: key = 'a'; key2 = 'L'; bit = 3; b break; 
2: pease; SAF_BUTTON_A: key = 'j'; key2 = 'y'; key3 = 'z'; key4 = 'X'; bit 
: case SAF BUTTON B: key = 'k'; key2 = 'x'; key3 = 'Y'; bit = 5; break; 
case SAF_BUTTON_C: key = 'l'; key2 = 'c'; key3 = 'Z'; bit = 6; break; 
default: break; 
return SAF FE GF keyPressed(key) || 
key2 && SAF FE GF  keypressed key2 
key3 && SAF_FE_GF_keyPressed(key3 
key4 && SAF FE GF _keyPressed key4 
it != 255 && 


( AF FE GF parameters['p'] 


SAF FE GF buttonStates & (0x01 «« bit))); 


void SAF FE drawPixel(uint8 t x, 
SAF FE GF screen[y * SAF SCREEN WIDTH + x] = 


uint8 t y, uint8 t color) 


color; 


void SAF FE GF saveScreenshot(const char *file) 
FILE *f - fopen(file,"wb"); 


if (!f) 
return; 


fwrite("P6 64 64 255\n",13,1,f); 


for (uinti6 t i = 0; i < SAF SCREEN WIDTH * SAF SCREEN HEIGHT; 


uint8 t t[3]; 
SAF | colorToRÓB(SAF. | FE GF screen[i],t,t * 1,t * 2); 
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++i) 


fwrite(t,3,1,f); 


fclose(f); 


puts("screenshot taken"); 


void SAF FE GF printHelp() 


puts( 
SAF PROGRAM NAME 
"Nn " SAF INFO STRING 
"\n " SAF PLATFORM NAME " (generic frontend)\n" 
‘controls: Nn" 


WSAD, arrows direction buttons Nn" 


v- JKL A, B and C buttons Nn" 

E = pause/resume\n" 

" escape quit\n" 

ee ATI take screenshot\n" 

" U/I volume -/+\n" 

" N/M speed -/+\n" 

"possible arguments (if Supported) :NnU 

"sh print help and quit\n" 

"C -sX Scale X times (9 = fullscreen)\n" 

" -yX set volume to X (0 to 8)\n' 

" -bX boost A (1 to 5, 3 = normal)\n" 

" -d show debug info\n" 

" -u use pixel art scaling (scale2x)\n" 

Mr we record inputs (demo, can be used for saves)\n" 
"C p play recorded inputs (demo)\n" 

" -pP ike -p but rewind to end_(\"load state\")\n" 
" -l turns on -P and -r (save/load via demos)\n" 

" -S start paused"); 


#ifdef SAF_FE_GF_EXTRA_HELP 
puts(SAF FE GF EXTRA HELP); 
| dnd 


char *SAF FE GF byteToHex(uint8 t b, char s[3]) 
for (uint8 t i = 0; i < 2; ++i) 
uint8 t r = b % 16; 
EH nad] =rt (Cr < 10) ? 'O' : ('a' - 10)); 
H 
s[2] = 6; 


return s; 


uint8_t SAF_FE_GF_byteFromHex(const char *hex) 
uint8_t result = 0; 


for (int8_t i = 0; i < 2; ++i 
result = result * 16 + hex[i] - 
((hex[i] >= '0' && hex [i] <= '9') ? '0O' : ('a' - 10)); 


return result; 


void readNextDemoRecord(void) 


char_line[ [64]; 
SAF_FE_GF_bu tonStates = SAF_FE_GF_demoNextButtons; 


if (fgets(line,64,SAF FE GF recordFile) != 0) 


SAF FE.GF demoNextFrame = 
uint32 t) SAF FE GF byteFromHex(line)) << 24) + 
uint32 t) SAF FE GF byteFromHex(line + 2 << 16) + 
uint32 t) SAF FE GF byteFromHex(line + 4 << 8) + 

uint32_t) SAF_FE_GF_byteFromHex( 


ine + 6) 
SAF FE GF demoNextButtons = SAF FE GF byteFromHex(line + 9); 
else 


pure eheptayin inputs finished?) 
AF demoNextFrame = Oxffffffff 


fclose(SAF FE GF recordFile); 
al (SAF_FE_GF_parameters['r']) 
// after "loading" the state open again for appending 


d: 
0; 


SAF FE GF parameters TE 
SAF FE GF parameters 


SAF FE GF recordFile - fopen(SAF FE GF SAVE FILE NAME, "a"); 


} 


if (SAF_FE_GF_parameters['S']) 
SAF_FE_GF_paused = 1; 


} F 
void _SAF_FE_GF_mainLoopIteration(void) 
if (!SAF FE GF loop(SAF FE GF parameters)) 
SAF FE GF running - 0; 


return; 


uint32 t time 
Pa Loch T—EMSCRIPTEN - 


selbe 


SAF FE GF sleep(0); 
#endif 


eitndet EMSCRIPTEN__ 
T {time >= SAF FE GF nextFrameTime) 
#endi 
if (SAF FE GF handleKey('t',0) == 1) 
char fileName[64] = SAF PROGRAM NAME " "; 
char *c - fileName; 


while (*c != 0) 
Ctt; 


SAF FE GF byteToHex((SAF frame() / 256) % 256,c); 
c += 25 


SAF FE GF byteToHex(SAF frame() % 256,c); 
c += 2; 
*c = '.'; Ctt; *c = 'p'; ctt; *c = 'p'; ct+; *c = 'm'; cet; *c = 0; 
} SAF_FE_GF_saveScreenshot (fileName) ; 
if (SAF_FE_GF_handleKey('i',1) == 1 && SAF_FE_GF_parameters['v'] < '8') 
SAF_FE_GF_parameters['v']++; 
puts("volume +"); 
rg ye tse if (SAF_FE_GF_handleKey('u',2) == 1 && SAF_FE_GF_parameters['v'] > 
SAF_FE_GF_parameters['v']--; 
puts("volume -"); 
if (SAF_FE_GF_handleKey('m',3) == 1 && SAF_FE_GF_parameters['b'] < '5') 
SAF_FE_GF_parameters['b']++; 
puts("speed +"); 
jet if (SAF FE GF handleKey('n',4) -- 1 && SAF FE GF parameters['b'] » 
SAF FE GF parameters['b']--; 
puts("speed -"); 
if (SAF FE GF handleKey('p',5) -- 1) 
SAF FE GF paused - !SAF FE GF paused; 
puts(SAF FE GF "paused ? "paused" : "resumed"); 
uinti6 t mult = 2; 
for (uint8_t i = 0; i < '5' - SAF FE GF parameters['b']; ++i) 
mult *= 2; 
uint8_t frames = 0; 
uint8_t rewind = 0; 
#ifndef EMSCRIPTEN__ 
while (time >= SAF_FE_GF_nextFrameTime || rewind) 
#endif 
rewind = SAF FE GF parameters l && 
SAF | FE. GF demoNextFrame != ÓxffTfffff; 
if (!SAF FE GF paused) 
#ifndet __EMSCRIPTEN__ 
Ñ SAF_FE_GF_frameTimes -= SAF_FE_GF_sleep(0); 
#endif 
// demo recording/playing: 
if (SAF_FE_GF_parameters['r'] && !SAF_FE_GF_parameters['p']) 
uint8_t previousButtonStates = SAF_FE_GF_buttonStates; 
SAF_FE_GF_buttonStates = 
SAF_buttonPressed SAF BUTTON UP) | - 96 
SAF buttonPressed(SAF BUTTON RI HT) IE «« 1) | 
SAF buttonPressed(SAF BUTTON DOWN) !- 9) << 2 
SAF buttonPressed(SAF BUTTON LEFT) !- 0) «« 3 
SAF buttonPressed(SAF BUTTON A) !- << 4 
SAF buttonPressed(SAF BUTTON B «« 5 
SAF buttonPressed(SAF BUTTON C «« 6); 
a (SAF_FE_GF_buttonStates != previousButtonStates) 
char s[3]; 
uint32_t f = SAF_frame() 
oxff,s)) fprintf(SAF FE GF recordFile, "%s",SAF_FE_GF_byteToHex((f >> 24) & 
x S " 
E 25 i: fprintf(SAF. FE GF recordFile,"*s",SAF FE GF byteToHex((f >> 16) & 
xff,s)); 
E es i fprintf(SAF_FE_GF_recordFile, "%s", SAF_FE_GF_byteToHex((f >> 8) & 
x s " 
' 1^! — fprintf(SAF FE GF recordFile,"Xs ",SAF FE GF byteToHex(f & 
Oxff,s)); 


n",SAF FE GF | 


els 
SAF FE | c. de 


re 
) 77 


SAF | 


#ifndef _ EM 
SAF | 
#endif 


if ( 


ch 
SA 
SA 
pu 
SA 


H 
)7/i 
if (!r 

SAF | 


frames 


if (SAF | 


char d 
debugS 
puts(d 


SAF FE. G 
) // if (ti 


#ifndef | EM 
SAF FE GF 
#endif 


fpr rintf(SAF FE GF recordFile, "%s\ 
yteToHex(SAF_FE_GF_buttonStates, s)); 


se if (SAF FE GF parameters['p'] && SAF frame() >= 


moNextFrame) 


adNextDemoRecord(); 
demo handling 


FE GF running - SAF FE loop(); 


ISCRIPTEN . 
FE GF frameTimes += SAF FE GF sleep(9); 


SAF FE GF parameters['d'] && SAF frame() % 64 == 0) 

ar debu JTE = "frame us/frame mi 

F intToStr F frame(),debugStr + 6)[0] = ' 

F intToStr SAF | FE GF - frametimes * 1008) / ea’ debugStr + 23); 
ts(debugStr); 

F_FE_GF_ frameTimes = 0; 

f (!paused) 

ewind) 


FE GF nextFrameTime += (SAF MS PER FRAME * mult) / 8; 


++; 


FE_GF_parameters['d'] && frames > 1) 


ebugstr[] = = "skipped x frames"; 
tr[ [81 0' + frames - 1; 
ebugStr); 


F present(SAF FE GF screen); 
ime » nextFrameTime) 


ISCRIPTEN . 
| Sleep((SAF FE GF nextFrameTime - time) * 3 / 4); // relieve CPU 
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#ifdef ^ EMSCRIPTEN . . 
if sip oe FE GF keyPressed('E')) // generate the cookie name 
FE GF running - 0; 
char *progName - SAF PROGRAM NAME; 


#ifdef —EMSCRIPTEN__ emscriptenCookie[0] = 'S'; 
typedef void (*em callback func)(void); emscriptenCookie[1] - 'A'; 
void emscripten set main loop(. ; ; etium emscriptenCookie[2] - 'F' 
em callback func func, int fps, int simulate infinite loop); 
#endif for (uint8_t i = 3; i < 16; ++i) 
emscriptenCookie[ i] Sy 


int main(int argc, char **argv) 


SAF FE paramParse(argc,argv,SAF FE GF parameters); uint8.t p = 9; 


i t= m 
if (SAF FE GF parameters['h']) Te (progName[py 1—.-9:8& p-«-16.- 3) 


emscriptenCookie[p + 3] = progName[p]; 


SAF_FE_GF_printHelp(); ptt; 
return 0; J ' 
A emscriptenCookie[16] = 
if (SAF_FE_GF_parameters['s' < 495 || SAF FE GF parameters['s'] » '8') iptencogkie[18] 
SAF FE GF parameters['S'] = '4'; char script[] = "document.cookie.search('........ sisse EU 
if (SAF FE GF parameters['v'] < '0' || SAF FE GF parameters['v'] > '8') for (uint8 t i = 0; i < 16; ++i) 
SAF FE GF parameters['v'] = '4'; script[24 + i] = emscriptenCookie[i]; 
if arere EOE parameters 1b] fau || SAF FE GF parameters['b'] > '5') int cookieIndex - emscripten run script int(script); 


if (SAF FE GF parameters[' if (cookieIndex »- 0) 


SAF FE GF parameters['P'] 
SAF FE GF parameters['r 


24; char *cookie = emscripten run script string("document.cookie") 
m" * cookieIndex * 17; 
i 


for (uint8_t i = 0; i 


€ 
if NO FE GF parameters['P' . : PUT —SAF FE “Savememory[i] 
F_FE_GF_parameters['p 1; // automatically turn this on as well 


SAF_SAVE_SIZE; ++i) ; 
= (cookie[2 * 'i] - 'a') * 16 + (cookie[2 * i+ 1] - 


if (SAF FE GF parameters['S'] && !SAF FE GF parameters['p']) En (uinti6 t i = 0; i < SAF SAVE SIZE; ++i) 
SAF FE GF paused - 1; .SAF FE saveMemory[i] = 
for (uinti6 t i = 0; i< aor SCREEN WIDTH * SAF SCREEN HEIGHT; ++i) #else 
SAF. FE. GF - -screen[i] = FILE *f - fopen(SAF PROGRAM NAME ".sav","rb") 
puts("starting " SAF PROGRAM NAME); 
Portista with -h for help"); É if (0 


fread( SAF FE saveMemory,SAF SAVE SIZE, 1, f); 
if (SAF FE GF -parameters Dad d) fclose(f); 
puts("initializing frontend"); 


else 
ini : for (uinti16 t i = 0; i « SAF SAVE SIZE; ++i) 
SAF FE GF init(SAF FE GF parameters); T SÀF FE "saveMemory[i] = - 0; 
if (SAF. FE. GF qbarameters['d']) . #endif // emscripten 
puts("initializing client program"); i _SAF_FE_saveMemoryLoaded = 1; 
SAF_FE_init(); #endif // if SAF_SETTING_ENABLE_SAVES 
Hr (SAF_FE_GF_parameters['p']) void SAF_FE_save(uint8_t index, uint8_t data) 
SAF FE GF recordFile = fopen(SAF FE GF SAVE FILE NAME, "r"); hr SAF SETTING ENABLE SAVES 
if (! SAF FE saveMemoryLoaded) 
if (!SAF FE GF recordFile) .SAF FE loadSaveMemory(); 
puts("couldn't open demo file for reading"); SAF FE saveMemory[index] - data; 
SAF FE GF | Parancters[i B; ] Z = 0; wie Le 
SAF_FE_GF_parameters = 0; Hifdef ^ EMSCRIPTEN . 
élse char str[] = "document.cookie = '............. s zum 
readNextDemoRecord(); f 
for (uint8 t i = 0; i « 16; ++i) | 
if (!SAF FE GF parameters['p'] && SAF FE GF parameters['r']) str[19 + i] = emscriptenCookie[i]; 
SAF FE GF recordFile = fopen(SAF FE GF SAVE FILE NAME, "w"); uint8 t p = 36; 
if (ISAF FE GF recordFile) for (uint8 t i = 0; i « SAF SAVE SIZE; ++i) 
ts("couldn't open demo fi te, for writing" char c1 = 'a' + _SAF_FE_saveMemory[i] / 16; 
E ri] i writing"); char c2 = 'a' + .SAF FE saveMemory[i] % 16; 
} str[p] = c1; 
str[p + 1] = c2; 
#ifdef | EMSCRIPTEN . 
F gmscripten_set_main_loop(_SAF_FE_GF_mainLoopiteration, SAF_FPS, 1); n p += 2; 
else 
while (SAF_FE_GF_running) // main loop 
_SAF_FE_GF_mainLoopIteration(); str[p] = '\"' 
#endif str[p + 1] = IE 
str[p + 3] = 0; 
if (SAF FE GF recordFile) 
fclose(SAF FE GF recordFile); emscripten run script(str); 
#else 
printf("ending %s\n",SAF_PROGRAM_NAME); FILE *f = fopen(SAF PROGRAM NAME ".sav", "wb"); 
Sissi FE saveMemory,SAF SAVE SIZE, 1, f); 
SAF FE GF end(); close 
.FE GF end(); #endif // emscripten 
return 0; #else 
} , . SAF. UNUSED index); 
-SAF UNUSED( data); 
: g # 
const uint8 t *SAF FE GF getScreenPointer() Der 


return SAF FE GF screen; uint8 t SAF FE load(uint8 t index) 


x 
i : #if SAF SETTING ENABLE SAVES 
const char *SAF FE extension(const char *string) Jt (!.SAF FE saveMemoryLoaded) 


: : SAF FE loadSaveMemor 
return SAF FE GF extension(string); cse us aveMemory() ; 


endif // SAF FE GENERIC FRONTEND ae [S turn SAR FE saveMemory [index]; 
! return 0; 
#ifdef SAF FE STDIO SAVE LOAD gendif 
H 


sif SAF SETTING ENABLE SAVES 

#endif // ifded SAF FE STDIO SAVE LOAD 
#include <stdio.h> 

void SAF FE paramParse(int argc, char **argv, uint8 t paramValues[128]) 
uint8 t -BAE-FE-saveMemory[SAE. S SAVE. SIZE]; { f . . 
uint8 t SAF FE saveMemoryLoaded = 0; for (uint8 t i = 0; i < 128; ++i) 

paramValues[i] - 0; 

#ifdef ^ EMSCRIPTEN . 


char *emscripten run script string(const char *script); for (uinti6 t i = 0; i < argc; ++i) 
int emscripten run script int(const char *script); poen 

void emscripten run script(const char *script); const char *a - *argv; 

char emscriptenCookie[17]; if (*a == '-') 

#endif { "e: 


t 


void _SAF_FE_loadSaveMemor 
Y _SAF_FE_ yO if (a !- 0) 
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t. as 
p cranvatues | (Uineb t) in - 


param 21; 
else if (a[2] == 90s t 
} barum Allied ruth 8 “t) Perel] = a[1]; 
H 
argvtt; 


J 

3 

#if SAF_SETTING_FORCE_1BIT 
#undef SAF PLATFORM COLOR COUNT 


#define SAF PLATFORM COLOR COUNT 2 
#endif 


sif SAF PLATFORM HARWARD 
#include EET h> 
#define _SAF_CONST PROGMEM const 
4 Toering _SAF_READ_CONST (addr) ((uint8_t) pgm_read_byte(addr)) 
else 
#define _SAF_CONST static const 
#define _SAF_READ_CONST(addr) *(addr) 
#endif 


uint32_t _SAF_frame = 0; 

uint8_t SAF currentRandom = 0; 

uint8 t SAF buttonStates[SAF | BUTTONS {0,0,0,0,0,0,0}; 

uinge t .SAF saveMemory[SAF SAVE SIZE 
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0}; 
Tg ad "SAF. ! saveMemoryLoaded = = 6; 


"er 


.SAF CONST uint8 t _SAF_font[] = 


0x00, 0x00, // 32 ' ' 
0x22,0x20, // 33 '!' 
0x55,0x00, // 34 '"' 
Oxea, 0x57, // 35 '#' 
0x36, 0x36, // 36 '$' 
0x49, 0x92, // 37 '%' 
0x52, 0xb6, // 38 '&' 
0x22, 0x00, // 39 ''' 
0x24, 0x42, // 40 '(' 
0x42,0x24, // 41 ' 
0x25,0x05, // 42 ' 
0x20,0x27, // 43 ' 
0x00,0x22, // 44 ' 
0x00,0x07, // 45 ' 
0x00,0x20, // 46 ' 
O0x24,0x12, // 47 ' 
0x57,0x75, // 48 ' 
0x46,0xe4, // 49 ' 
0x67,0x71, // 50 ' 
0x27,0x34, // 51 ' 
0x55,0x47, // 52 ' 
0x17,0x76, // 53 ' 
0x17,0x77, // 54 ' 
0x47,0x22, // 55 ' 
0x77,0x75, // 56 ' 
0x77,0x74, // 57 ' 
0x20,0x20, // 58 ' 
0x02,0x22, // 59 ' 
0x40,0x42, // 60 ' 
0x70,0x70, // 61 ' 
0x20,0x24, // 62 ' 
0x96, 0x44, // e3 ' 
0xde, 0x61, // 64 'Q' 
0x57,0x57, // 65 "A! 
0x73,0x75, // 66 'B' 
Ox16,0x61, // 67 'C' 
0x53,0x35, // 68 ' 
0x37,0x71, // 69 ' 
0x17,0x13, // 70 ' 
0x16,0x65, // 71 ' 
0x75,0x55, // 72 ' 
0x27,0x72, // 73 ' 
0x44,0x75, // 74 ' 
Ox35,0x55, // 75 ' 
Oxii1,O0x71, // 76 ' 
Oxfb, 0x99, Zt 
0xb9; 0x9d, // 18 ' 
0x96, 0x69, // T9 ' 
0x57, 0x17, // 80 ' 
0x96,0xed, // 81 ' 
0x57,0x53, // 82 ' 
0x36, 0x34, // 83 ' 
0x27,0x22, // 84 'T' 
0x55,0x75, // 85 'U' 
0x55,0x25, // 86 'V' 
Ox99,0xbf, // 87 'W' 
0x25,0x52, // 88 'X' 
0x75,0x22, // 89 'Y' 
0x27,0x71, // 90 'Z' 
0x26,0x62, // 91 Iu 
Ox21,0x42, // 92 ' 
0x46,0x64, // 93 ;]; 
0x52,0x00, // 94 ' 
0x00, 0x70, // 95 ' 
0x42,0x00, // 96 ' 
0x60,0x75, // 97 ' 
0x31,0x35, // 98 ' 
0x60,0x61, // 99 ' 
0x64,0x65, // 100 
0xd6,0x63, // 101 
0x26,0x27, // 102 
0x76,0x34, // 103 
Ox31,0x55, // 104 
0x02,0x22, // 105 
0x04,0x64, // 106 
O0x51,0x53, // 107 
0x22,0x42, // 108 
Oxf0,0x9d, // 109 
0x30,0x55, // 110 
0x70,0x75, // 111 
0x70,0x17, // 112 
0x70,0x47, // 113 
0x60,0x22, // 114 
0x60,0x32, // 115 
0x72,0x62, // 116 
0x50,0x75, // 117 
0x50,0x25, // 118 
0x90, 0xfb, // 119 
0x90,0x96, // 120 
0xa0,0x36, // 121 
0x30,0x62, // 122 
0x36, 0x62, // 123 
0x22,0x22, // 124 
0x63,0x32, // 125 
0xa0,0x05, // 126 
n O0x00,0x00 // 127 
i 


_SAF_CONST int8 t _SAF_cosTable[64] = 


Int ANK KE <C Aoao 


----------------------------00M 


127,127, 127, 127, 127, 127, 126, 126, 125, 124, 124, 123, 122, 121, 120, 119, 118, 117, 115, 


114, 112, 111, 109, 108, 106, 104, 102, 100, 98, 96, 94, 92, 90, 88, 85, 83, 81, 78, 76, 73, 71, 68, 


65, 63, 60, 57, 54, 51, 48, 46, 43, 40, 37, 34, 31, 28, 24, 21, 18, 15, 12, 9, 6, 3 
; 

int8 t SAF FE getSoundSample(uint8 t sound, uinti6 t sampleNumber) 
switch (sound) 


case SAF SOUND BEEP: 
return SAF sin(sampleNumber * 16); 
break; 


case SAF SOUND CLICK: 
fet urn (sampleNumber / 2) >> + (sampleNumber & 0x02); 
reak; 


case SAF SOUND BOOM: 
return sampleNumber * 2; 
break; 


case SAF SOUND BUMP: 
return ((sampleNumber >> 3) + sampleNumber) ^ 0x24; 
reak; 


default: 
return 0; 
break; 


i 
H 
void SAF FE scale2xScreen( 


const uint8 t screeni SAk SCREEN_WIDTH * SAF_SCREEN_HEIGHT], 
uint8 t result[SAF SCREEN WIDTH * SAF SCREEN HEIGHT * 4]) 


/* Here we try to optimize by handling the border cases separately which 
r ut code size will 


should considerably reduce amount of anching per pixel ( 
be greater). */ 


uint8 t p[4] = {0,0,0,0}; 


const uint8 t *sCurr screen; 
const uint8 t *sBott sCurr + SAF SCREEN WIDTH; 
const uint8 t *sTop - sCurr - SAF SCREEN WIDTH; 


result 
rCurr + SAF SCREEN WIDTH * 2; 


uint8 t *rCurr 
uint8 t *rBott 


#define step(t,r,b,l)N 


(SAF FE | Scále2xPixel(* sCurr,t,r,b,1l,p);\ 

*rCurr = p 9 ; rcurr; *reurr' = p[1]; rCurr++;\ 
*rBott = > rBott++; *rBott = p ; rBottt++;\ 
scurr++} s $ te; sTopt«;) 


#define nextLine\ 
{rCurr += SAF_SCREEN_WIDTH * 2;\ 
rBott += SAF_SCREEN_WIDTH * 2; Pu 


#define T *sTop 
#define R *(sCurr + 1) 
#define B *sBott 
#define L *(sCurr - 1) 


step(0,R,B,0) // first pixel (top-left) 


// first row from second to second to last (top edge) 
for (uint8_t i = 1; i < SAF SCREEN WIDTH - 1; ++i) 
step(0,R,B,L) 


step(0,0,B,L) // lest pixel of first row (top-right) 
nextLine 


// rows from second to second to last 
for (uint8 t j = 1; j < SAF SCREEN HEIGHT - 1; ++j) 


step(T,R,B,0) // first pixel of the row (left edge) 


// middle pixels not touching any edge) . 
for (uint8 t i - < SAF SCREEN WIDTH - 1; ++i) 
Step(T,R,B,L) 


step(T, 0,B,L) // last pixel of the row (right edge) 
nextLine’ 


3 
Step(T,R,0,0) // first pixel of the last row (top-bottom) 


// last row from second to second to last (bottom edge) 
for (uint8 t i = 1; i < SAF SCREEN WIDTH - 1; ++i) 
step(T,R,0,L) 


step(T,0,0,L) // last pixel (bottom-right) 
nextLine 


#undef step 

#undef nextLine 
#undef 
#undef 
#undef 
#undef 


} 


void SAF_FE_scale2xPixel(uint8_t middle, uint8_t top, uint8_t right, 
uint8_t bottom, uint8_t left, uint8_t result[4]) 


Trond 


uint8_t rightBottom = right == bottom; 
if (top == left) 


result[1] = middle; 

result[2] = middle; 

result[0] = (bottom == left || top == right) ? middle : top; 
else 

result[0] = middle; 


if (rightBottom) 


result[1] = middle; 
result[2] = middle; 
else 
result[1] = top != rig ght) 8 middle : right 
n result[2] - (bottom !- le t) ? middle : ef; 
H 
result[3] = (!rightBottom || top == right || bottom == left) ? 
middle : bottom; 
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int8 t SAF cos(uint8 t phase) 
uint8 t index = phase % 64; 
uint8 t part - phase / 64; 


if (part % 2) 
index = 63 - index; 


int8_t result = _SAF_READ_CONST(_SAF_cosTable + index); 


if (part == || part == 2) 
result *- -1; 


return result; 


H 
int8 t SAF sin(uint8 t phase) 
return SAF cos(phase - 64); 


void SAF getFontCharacter(uint8 t asciiIndex, uint8 t result[2]) 


asciilIndex = (asciilndex >= ' ' i asciilndex < '~') ? asciilIndex : 
asciiIndex = (asciiIndex - ' ') * 

result[0] = _SAF_READ_CONST(_SAF_font + asciilIndex); 

result[1] = _SAF_READ_CONST(_SAF_font + asciiIndex + 1); 


void _SAF_preprocessPosSize(int8_t *x, int8 t *y, int8 t *w, 


define p(s,c)\ 
if (*s SEN 


T. (^6 
ee = 


+ *s < *c) /* overflow? */N 
127 - *s 


#undef p 
H 


void SAF drawRect(int8 t x, int8 t y, int8 t width, int8 t height, 


color, uint8 t filled) 


1 
if (width -- || height == 0) 
return; 


_SAF_preprocessPosSize(&x, &y, width, &height); 
int8_t x2 = x + width; 
if (filled) 
while (height > 0) 
f int8 t x2 = x; 
for (uint8 t i = 0; i « width; ++i) 


SAF drawPixel(x2,y,color); 
x2t*; 


else 
int8 t y2 = y; 
da (height » 0) 


SAF drawPixel(x,y,color); 
SAF drawPixel(x2 - 1,y,color); 


y 
vee (width > 0) 


SAF drawPixel(x,y,color); 
SAF drawPixel x, y2, color); 


width--; 
} X++; 
H 
H 


int8 t SAF. z 0r awText (const char *text, int8 t x, int8 t y, uint8 t color 


uint8 t size) 


if (size -- 0) 
return x; 


int8 t originalX = x; 
while (1) // for each string character 
char c - *text; 


if (c = 0 
break: ) 


uint8_t character[2]; 
uint8_t width = 4 * size; 
if (c == '\n') 

x = originalX; 

y += 5; 

text++; 

continúe; 


} 


SAF_getFontCharacter(c,character); 
for (int8_t i = 0; i < 2; ++i) // for both bytes 
uint8_t byte = character[i]; 
for (uint8_t j = 0; j < 8; ++j) 
if (byte & 0x01) 
int8_t x2, y2 


infinite for loops */ 


re (int8 t k 0; k < size; ++k) 
x2 = X; 
for (int8 t l = 0; 1l < size; ++1) 
SAF_drawPixel(x2,y2,color); 
X2++; 
H 
y2t+; 
H 
H 
byte >>= 1; 
X += size; 


if (j == 3 || j == 7) 
t J J 


X -- width; 
y *- size; 
} 3 
3 


x += 6 * size; 
y -= width; 


textt++; 


} 


return x; 


void SAF_drawLine(int8_t x1, int8_t y1, int8_t x2, int8_t y2, 


ra (x1 > x2) 
uint- t tmp = 


= x2; 
x2 = tmp; 
tmp = y1; 
yl y5 
y2 - tmp; 
J} 
uint8_t dx = x2 - x1; 
uint8_t dy; 
int8_t *drawX = &x1; 
int8_t *drawY = &y1; 


int8_t stepX = 1; 
int8_t stepY = 1; 
uint8_t length = dx; 
uint8_t add; 

uint8_t compare = dx; 


if (y2 > y1) 
dy = y2 - y1 
add = dy; ^. 


if (dy > dx) 
{ 


drawX = &y1; 
araw- ex 
ength - p 
add - jt 


compare z dy; 


} 


else 


dy = y1 - y2; 
add = dy; 


if (dy < dx) 
stepY = 


I 
1 
B 


else 


drawX 
araw X 
ength = 
stepx = = AT 
add - dx; 
compare - dy; 


} 


} 


uint8_t accumulator = compare / 2; 
length++,; 
pom (length » 0) 

SAF drawPixel(xi,yi,color); 

*drawX += stepX; 

length--; 


accumulator += add; 


if (accumulator >= compare) 


accumulator -= compare; 
*drawY += stepY; 


} } 


uint32_t SAF_frame(void) 


return _SAF_frame; 


uint32_t SAF_time(void) 
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y; /* we have to iterate this way sa to prevent 


uint8_t color) 


return SAF frame * SAF MS PER FRAME; 


yoii SAF_FE_init(void) 
SAF init(); 


uint8 t SAF FE loop(void) 
for (uint8 t i = 0; i « SAF BUTTONS; ++i) 


uint8 t *b = _SAF_buttonStates + i; 
uint8_t state = *b; 


*b = SAF_FE_buttonPressed(i) ? (state < 255 ? state + 1: state) : 0; 


uint8_t result = SAF_loop(); 
_SAF_frame++; 
return result; 


static inline void SAF_clearScreen(uint8_t color) 


SAF drawRect(0,0,SAF SCREEN WIDTH,SAF SCREEN HEIGHT,color,1); 


[ST SAF random() 
7* We sbeorder caen sequence of 8 values to give some variety to specific bit 
patterns. 
uint8_t remap[8] = {5,7,2,0,3,6,4,1}; 


_SAF_currentRandom *= 13; 
_SAF_currentRandom += 7; 


uint8_t remainder = _SAF_currentRandom % 8; 


return _SAF_currentRandom - remainder + remap[remainder ]; 


H 
uint8 t SAF buttonJustPressed(uint8 t button) 
return SAF buttonPressed(button) == 1; 


potest SAF_buttonPressed(uint8_t button) 
return (button < SAF_BUTTONS) ? _SAF_buttonStates[button] : 0; 


int8_t SAF_colorFromRGB(uint8_t red, uint8_t green, uint8_t blue) 


u 

{ 

} return SAF_COLOR_RGB(red, green, blue) ; 

yoid S RELO ten TORGPCUIN TESE colorIndex, uint8_t *red, uint8_t *green, uint8_t 
ue 

{ 


uint8_t value = (colorIndex >> 5) & 0x07; 
*red = value != ? value * 36 : 255; 


value = (colorIndex >> 21 & 0x07; 
*green - value !- 7 ? value * 36 : 255; 


colorIndex & 0x03; 


value 
(value != 3) ? value * 72 : 255; 


*blue 


H 
uint8 t SAF colorInvert(uint8 t color) 


return -color; 


(aries SAF sqrt(uint32 t number) 


uint32 t result - 0; 
uint32 t a - number; 
uint32 t b = 1u << 30; 


while (b > a) 
b >>= 2; 

while (b != 0) 
Hr (a >= result + b) 


a -- result +_b; 
result = result + 2 * b; 


b >>= 2; 
result >>= 1; 


return result; 


} 


#define _SAF_IMAGE_MODE_NORMAL 0 
#define _SAF_IMAGE_MODE_COMPRESSED 1 
#define _SAF_IMAGE_MODE_1BIT 2 


struct 


uint8_t mode; 
const uint8_t “imane, 
uint8 t transparentColor; 
const uint8 t *binaryMask; 
uint8 t binaryLine; 
uint8 t binaryMaskLine; 
uint8 t binaryPosition; 
uint8 t binaryColori; 
uint8 t binaryColor2; 
uint8 t rleCount; 
uint8 t rleLastColor; 
const uint8 t *palette; 

3 .SAF drawnImage; 


pure _SAF_getNextImagePixel() 


uint8_t result = 0; 


switch (_SAF_drawnImage.mode) 


case _SAF_IMAGE_MODE_NORMAL: 
result = *_SAF_drawnImage. image; 
_SAF_drawnImage.imaget++; 
break; 


case SAF IMAGE MODE 1BIT: 
if (_SAF_drawnImage.binaryPosition == 0) 


_SAF_drawnImage.binaryLine = *_SAF_drawnImage. image; 
_SAF_drawnImage.image++; 
_SAF_drawnImage.binaryPosition = 8; 


if (_SAF_drawnImage.binaryMask != 0) 
_SAF_drawnImage.binaryMaskLine = ~(*_SAF_drawnImage.binaryMask 


/* We negate the mask because we want 1 to mean transparency; this 
allows to avoid an if-check before mask line shift later on. */ 


} _SAF_drawnImage.binaryMask++; 
H 
result = (( SAF drawnImage.binaryMaskLine & 0x80) == 0) ? 
(_SAF_drawnImage.binaryLine & 0x80 


? 
_SAF_drawnImage.binaryColor1 : TUE drawathags Ra VERNA 
) : .SAF drawnImage.transparentColor; 


_SAF_drawnImage.binaryPosition--; 
_SAF_drawnImage.binaryLine <<= 1; 
SAF_drawnImage.binaryMaskLine <<= 1; 


break; 


case _SAF_IMAGE_MODE_COMPRESSED: 
if (_SAF_drawnImage.rleCount == 0) 


uint8_t b = a AE ar awn muge. image; 
_SAF_drawnImage.rleLastColor = | AF_drawnImage.palette[b & Ox0f]; 
_SAF_drawnImage.rleCount = (b >> 4) + 1; 

_SAF_drawnImage.imaget++; 


} 


result = SAF drawnImage.rleLastColor; 
_SAF_drawnImage.rleCount - -; 


break; 


default: break; 
return result; 
void _SAF_drawImageGeneral(int8_t x, int8_t y, uint8_t transform) 


int8_t stepX 
int8_t stepY 


uint8_t invert = transform & SAF_TRANSFORM_INVERT; 
uint8_t scale = 1; 


switch (transform & 0x18) 


case SAF_TRANSFORM_SCALE_2: scale = 2; break; 
case SAF TRANSFORM SCALE 3: scale = 3; break; 
case SAF_TRANSFORM_SCALE_4: scale = 4; break; 


default: break; 


uint8 t width = *(_SAF_drawnImage. image); 
_SAF_drawnImage.imaget++; 


uint8_t h = *(_SAF_drawnImage.image) ; 
_SAF_drawnImage.imaget++; 


if G BAF drawnimage mode == _SAF_IMAGE_MODE_COMPRESSED ) 
_SAF_drawnImage.image += 16; // skip the palette 


uint8 t scaledwidth = (width - 1) * scale; 
uint8_t scaledHeight = (h - 1) * scale; 


int8 t *drawX 


&x; 
int8 t *drawY : 


&y; 
switch (transform & 0x07) 


case SAF TRANSFORM ROTATE 90: 
drawY = &x; drawX = &y; stepY = -1; x += scaledHeight; break; 


case SAF_TRANSFORM_ROTATE_180: 
stepX = -1; stepY = -1; x += scaledWidth; y += scaledHeight; break; 


case SAF_TRANSFORM_ROTATE_270: 
drawY = &x; drawX = &y; stepX = -1; y += scaledWidth; break; 


case SAF TRANSFORM FLIP: | 
stepX - -1; x *- scaledWidth; break; 


case (SAF TRANSFORM ROTATE 90 | SAF TRANSFORM FLIP): 


drawY = &x; drawX = &y; stepX = -1; stepY = -1; x += scaledHeight; += 
scaledWidth; break; xy SEP J : ad 


case (SAF TRANSFORM ROTATE 180 | SAF TRANSFORM FLIP): 
stepY = -1; y += scaledHeight; break; 


case (SAF TRANSFORM ROTATE 270 | SAF TRANSFORM FLIP): 
drawY - &x; drawX - &y; break; 


default: break; 
stepX *- scale; 
stepY *- scale; 
int8 t lineBack - -1 * stepX * width; 
while (h » 0) 
uint8 t w - width; 
while (w » 0) 
t uint8_t pixel = _SAF_getNextImagePixel(); 


if (pixel != -SAF-drawnImage.transparentColor) 
for (int8 t x2 = x; x2 < x + scale; ++x2) 
for (int8 t y2 = y; y2«y + scale; ++y2) 
SAF_drawPixel(x2,y2,invert ? S (pixels : pixel); 


*drawX += stepX; 
W--; 


} 


*drawX += LineBack; 
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h--; 
*dráwY += stepY; 


H 
H 
JAS Performs phe most common cases of image drawing faster than the general 


function 

void _SAF -drawImagerast(const uint8 t *image, int8 t x, uint8 t flip, 
want t transparentColor, uint8 t isiBit, const uint8 t uint8 t 

color 


uint8 t color2) 


int8 t 
"mask! 


uint8 t width - *image; 
image-*; 


uint8 t height = *image; 
image ++; 


int8_t x0 - x; 
int8 t xPlus - 1; 


if (flip) 
{ 


x0 = x + width - 1; 
xPlus = -1; 


#define 
while 
X= 

for 


loopStart\ 
(hexaht 120) (5 


(uints_ t w= width; w != 0; --w, x += xPlus) { 
loopEnd\ 


eight--;\ 
ytt; } 


if (isiBit) 
uint8 t bitCount = 0, 


#define 
\ 


imgLine = 0, maskLine = 0; 


mask += mask != 0? 2 : 0; // skip width and height 
loopStart 
e (bitCount == 0) 


Line = _*image; 
bi Count - 8; 
image++; 


if (mask != 0) 


maskLine = ~(*mask); // negation helps avoid branching later 
mask++; 


3 
H 
if ((maskLine & 0x80) == 0) 
SAF drawPixel(x,y,(imgLine & 0x80) ? colori : color2); 
bitCount--; 
imgLine <<Ż 1; 
maskLine ««- 1; 
loopEnd 


else 


loopStart 
uint8 t color = *image; 


if (color !- transparentColor) 
SAF drawPixel(x,y,*image); 


ima 
loopEn 


e; 


#undef loopStart 
#undef loopEnd 


void SAF drawImage(const uint8 t 
uint8 t transparentColor) 


if ((transform & -SAF TRANSFORM FLIP) == 0) 


_SAF_drawImageFast (image, x,y,transform & SAF TRANSFORM FLIP, 
transparentColor,9,0,0, ,9); 


*image, int8 t x, int8 t y, uint8 t transform, 


return; 
SAF_drawnImage.image = image; 
SAF_drawnImage.mode = _SAF_ IMAGE | MODE NORMAL; 


-SAF drawnlmage:transparentColor = transparentColor; 
_SAF_drawImageGeneral(x,y, transform) ; 


void SAF_drawImageCompressed(const uint8_t_*image, int8_t x, int8_t y, 
uint8_t transform, uint8_t transparentColor) 
_SAF_drawnImage.image = image; 
_SAF_drawnImage.mode = _SAF_ IMAGE | MODE COMPRESSED; 
—SAF drawnImage.transparentColor = = transparentColor; 
_SAF_drawnImage.rleCount = 0; 
-SAF drawnImage.rleLastColor' = 0; 
_SAF_drawnImage.palette = image + 2; 
} "SAF_drawImageGeneral(x,y, transform); 
int8_t x, int8_t 


void SAF —drawImageiBit (const uint8_t *image, y, 
( const uint8 t *mask, uint8 t colori, uint& t color2, uint8 t transform) 
if ((transform & ~SAF_TRANSFORM_FLIP) == 0) 


x,y,transform & 


F drawIma grast (image 
SAF. TRANSFORM FLIP mask, colori 1; 
color2); 
return; 


SAF_drawnImage.image = image; 


-SAF drawnImage.binaryMask = {mask != 0) ? mask + 2 : 0; // skip width/height 
_SAF_drawnImage.binaryLine = 
_SAF_drawnImage.binaryMaskLine 0; // © will be negated 


SAF_drawnImage.binaryPosition 0; 


for Gr i= i < 3; ++i) 
f (i != x m && i !- color2) 


_SAF_drawnImage.transparentColor = i; 
break; 


SAF_drawnImage.mode = 


-SAF drawnImage.binaryColori = colori; 
_SAF_drawnImage.binaryColor2 = color2; 
_SAF_drawImageGeneral(x,y, transform) ; 


void SAF_drawPixel(int8_t x, 


if ((x & 0xcO) == 0 && (y & OxcO) 
sif SAF PLATFORM COLOR COUNT <= 2 


int8 t y, 


.SAF IMAGE MODE 1BIT; 


uint8 t color) 


SAF FE drawPixel(x,y,SAF FE colorTodiBit(color,x,y) ? 


SAF COLOR WHITE : 
#else 
SAF_FE_drawPixel(x,y,color); 
d 


void SAF playSound(uint8 t sound) 
#if SAF SETTING ENABLE SOUND 
if (sound « SAF SOUNDS) 
SAF FE playSound(sound); 
#else 


_SAF_UNUSED(sound) ; 
#endif 


H 

void SAF reloadSaveMemory() 
if (! SAF saveMemoryLoaded) 

for (uint8 t i - 

. EOSESSeNE ena E HAV 

sif SAF SETTING ENAB AVES 

SAF FE load(i); 
#else 


9; 


#endif 
_SAF_saveMemoryLoaded = 1; 

} y 

void SAF_save(uint8_t index, 


if (index >= SAF_SAVE_SIZE) 
return; 


_SAF_reloadSaveMemory(); 
if (_SAF_saveMemory[index] 
_SAF_saveMemory[index] = data; 
#if SAF_SETTING_ENABLE_SAVES 
SAF_FE_save(index, data) ; 
#endif 
H 
uint8 t SAF load(uint8 t index) 


if (index »- SAF SAVE SIZE) 
return 0; 


_SAF_reloadSaveMemory(); 


return _SAF_saveMemory[index]; 


void SAF_randomSeed(uint8_t seed) 
_SAF_currentRandom = seed; 


grar *SAF intToStr(int32 t number, 
if (number -- 0) 
*string = '0'; 


*(string + 1) = 0; 
return String; 


char *start = string; 


if (number < 0) 
*string = '-'; 
stringt*; 


number *= -1; 
startt++; 


while (number > 0) 


*string = '0' + number % 10; 
number /= 10; 
stringt+; 


*string = 0; // terminate 
char *end = string - 1; 
string = start; 
oe (end > start) 
char tmp = *start; 
*start = *end; 
*end = tmp; 
startt++; 
end--; 


} 


return string; 


H 
char *SAF floatToStr(float number, 
int32 t whole - number; 
SAF intToStr(whole,string); 
if (decimals == 0) 
*string = 0; 


return string; 


char *c = string; 
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SAF_COLOR_BLACK) ; 


0; i < SAF SAVE SIZE; 


!= data) 


char *string) 


char 


++i) 


uint8_t data) 


*string, 


uint8_t decimals) 


if (number « 0) 
number *- -1; 
whole *- -1; 

if (decimals » 10) 
decimals - 10; 

int32 t factor - 1; 

while (decimals » 0) 
factor *- 10; 
decimals--; 


SAF intToStr((number - whole) * factor,c); 


return string; 


d) racirea tinest x, int8_t y, uint8_t radius, 


int8 t drawX 
int8 t drawY 


9; , 

radius; 

inti6 t d - 3 - 2 * radius; 

if (!filled) 
SAF drawPixel(x,y + radius,color 
SAF drawPixel(x,y - radius,color 


SAF drawPixel(x * radius,y,color 
SAF drawPixel(x - radius,y,color 


else 
for (int8 t i - x - radius; i <= x + radius; ++i) 
SAF drawPixel(i,y,color); 


eee (drawY >= drawX) 
if (d < 0) 
d += 4 * drawX + 6; 


else 
d += 4 * (drawX - drawY) + 10; 
drawY--; 
drawX++; 
int8 t xPlus = x + drawX; 
int8 t xMinus = x - drawX; 
int8 t yPlus = y + drawY; 
int8 t yMinus - y - drawY; 
int8 t x2Plus = x + drawY; 
int8 t x2Minus - x - drawY; 
int8 t y2Plus = y + drawX; 
int8 t y2Minus - y - drawX; 


uU (1filled) 


SAF drawPixel(xPlus,yPlus,color); 
SAF drawPixel(xPlus, yMinus, color); 
SAF drawPixel(xMinus, yPlus,color 
SAF drawPixel(xMinus, yMinus, color); 
SAF drawPixel(x2Plus,y2Plus,color 
SAF drawPixel(x2PLlus, y2Minus, color); 
SAF_drawPixel(x2Minus, y2Plus,color 
SAF drawPixel x2Minus, y2Minus, color); 


else 


examples/utd.h 
i @file utd.h 


microTD (uTD): SAF edition 


uint8_t color, uint8_t 


This is a _ SAF rewrite of a tiny tower defense game originally written for 


Arduboy. 


by drummyfish, 2021 ; . 
released under CCO 1.0, public domain 


small game manual: 


tower $ range speed damage upgrades 

guard 8g * s x t+range, +speed 
cannon 8 * * * t+range, +damage 
ice dz 2x ig +speed, range 
electro 30 ** * ** damage; shoc 
sniper 45 *€*** ** *x* *speed, frange 
magic 60 * T i +damage, speed aura 
water 100 *** *** — **** «range 

fire 100 *** id **** «range 

creep hp speed $ notes attacked by: 
spider *» Tx ED 

lizard * ME 

snake xw id 1 

wolf uad AEN 1 Good against cold. 

bat ** wee 1 

ent xk * 2 

big spider *** no 2 Spawns 2 small ones on death. 
ghost **x we 3 

ogre xxx ORR 3 

dino kakak xx 3 

demon *****  *** 3 Supposed to make you lose. 


TODO: procedurally generated maps? 


"A 


#define SAF PROGRAM NAME "microTD" 
define SAF SETTING FASTER 1BIT 2 
//#define SAF SETTING FORCE 1BIT 1 


It adds some extra things such as color graphics and a new map. 


Shoots arrows. 

Does splash damage. 
Slows down enemies. 
Shoots lightning. 
Covers huge range. 
Support tower. 

Can knock enemies back. 
Does splash damage. 


50% . 
RE 
NO NO. . NO. 


NO NO NO NO NO NO : 


for (int8 t i = xMinus; i <= xPlus; ++i) 


SAF drawPixel(i,yPlus,color); 
SAF drawPixel i, yMinus, color); 


H 
for (int8 t i = x2Minus; i <= x2Plus; ++i) 


SAF_drawPixel(i, y2Plus, color); 
} SAF drawPixel i, y2Minus, color); 
H 
3 
3 


const char *SAF_extension(const char *string) 


return SAF_FE_extension(string); 


uint8 t SAF colorToiBit(uint8 t colorIndex) 


return 
Hif SAF SETTING FASTER 1BIT --. 
// more accurate: 7 operations 
colorIndex & AM + 
colorIndex >> 2 0x07) + 
colorIndex >> 5 > 8; 
selif SAF_SETTING_FA‘ ER_1BIT == 
// faster: 4 operations 
(colorIndex >> 3) + 
.(colorIndex & 0x1 Qà >= ((Qx1f + 0x1c) / 2); 
selif SAF SETTING FASTER À1BIT == 2 
// fastest: 1 operation 
colorIndex & 0x90; 
#else 
// fastester: © operations 
colorIndex; 
id 


uint8 t SAF colorToGrayscale(uint8 t colorIndex) 


uint8 t tmp - colorIndex »» 2; 


return 
(colorIndex << 2) & Ox7f) + tmp + 
colorIndex << 4) & Ox3f)) | tmp; 


uinti6 t SAF FE hashStr(const char *str) 
uinti6 t r = 7621; 
while (*str != 0) 
LO << 4) ^ (r + ((uinti6 t) *str)); 


return r; 


uint8 t SAF FE colorToiBit(uint8 t color, 


if SAF SETTING 1BIT DITHER 
color - SAF colorToGrayscale(color); 


uint8 t x, uint8 t y) 


if (color « 85) 
return 0; 


else if (color > 170) 
return 1; 
else 


return (x % 2) == (y % 2); 
#else 
= SAFC UNUSED Ey} 


-SAF UNUSED( y) ; 
return SAF colorToiBit(color); 
qe 


#endif // guard 


#define SAF_SETTING_POKITTO_SCALE 2 
#define UTD_ALTERNATIVE_TILES 0 


#include "../saf.h" 


#define UTD_MAPS 5 . Ze feu 
#define UTD_MAX_MAP_SIZE 34 ///< maximum map description size in bytes 


#define UTD_MAX_CREEPS 50 
once 


#define UTD_MAP_WIDTH 16 


///< map width in squares 
#define UTD_MAP_HEIGHT 8 


///< map height in squares 


#define UTD_MAPS 6 ///< total number of maps 


#define UTD_SPLASH_RANGE 12 
#define UTD_WAVE_BASE_REWARD 5 


// game states: 

#defTine UTD GAME STATE MENU 0 

#define UTD GAME STATE PLAYING 1 
#define UTD GAME STATE PLAYING MENU 2 
#define UTD GAME STATE PLAYING WAVE 3 
#define UTD GAME STATE CONFIRM QUIT 4 
#define UTD GAME STATE LOST 5 


uint8 t UTD gameState; 
uint8 t UTD mapIndex; 
uint8 t UTD sound; 


uint8 t UTD backColor - SAF COLOR WHITE; 


uint8 t UTD menuItem = 0 


Me B ///< currently selected menu item 
uint8 t UTD cameraPos - 0; 


///« horizontal camera position in squares 


uint8 t UTD ramImage[10] = {8,8,0,0,0,0,0,0,0,0}; ///< 8x8 binary image in RAM 
i ; ///« 8x8 binary image mask 


uint8 t UTD_ramMask[10] = {8,8,0,0,0,0,0,0,0,0 


uint8_t UTD_cursorPos = 0; 


int8_t UTD lives = 0; 


j ///« player's current lives 
uinti6 t UTD money = 0; 


///« player's current money 
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///« maximum number of creeps present on map at 


///« sequential square position of the cursor 


uinti6 t UTD round = 0; ///« current round 


uint8 t UTD updateCounter; 


/// Instance of a creep on the map. 
preder struct 


uint8_t typeFreeze; ///« lower 4 bits: type, upper 4 bits: freeze counter 
uint8 t healthLives; ///< lower 6 bits: health, upper 2 bits: lives 
uint8 t pathStart; ///« offset to path start within level data 
inti6 t pathPosition; ///« position in pixels on path (can be negative) 

} UTD Creep; 


UTD Creep UTD creeps[UTD MAX CREEPS]; ///« array of creeps currently on map 
uint8 t UTD creepCount; ///« current number of creeps on the map 


sif SAF PLATFORM HARWARD 

#define UTD PROGMEM const PROGMEM 
else 

#define UTD PROGMEM static const 
#endif 


/// array of 8x8 1bit images 
YTD_PROGMEM uint8 t UTD images[] = 


#define UTD IMAGE CREEPS 0 // creep images, each one followed by mask 
Oxff,Oxff,0x99,0xc3, 0x81, Oxc3, 0x99, Oxff, 
0x00, 0x00, 0x66, Ox3c, Ox7e, Ox3c, 0x66, 0x00, 
Oxff,Ox7f,0x7f,0x31,0x80, Oxc3, 0x99, Oxff, 
0x00, 0x80, 0x80, Oxce, Ox7f, OX3C, 0x66, 0x00, 
Oxe3, 0xc9, 0x83, Ox9f , Oxc3, Oxf9, 0x83, Oxff, 
Ox1c, Ox3e, Ox7c, 0x60, Ox3c, 0x06, Ox7c, 0X00, 
Oxff,0x79,0x32,0x80, Oxc3, Ox9b, Oxb9, Oxff, 
0x00, 0x86, Oxcf , Ox7f , OX3C, 0x64, 0x46, 0x00, 
Oxff , Oxbd, 0x18, 0x81, 0x81, Oxc3, Oxdb, Oxff, 
0x00, 0x42, Oxe7, Ox7e, Ox7e, Ox3c, 0x24, 0x00, 
Oxc3, Oxc3, Oxe7, 0x81, 0x24, Oxe7, Oxc3, 0x99, 
Ox3c, Ox3c, 0x18, Ox7e, Oxdb, 0x18, Ox3c, 0x66, 
Oxff, 0x24, 0x81, 0xc3, 0x00, Oxc3, 0x81, Ox3c, 
0x00, Oxdb, 0x7e, Ox3c, Oxff , Ox3c, Ox7e, Oxc3, 
Oxe7, 0xc3, 0x5a, 0x00, 0x81, 0x81, Oxa5, Oxff, 
0x18, 0x3c, Oxbd, Oxff , Ox7e, Ox7e, Ox5a, 0x00, 
0x67, 0x67, 0x01, 0x80, Oxc2, Oxc3, Oxdb, 0x99, 
0x98, 0x98, Oxfe, Ox7f , Ox3d, Ox3c, 0x24, 0x66, 
0x73, 0x71, 0x24, 0x00, 0x83, Oxc7, 0X93, Oxc9, 
Ox8c, Ox8e, Oxdf , Oxff , Ox7c, 0x38, Ox6c, 0x36, 
0x42, 0x00, Oxdb, 0x81, 0x00, 0x42, Oxc3, 0x99, 
Oxbd, Oxff , Ox3c, Ox7e, Oxff , Oxbd, Ox3c, 0x66, 


#define UTD IMAGE TILES 22 


sif UTD ALTERNATIVE TILES 
Ox7f, Oxff,Ox7f,Oxff,Ox7f,Oxff,Ox7f,0xaa, 
Oxff,0xc3, 0x81, 0x81, 0x81, 0x99, Oxbd, Oxff, 
Ox7f, Oxfe, Ox7f, Oxfe, Ox7f, Oxfe, Ox7f , Oxfe, 
0x55, Oxff, Ox7f , Oxff , Ox7f, Oxf f, Ox7f, Oxfe, 
Ox7f, Oxff,Ox7f,Oxff,Ox7f,Oxff,Ox7f,Oxfe, 
Oxff , Oxc3, 0x99, Oxbd, Oxbd, Oxbd, Oxbd, Oxff, 
Ox7f, Oxfe, Oxff, Oxfe, Oxff, Oxfe, Oxff, Oxaa, 
0x55, Oxff , Oxff , Oxff , Oxff, Oxff, Oxff, Oxaa, 
Ox7f, Oxff, Oxff, Oxff, Oxff, Oxff, Oxff, Oxaa, 
0x55, Oxfe, Oxff, Oxfe, Oxff, Oxfe, Oxff, Oxfe, 
Ox7f, Oxfe, Oxff, Oxfe, Oxff, Oxfe, Oxff, Oxfe, 
0x55, Oxff, Oxff, Oxff, Oxff, Oxff, Oxff, Oxfe, 

" OX LELOXET ORTE y OKET, DKTP OKT f; OXEP Ox e, 

else 

Oxef, Oxf 7, Oxeb, Oxf5, Oxfa, Oxff, Oxff, Oxff, 
Oxff,0xc3, 0x81, 0x81, 0x81, 0x99, Oxbd, Oxff, 
Oxef, Oxf7, Oxef, Oxf7, Oxef, Oxf7, Oxef, Oxf7, 
Oxff, Oxff, Oxff, Oxfd, Oxfa, Oxf5, Oxeb, Oxf7, 
Oxef, Oxf7, Oxef, Oxf5, Oxea, Oxf 7, Oxef, Oxf7, 
Oxff, 0xc3, 0x99, Oxbd, Oxbd, Oxbd, Oxbd, Oxff, 
Oxef , Oxd7, Oxaf, Ox5f, Oxbf, Oxff, Oxff, Oxff, 
Oxff, Oxff, Oxff, 0x55, Oxaa, Oxf f, Oxff, Oxff, 
Oxef, Oxf7, Oxef, 0x55, Oxaa, Oxf f, Oxff, Oxff, 
Oxff, Oxff, Oxff, Ox5f, Oxaf, Oxd7, Oxef, Oxf7, 
Oxef, Oxf7, Oxef, 0x57, Oxaf, Oxf7, Oxef, Oxf7, 
Oxff, Oxff, Oxff, 0x55, Oxaa, Oxf7, Oxef, Oxf7, 

" OAE LOX TT PeT, 0X55, OXRA, XT, OXeT, OXI 

endi 


#define UTD_IMAGE_TOWERS (UTD_IMAGE_TILES + 13) 
Oxff, 0xe7, Oxdb, Oxbd, 0x99, Oxdb, Oxc3, Oxff, 
Oxff, Oxe7, 0xc3, 0x81, 0x81, Oxc3, Oxc3, Oxff, 
Oxff, 0x81, Oxbd, Oxdb, Oxdb, Oxbd, 0x81, Oxff, 
Oxff,0x81,0x81,0xc3, Oxc3, 0x81, 0x81, Oxff, 
Oxff , Oxe7, Oxdb, Oxdb, Oxbd, Oxbd, 0x81, Oxff, 
Oxff, Oxe7, 0xc3, Oxc3, 0x81, 0x81, 0x81, Oxff, 
Oxff, Oxdb, Oxa5, Oxbd, Oxdb, Oxbd, 0x81, Oxff, 
Oxff, Oxdb, 0x81, 0x81, Oxc3, 0x81, 0x81, Oxff, 
Oxff, 0x99, Oxa5, Oxbd, Oxdb, Oxdb, Oxc3, Oxff, 
Oxff, 0x99, 0x81, 0x81, Oxc3, Oxc3, Oxc3, Oxff, 
Oxff, Oxc3, Oxbd, Oxdb, Oxbd, Oxdb, Oxc3, Oxff, 
Oxff, Oxc3, 0x81, Oxc3, 0x81, Oxc3, Oxc3, Oxff, 


#define UTD IMAGE TOWERS BIG (UTD IMAGE TOWERS + 12) 
Oxff,Oxfc,0Oxf9,0xf2,0xf6, 0xf3, Oxc1, Oxcf, 
Oxff, Ox3f, Ox9f , OxAf , Ox6f , Oxcf, 0x83, Oxf3, 
Oxe1, Oxfb, Oxfb, Oxf1, Oxef, Oxe5, OxeO, Oxff, 
0x87, Oxdf , Oxdf , Ox8f , Oxf7, Oxa7, 0x07, Oxff, 
Oxff, Oxfc, Oxf8, Oxf1, Oxf1, OxFO, OxcO, Oxdf, 
Oxff, Ox3f, Ox1f, Ox8f, Ox8f, OxOF, 0x03, Oxfb, 
Oxe0, Oxf8, Oxf8, Oxf0, OxeO, Oxea, OxeO, Oxf f, 
0x07, Ox1f , OXAf , OXOf , Ox07, 0x57, 0x07, Oxff, 
Oxff,Oxf3,0xe5, Oxec, Oxe6, Oxf3, Oxfb, Oxf9, 
Oxff , Oxcf , Oxa7, 0x37, 0x67, Oxcf, Oxdf, Ox9f , 
Oxf3, Oxe1, Oxcf, Oxe1, Oxf 7, Oxed, OxeO, Oxff, 
Oxcf , 0x87, Oxf3, 0x87, Oxef , Oxb7, 0x07, Oxff, 
Oxff, Oxf3, Oxe1, Oxec, 0xe6, Oxf2, Oxf8, Oxf8, 
Oxff , Oxcf, 0x87, 0x37, 0x67, Ox4f, OXAf , Ox1f, 
Oxf0, Oxe1, Oxdf, Oxe1, Oxf0, Oxea, OxeO, Oxff, 
Ox0f , 0x87, Oxfb, 0x87, OxOf , 0x57, 0x07, Oxff, 


#define UTD IMAGE ICONS (UTD IMAGE TOWERS BIG + 16) 
Oxff,0xc3, 0x99, 0xa5, 0xa5, 0x99, Oxdb, Oxff, 
Oxff,0x99,0x81,0xa5, Oxbd, 0x99, Oxdb, Oxff, 
Oxff, Oxef, Oxc7, Oxfd, Oxf9, Oxfd, Oxfd, Oxff, 
Oxff, Oxdf, Ox8f, Oxf9, Oxfd, Oxfb, Oxf9, Oxff, 
Oxff,Oxff,0x99,0xc3, 0xe7, Oxc3, 0x99, Oxff, 
Oxff , Oxef, Oxe7, Oxe3, Oxe3, Oxe7, Oxef, Oxff, 
Oxff, Oxc3, 0x99, Oxad, Oxb5, 0x99, Oxc3, Oxff, 


#define UTD IMAGE WAVE (UTD IMAGE ICONS + 7) 
} Oxff, Oxff, Oxc7, 0x93, 0x39, Ox7c, Oxff , Oxff 
i 


UTD_PROGMEM uint8_t UTD_logo[59] = // logo image, not 8x8 


0x19, 0x12, Oxfd, 0xd5, Oxdf , Oxfc, 0x60, Oxc7, Oxec, 0x10, 0x41, Oxe3, Ox1c, 0x71, Oxdb, 
Ox8e, 0x38, Oxc7, 0x00, 0x00, 0x17, Ox7f , Oxff , Oxf7, 0x40, 0x00, 0x05, Ox4f, Oxcf, Oxb9, 
Ox6d, Oxb5, 0x56, 0x96, Oxd8, 0x89, 0x43, Ox6c, 0x44, 0xa5, Ox8e, 0x22, 0x50, Oxdf, 0x11, 
0x69, Ox3f , 0x08, Oxe5, 0x40, 0x00, 0x05, Oxd5, 0x55, 0x55, Oxf0, 0x00, 0x01, OxcO 


1 


// map tile constants: 
#define UTD_TILE_NONE 
#define UTD_TILE_ROAD_U 


0x0000 
0x0001 // road tiles can be combine with | 


#define UTD TILE ROAD R 0x0002 
#define UTD TILE ROAD D 0x0004 
#define UTD TILE ROAD L 0x0008 
#define UTD TILE START 0x0004 
#define UTD TILE FINISH 0x0008 


#define UTD TILE ROAD UD (UTD-TILE-ROAD-L 


i UTD TILE ROAD D 
#define UTD TILE ROAD LR 


UTD TILE ROAD L UTD TILE ROAD R 


/* Tower tile constants also server as tower IDs. The tower constant value 
format is following: 


MSB abcdefgh ijklmnop LSB 


- a: always 1 
- bcdefgh: targeted creep ID, only valid if attack progress !- 0 
- iji upgrade info 
- klm: attack progress, © or 1 = looking for target, © = no target 
- nop: tower type */ 

#define UTD_TOWER_GUARD 0x8000 

#define UTD TOWER CANNON 0x8001 

#define UTD TOWER ICE 0x8002 

#define UTD TOWER ELECTRO 0x8003 

#define UTD TOWER SNIPER 0x8004 

#define UTD TOWER MAGIC 0x8005 

#define UTD TOWER WATER 0x8006 

#define UTD TOWER FIRE 0x8007 

#define UTD TOWER TYPE(v) v & 0x8007 

#define UTD IS TOWER “i v_& 0x8000 

#define UTD TOWER IMAGÉ(v) UTD IMAGE TOWERS + (v & 0x07) * 2) 


#define UTD TOWER IS SMALL(v) (((V) & 0x8007) < UTD TOWER WATER) 


IM & osdofr] | (x) «« 8) 


#define UTD TOWER ATTACK PROGRESS(v) v) >> 3) & 0x07) 
#define UTD TOWER ATTACK PROGRESS SÉT(v,x) (((v) & Oxffc7) | ((x) << 3)) 


#define UTD TOWER TARGET(v) 
#define UTD TOWER TARGET. SÉT(v, x) 


#define UTD TOWERS SMALL 


6 ///< total number of small tower types 
#define UTD TOWERS 


(UTD TOWERS SMALL + 2) 


// play menu items: 


#define UTD UPGRADE1 0x0080 
#define UTD UPGRADE2 0x0040 
#define UTD PLAY MENU SELL 0x000a 
#define UTD PLAY MENU GO 0x000b 
#define UTD PLAY MENU QUIT 0x000c 
#define UTD UPGRADE NONE 0x00 
#define UTD_UPGRADE_RANGE 0x01 
#define UTD_UPGRADE_SPEED 0x02 
#define UTD_UPGRADE_DAMAGE 0x03 
#define UTD_UPGRADE_SHOCK 0x04 


#define UTD_UPGRADE_SPEED_AURA 0x05 


#define UTD_PLAY_MENU_ITEMS 13 


#define UTD_CREEP_SPIDER 0x00 

#define UTD_CREEP_LIZARD 0x01 

#define UTD_CREEP_SNAKE 0x02 

#define UTD_CREEP_WOLF 0x03 ///< freeze is less effective 
#define UTD_CREEP_BAT 0x04 ///< immune to cannon 

#define UTD_CREEP_ENT 0x05 

#define UTD CREEP SPIDER BIG 0x06 ///« spawns two small spiders when killed 
#define UTD CREEP GHOST 0x07 ///« immune to physical attack 
#define UTD CREEP OGRE 0x08 

#define UTD CREEP DINO 0x09 

#define UTD CREEP DEMON Ox0a ///« only attackable by fire/water 
#define UTD CREEPS 11 ///« total number of creep types 


void UTD loadImage(uint8 t index, uint8 t *dest) 
const uint8 t *p = UTD images + 8 * index; 
dest 4- 2; 
for (uint8 t i = 0; i < 8; ++i) 


#if SAF_PLATFORM_HARWARD 
*dest = pgm read byte(p); 
#else 
*dest = *p; 


void UTD_drawLogo(void) 


{ 
#if SAF PLATFORM HARWARD 
uint8 t img[sizeof(UTD_logo) ]; 


for (uint8 t i = 0; i « sizeof(UTD logo); ++i) 
aft img[i] = pgm read byte(UTD logo + Hn 
else 


const uint8 t *img - UTD logo; 
#endif 


.SAF drawImageiBit(img,19,6,0,SAF COLOR WHITE, 
sif SAF PLATFÜRM COLOR COUNT > 2 

SAF COLOR RED DARK, 
#else 

SAF_COLOR_BLACK, 
#endif 

9); 


/** Current map description. The format is following: 


Map specifies the layout of creep paths as a series of bytes. The format is 
following: 


- Mi map is a sequence of one of more path definitions terminated by a 0 


te. 

- A path definition starts with starting square coordinates in a single byte, 
lower 4 bits are X, upper 4 bits are Y. 

- Path segments follow, each one as a single byte of two parts: the 4 highest 
bits are the direction (0 - up, 1 - right, 2 - down, 3 - left) and the 4 
lowest bits are a square distance towards the next segment. 

- The path definition is either terminated by a © byte (end of map 

definition) 

. or 255 byte (end of path definition, another will follow). */ 

uint8 t UTD map[UTD MAX MAP. SIZE]; 


/// 2D array of current map tiles computed from the map description. 
uinti6 t UTD mapTiles[UTD MAP WIDTH * UTD MAP HEIGHT]; 


uint8 t UTD minU8(uint8 t a, uint8 t b) 


returna<b? a: b; 
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H 
void UTD playSound(uint8 t index) 

if (UTD sound) 

SAF playSound(index); 

poe UTD_buttonPressedOrHeld(uint8_t key) 

uint8_t b = SAF buttonPressed(key); 

return (b == 1) || (b >= 18); 
void UTD squarePositionTo2D(uint8 t squarePosition, int8 t *x, int8 t *y) 


squarePosition % UTD MAP WIDTH) * 8 + 4; 
squarePosition / UTD MAP WIDTH) * 8 + 4; 


void UTD interpolateCoords(int8 t *x1, int8 t *y1, int8 t x2, int8 t y2, 
uint8 t t, uint8 t tMax) 


U a a- (CC r ; 
CIS DI EEUEDEE 


uint8 t UTD canAttack(uinti6 t tower, uint8 t creepType) 
tower - UTD TOWER TYPE(tower); 


return 
// cannon can't attack flying 
!(tower == UTD TOWER CANNOÓN && creepType == UTD CREEP BAT) && 
// physical can't attack ghost 
!(creepType == UTD CREEP GHOST && 
(tower == UTD TOWER CANNON || 
tower UTD TOWER GUARD 
tower == UTD TOWER SNIPER && 
// demon can only be attacked by water or fire 
!(creepType == UTD CREEP DEMON && 
tower != UTD TOWER WATER && 
tower !- UTD TOWER FIRE); 


H 
uint8 t UTD towerColor(uinti6 t towerType) 


{ 
#if SAF_PLATFORM_COLOR_COUNT > 2 
switch (towerType) 


case UTD_TOWER_GUARD: return 0x08; break; 
case UTD_TOWER_CANNON: return 0x20; break; 
case UTD_TOWER_ICE: return 0x01; break; 


case UTD_TOWER_ELECTRO: return 0x21; break; 


case UTD_TOWER_SNIPER: return 0x00; break; 


case UTD_TOWER_MAGIC: return 0x25; break; 


case UTD_TOWER_FIRE: return 0x40; break; 


case UTD_TOWER_WATER: return 0x05; break; 


default: break; 


#else 
_SAF_UNUSED(towerType) ; 
#endif 
return SAF_COLOR_BLACK; 


uint8_t UTD_creepColor(uint8_t creepType) 


hir SAF PLATFORM COLOR COUNT » 2 
switch (creepType) 


case UTD CREEP SPIDER: return 0x20; break; 
case UTD CREEP LIZARD: return 0x04; break; 
case UTD CREEP SNAKE: return 0x01; break; 


case UTD CREEP WOLF: return 0x25; break; 


case UTD CREEP BAT: return 0x25; break; 
case UTD CREEP ENT: return 0x20; break; 

case UTD CREEP SPIDER BIG: return 0x24; break; 
case UTD CREEP GHOST: return 0x25; break; 


case UTD CREEP OGRE: return 0x20; break; 


case UTD CREEP DINO: return 0x04; break; 


case UTD CREEP DEMON: return SAF COLOR BLACK; break; 
default: break; 


#else 
_SAF_UNUSED(creepType); 
#endif 
return SAF_COLOR_BLACK; 


void UTD_getCreepStats(uint8_t creep, uint8_t *hp, uint8_t *speed, 
uint8 t *reward) 


// creep stats in a function (vs a table) avoids dealing with PROGMEM 


switch (creep) 


#define C(c,h,s,r) case c: *hp = h; *speed = s; *reward = r; break; 
UTD CREEP. SPIDER, 7,2,1 
UTD CREEP LIZARD, 8, 1, 1 
UTD CREEP SNAKE, 12, 2,1 
UTD CREEP WOLF, 20, 2, 1) 
UTD CREEP BAT, 13,1,1 
UTD CREEP ENT, 43, 4, 2 
UTD CREEP SPIDER BIG, 20, 2,2) 
UTD CREEP GHOST, 30, 3,2 
UTD CREEP OGRE, 58, 2,3 
UTD CREEP DINO, 63, 1, 3 
UTD CREEP. DEMON, 63, 1, 3) 
#undef C 
default: break; 


OQOOOOOOOOOO0 


H 

H 

/** Converts a position along a path to 2D pixel position on the map. 
© if the position is not withing the path finish (before or after), 
otherwise 1. */ 


uint8_t UTD_pathPositionTo2D(uint8_t pathStart, int16_t pathPosition, 
int8_t *x, int8_t *y) 


uint8_t *s = UTD_map + pathStart; 


Returns 


*x = (*s & OxOf) * 8 + 4; 
*y = (*s >> 4) 8 + 4; 
S++; 


r 


if (pathPosition < 0) 
eturn 0; 


while (1) // for each segment 
uint8 t segment - *s; 


if (segment -- || segment -- 255) // no more segments? 


break; 
int8 t dx = 0, dy = 0; 


switch (segment »» 4) 


case 0: dy - -1; break; 
case 1: dx - 1; break; 
case 2: dy - 1; break; 
case 3: dx = -1; break; 


default: break; 


uint8 t segmentLength - (segment & OxOf) * 8; 


if (pathPosition » segmentLength) 
*x += dx * segmentLength; 
*y += dy * segmentLength; 
pathPosition -= segmentLength; 
else 
*x += dx * pathPosition; 


*y += dy * pathPosition; 
return 1; 


Stt; 


3 
return 0; 


/** 
Py DEEnEases creep's lives and potentially sends it back to the start. 


void UTD creepEnds(uint8 t creepIndex) 
uint8 t cH = 0, cS = 0, cR = 6; 


UTD getCreepStats(UTD creeps[creepIndex].typeFreeze & OxOf 
CH, &CS, &ER); ' 


UTD Creep *c = UTD creeps + creepIndex; 
uint8 t lives = c->healthLives >> 6; 
uint8 t remove - lives -- 0; 
if (remove) 

// remove creep 


for (uint8 t i = creepIndex; i « UTD creepCount - 1; ++i) 
UTD creeps[i] = UTD creeps[i + 1]; 


UTD creepCount--; 

else 
// send creep back to start 
c->healthLives = ((lives - 1) << 6) | cH; 
c->pathPosition = -5; 

uinti6_t *tile = UTD_mapTiles; 

// correct tower targets: 

for (uint8 t i = 0; i < UTD MAP WIDTH * UTD MAP HEIGHT; ++i) 
uinti6 t t = *tile; 
if (UTD IS TOWER(t)) 

uint8 t target = UTD TOWER TARGET(t); 


if (target == cree Tndex) 
*tile = UTD TOWER ATTACK PROGRESS SET(t,0); // remove target 
else if (remove && target > ereepIndex) 
} *tile = UTD_TOWER_TARGET_SET(t,target - 1); // because creeps shifted 
tilet++; 
H 
J 
/** 


Checks a square and if it contains a tower, it progresses the tower's 
attack progress (for speed aura). 


vaid UTD speedUpTower(uint8 t square) 
uinti6 t t - UTD mapTiles[square]; 
if (UTD IS TOWER(t)) 
uint8 t attackProgress - UTD TOWER ATTACK PROGRESS(t); 


if (attackProgress > 1) 
UTD mapTiles[square] = 
: UTD TOWER ATTACK PROGRESS SET(t,attackProgress - 1); 
H 


void UTD applySpeedAura(uint8 t center) 


if (UTD updateCounter % 8 != center % 8) 
return; 


uint8 t x = center % 8; 


uint8 t 
t - center »- UTD MAP WIDTH, 


r X !- UTD MAP WIDTH - 1, 
b - center « UTD MAP WIDTH * (UTD MAP HEIGHT - 1), 
l2x!29; 

if (t) 


UTD speedUpTower(center - UTD MAP WIDTH); 
if (D 
UTD speedUpTower(center - UTD MAP WIDTH - 1); 


if (r) 
Ub speedupTower (center - UTD MAP WIDTH + 1); 
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if (1) 
UTD speedUpTower(center - 1); 
if (D 
UTD speedUpTower(center + 1); 
if (b) 
UTD speedUpTower(center + UTD MAP WIDTH); 


if (D 
UTD speedUpTower(center + UTD MAP WIDTH - 1); 


if (r) 
UTD speedUpTower(center + UTD MAP WIDTH + 1); 


H 

H 

void UTD creepFinishes(uint8 t index) 
uint8 t cH = 0, cS = 0, CR = 0; 


UTD_getCreepStats(UTD_creeps[index].typeFreeze & OxOf, 
&cH, &CS, &CR) ; 


UTD creepEnds(index); 
UTD lives -- CR; 


if (UTD lives «- 0) 
UTD gameState = ÜTD GAME STATE LOST; 


UTD playSound(SAF. SOUND BOOM); 

void UTD getTowerStats(uinti16 t tower, uint8 t *range, uint8 t *speed, 
uint8 t *damage, uint8 t *price, uint8 t *upgrades) 
// similarly to creep stats we store tower stats as a function code 


#define T(t,r,s,d,p,u1,u2) \ 
case t: \ 


if (range != 0) *range = r; \ 
if (speed != 0) *speed = s; \ 
if (damage != *damage = d; \ 
if (price != 0) *price = \ 


aoe (tower ) 


T(UTD TOWER GUARD, 30,5,2,8, UTD UPGRADE RANGE,UTD UPGRADE SPEED) 
T(UTD TOWER CANNON, 27,7,2,8, UTD UPGRADE RANGE,UTD UPGRADE DAMAGE) 
T(UTD TOWER ICE, 26,6,0,17, UTD UPGRADE SPEED,UTD UPGRADE RANGE) 
T(UTD TOWER ELECTRO, 35, 7,4, 30, UTD UPGRADE DAMAGE, UTD UPGRADE SHOCK) 
T(UTD TOWER SNIPER, 60,4,3,45, UTD UPGRADE SPEED, UTD UPGRADE RANGE) 
T(UTD TOWER MAGIC, 25,7,2,60, UTD UPGRADE DAMAGE, UTD UPGRADE SPEED AURA) 
T(UTD TOWER WATER, 40, 3, 7, 190, UTD UPGRADE RANGE, UTD UPGRADE NONE 
T(UTD. TOWER FIRE, 38,5,8,100,UTD UPGRADE RANGE, UTD UPGRADE NONE 
default: break; 
H 
#undef T 
H 


uint8 t UTD getUpgradeCost(uinti6 t tower) 


uint8 t tP - 0; 
UTD getTowerStats(UTD TOWER TYPE(tower),0,0,0,&tP, 0); 
return (tP * 2) / 3; 


void UTD getTowerInstanceStats(uinti6 t towerInstance, uint8 t *range, 
uint8 t *damage, uint8 t *speed) 


uint8 t upgrades - 0; 


UTD getTowerStats(UTD TOWER TYPE(towerInstance), 
range, speed, damage, 0, upgrades); 
for (uint8_t i = 0; i < 2; ++i) 

if (towerInstance & (i == ? UTD_UPGRADE1 : 

switch (i == 0 ? (upgrades & OxO0f) 


case UTD UPGRADE RANGE: if (range !- 0) *range += *range / 4; break; 
case UTD UPGRADE DAMAGE: if (damage != 0) *damage += *damage / 2; 


case UTD UPGRADE SPEED: if (speed !- 0) *speed -- 2; break; 
default: break; 


UTD UPGRADE2)) 
(upgrades »» 4)) 


break; 


} 


/** Gets the play menu item constant as a return value, its image in the 
pointer parameter (if non-0) and its name in a pointer parameter (if non-0, 
„needs to be at least 13 bytes). */ . i 

uint16_t UTD getPlayMenuItem(uint8 t index, uinti6 t *imageIndex, char *name) 


uinti16 t result = index; 


if (index «- 7) // small tower? 
result = (0x8000 index); 
else if (index == 8 
result = UTD UPGRADE1; 
else if (index == 
result = UTD_UPGRADE2; 


if (imageIndex != 0) 
*imageIndex = index <= 5 ? 
UTD_IMAGE_TOWERS + index * 2 + 1) 
UTD_IMAGE_ICONS + index - 6); 


if (name != 0) 


uint8_t end 


l d = 0; 
uint8_t price = 


9; 


if (UTD_IS_TOWER( result) ) 
UTD_getTowerStats(result,0,0,0,&price,0); 


switch (result) 


#define C(n,c) name[n] = c; 
case UTD_TOWER_GUARD: 
C(0,'G") C(1,'u') C(2,'a') C(3,'r') C(4,'d') end = 5; break; 
case UTD_TOWER_CANNON: 
C(0, 'C") C(1,'a') C(2, 'n') C(3, 'n') C(4, 'o') C(5, 'n' 
case UTD TOWER ICE: 
C(0,'I") C(1,'c') C(2, 'e') end = 3; break; 
case UTD TOWER MAGIC: 
C(0, 'M") C(1,'a') C(2,'g') C(3,'i') C(4,'c') end = 5; break; 
case UTD TOWER SNIPER: 
C(0,'S") C(1,'n') C(2, 'i') C(3,'p') C(4, 'e') C(5,'r') end = 6; break; 
case UTD TOWER ELECTRO: 


end - 6; break; 


C(0, 'E') C(1,'l') C(2, 'e') C(3, 'c') C(4, 't') C(5,'r') end = 6; break; 
case UTD TOWER WATER: 
C(0, 'W') C(1,'A') C(2, 'T') C(3, 'E') C(4, 'R') end = 5; break; 
C(1,'I') C(2, 'R') C(3, 'E') end = 4; break; 
C(0,'G") C(1,'0') C(2,'!') end = 3; break; 
case UTD PLAY MENU SELL: 
C(0,'S") C(1,'e') C(2, 'l') C(3, 'l') end = 4; break; 
case UTD PLAY MENU QUIT: . 
C(0, 'Q") C(1,'u') C(2,'i') C(3,'t') end = 4; break; 
case UTD UPGRADE1: 
case UTD UPGRADE2: 
uint8 t upgradeType - 0; 
uinti6 t t = UTD TOWER TYPE(UTD mapTiles[UTD cursorPos]); 
price - UTD getUpgradeCost(t); 
UTD getTowerStats(t,0,0,0,0,&upgradeType); 


upgradeType = result == UTD UPGRADE1 ? 
fupgradetype & OxOf) (upgradeType >> 4); 


switch (upgradeType) 
t case UTD UPGRADE RANGE: 
case Urb ÜPGRADE DAMAGE: CC 9.) end = ^j break; 
case ürb UPGRADE skeen: "> cor 67) end = 4j break; 
essit E i) CC '0") end = 47 bread 
'H') C(3, '0') C(4, 'K') end = 5; break; 


c(0, '+"') C S 
C(4, 'A') end = 5; break; 


; a 'S') C(2, 
eaa TO. UPGRADE SPEED. AURA. (3, 'R') 
C(O, '+ C(1,'A C(2,'U C(3,'R 
} default: anes 0; price = 0; break; 


break; 


} 


default: *name = 0; break; 


PO CH 


uint8 t UTD playMenuItemAvailable(uinti6 t item) // 


} 


name[end] = 0; 
if (price != 0) 


name += end; 


*name = ' '; 
name++; 
*name = '$'; 
name++; 


SAF_intToStr (price, name); 


} } 


return result; 


uint8_t index) 
uinti6 t tile = UTD mapTiles[UTD cursorPos]; 


if (UTD IS TOWER(item)) 


if (tile !- UTD TILE NONE) 
return 0; // can't build on non-empty tile 


uint8 t price; 
UTD getTowerStats(UTD TOWER TYPE(item),0,0,0,&price,0); 


if (price » UTD money) 
return 0; 


if ( 
UTD_cursorPos >= UTD_MAP_WIDTH) && 
UTD_cursorPos % UTD_MAP_WIDTH > 0)) 


// big tower blocks the space? 


uinti6 t t = UTD mapTiles[UTD cursorPos - 1]; 
if (UTD IS TOWER(t) && !UTD TOWER IS SMALL(t)) return 0; 


t - UTD mapTiles[UTD cursorPos - UTD MAP WIDTH]; 

if (UTD IS TOWER(t) && !UTD TOWER IS SMALL(t)) return 0; 
t - UTD mapTiles[UTD cursorPos - UTD MAP WIDTH - 1]; 

n if (UTD IS TOWER(t) && !UTD TOWER IS SMALL(t)) return 0; 


if (!UTD TOWER IS SMALL(item)) 


if ( // big towers need 2x2 squares space 
UTD cursorPos % UTD MAP WIDTH == UTD MAP WIDTH - +) | 
UTD_cursorPos >= (UTD_MAP_HEIGHT - 1) * UTD_MAP_WIDTH) || 
UTD mapTiles[UTD cursorPos + 1] != QTD TILE NONE) p! 
UTD mapTiles[UTD cursorPos + UTD MAP WIDTH] != UÍD TILE NONE) || 
UTD mapTiles[UTD cursorPos + UTD MAP WIDTH + 1] !- UTD TILE NONE) 


return 0; 


l NET 
else if (item -- UTD UPGRADE1) 
return (UTD IS TOWER(tile) != 0) && ((tile & UTD UPGRADE1) == 0) && 
(UTD getUpgradeCost(UTD TOWER TYPE(tile)) «- UTD money); 
else if (item == UTD UPGRADE2) 
return UTD IS TOWER(tile) && UTD TOWER IS SMALL(tile) && 
(tite & UTD UPGRADE) == 0) && : 
TD getUpgradeCost(UTD TOWI RETYPE (tile ) <= UTD money); 
else if (item == UTD_PLAY_MENU_SELL) // sel 
return (UTD IS TOWER(tile) != 0); 


return 1; 


void UTD addCreep(uint8 t creep, uint8_t pathIndex, int16_t position, 


{ 


uint8_t lives) 


if (UTD_creepCount >= UTD_MAX_CREEPS) 
return; 


UTD_Creep *c = UTD_creeps + UTD_creepCount; 
uint8_t cH = 0, cS = 0, CR = 0; 
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UTD map[i] = 


0; 
UTD getCreepStats(creep, &cH, &CS, &CR) ; Ui It 9: 
menuItem = 


m i 
c->typeFreeze = creep, UID-cursorPos z UTD.-MAP-WIDTH xd 
c->healthLives = (lives << 6) | cH; | cameraPos = 
c-»pathPosition - position; Urb-creepcount ane 

an d L4 


UTD round = 0; 
UTD | gameState' = UTD GAME STATE PLAYING; 


c->pathStart = 0; 
whi e (pathIndex > 0) switch (index) 


while (UTD_map[c->pathStart] != © && UTD_map[c->pathStart] != 255) 


c->pathStart++; // by initializing maps in code we also avoid dealing with PROGMEM 


0: 

if (UTD map[c-»pathStart] == 255) cas? z 
: co>pathstart+; UTD mapli] = Ox28. 
c->pathStart = 0; UTD-mab d = Orani 
UTD map[4] = 0x18; 
pathIndex--; UTD map[5] = 0x22; 
UTD map[6] - 0x35; 
UTD map[7] = 0x23; 
UTD_creepCount++; UTD_map[8] = 0x17; 
UTD_map[9] = 0x05; 


uint8_t UTD_cycleCreeps(uint8_t index, 
if (levelFrom >= UTD CREEPS) 


uint8 t levelFrom, uint8 t levelTo) UTD lives - 20; 
UTD money - 10 


UTD backColor = Oxfe; 


levelFrom = UTD CREEPS - 1; break; 
if (levelTo »- UTD CREEPS) case 1: 
lévelTo = UTD CREEPS - 1; UTD map[0] = 0x11; 
UTD map[1] = 0x22: 
i D 2 : UTD map[2] = 0x17 
return levelFrom + (index % (levelTo levelFrom * 1)); UTD-map|3] = 0x21: 
UTD-map[S] = 0x22! 
)_ map = 0x 
void UTD_c cLingspawn ( ES 
uint8 Uto // total number of creeps to spawn UTD-mab $ 3 oxa 
uint8_t tetetErom, // minimum level of a creep UTD map|8] = 0x32: 
uint8_t levelTo, // maximum level of a creep UTD map 9] = 0x02: 
uint8 t maxLives, // maximum number of lives for a creep UTD map[18] = 0x34: 
uint8 t positionüffset, // gaps between creeps UTD map 11] = Oxff* 
ae groupSize // affects additional gaps and creep lives = 
{ UTD_map[12] = 
total = UTD_minU8(UTD_MAX_CREEPS, total); UTD map[13] = 
inti6 t position = -1 * positionOffset; UTD map[14] = 
UTD map[15] = 
for (uint8_t i = 0; i < total; ++i) UTD-mab 16] = 
if (i 96 groupSize == 0) UTD-mab 18] 
position -= positionOffset; UTD map[20] 
UTD map[21 
UTD addCreep( UTD map[22] 
UTD cycleCreeps(i, levelFrom, levelTo), map 
i,position,i % groupSize == 0 ? UTD minU8(S3,maxLives) 0); UTD lives = 25: 
d i 
UTD money - 10; 
position -- positionOffset; UTD-backto or = Oxde; 
j break; 
r : case 2: 
void UTD goToMenu(void) UTD map[0] = 0x11; 
UTD map[1] = 0x25; 
UTD | gamestate | = UTD GAME STATE MENU; UTD map[2] = 0x12; 
UTD menuItem = .8; UTD map[3] = 0x02; 
} UTD_backColor = Óxff; UTD_map[4] = 0x12; 
UTD map[5] = 9x22; 
UTD map[6] = 0x13 
void UTD spawnCreeps(void) UTD map[7] = 0x03; 
UTD map[8] = 0x32; 
UTD creepCount - 0; UTD map[9] = 0x02; 
UTD map[10] - 0x33; 
pen (UTD. mapIndex) UTD map[11] = Oxff; 
case 0: UTD map[12] = Ox1e 
case 1: UTD_map[13] = 0x34; 
UTD_map[14] = 0x25; 
er eTe Coan eae + UTD round,UTD round / 4, UTD map[15] = 0x12; 
UTD round « 15 ? UTD | minUB(UTD | CREEP DINO - 1,UTD round) UTD round, UTD map[16] - 0x03; 
B UT round / 5,10,5); uro map 17] = oxis 
reak; | map - 0x23; 
UTD lives - 20; 
case 2: UTD money - 10; 
UTD backColor - Oxdf; 
uint8 t total = UTD minU8(1 + UTD round, (UTD MAX CREEPS * 2) / 3); break; 
i = -10: case 3: 
INELGE possi tO, UTD map[0] = 0x72; 
for (uint8 t i = 0; i « total; ++i) romana = oxic? 
uint8.t c = UTD cycleCreeps(i,UTD round / 3, (UTO round * 2) / 3); UTD-mabl4] = 0x37? 
uint8 t l = TD minU8(3,UTD . round / 7) 0; UTD map[5] = 0x06; 
UTD map[6] = 0x32; 
UTD addCreep(c,0, pos, 1); UTD map|7] = 0x22; 
UTD map[8] = 0x34; 
pos -- 10; UTD map[9] = 0x01; 
UTD map[10] = 0x13; 
if idis UTD map[11] = Oxff; 
uti | Md CP Rene; 1,pos, 1); 
UTD map[12 0x72; 
UTD map[13 0x02; 
break: UTD map[14 Oxic; 
} * UTD map[15 0x22; 
UTD map[16 0x37; 
A UTD map[17 0x06; 
case 3: : " " UTD map[18 0x12; 
UTD_cyc LingSpawn (3 + UTD round 2,UTD round / 3,(UTD round 4) / 5, UTD map[19 0x22; 
UTD_roun / 8,7,4); UTD map[20] = 0x14; 
Bt Ea] Qiu 
| map - X 
case 4: 
A UTD cyclingSpawn(8 + UTD round * 2,UTD round / 3,2 + (UTD round * 4) / UTD lives - 25; 
, = 93 
UTD round / 8,10,4); UTD-backtolor/- Oxfb; 
break; break; 
case 5: case 4 
UTD cyclingSpawnt(1 + UTD round / 2) * 2,1 + UTD round / 3, UTD-map[0] = 9x44; 
1 + UTD round,UTD round / 8,15,5 UTD_map ft 0x02, 
roun roun H UTD-ma 2 = 9x33; 
ma = 0x 
UTD_cyc LingSpawn (UTD round * 2,UTD round / 4,UTD round / 2, UTD mab 4] = 0x15; 
: UTD-roun 8,8,4); UTD map[5] = 0x05; 
reak; UTD map[6] = 0x12; 
UTD map[7] = 0x25; 
H UTD_map[8] = 0x13; 
j UTD map[9] = 0x05; 
UTD map 25] - 0x13; 
void UTD loadMap(uint8 t index) UTD map[11] = Oxff; 
for (uint8 t i = 0; i < UTD MAX MAP SIZE; ++i) UTD map[12] = 0x6d; 
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UTD map[13] - 0x03; 
UTD map[14] = 0x35; *currentTile - UTD TILE FINISH; 
UTD map[15] - 0x23; *pathStartTile - UTD TILE STARÍ; 
UTD map[16] - 0x32; ) 
UTD map[17] - 0x03; 
UTD map[18] - 0x31; 
UTD map[19] = 0x02; } 
UTD map[20] = 0x33; M E p d r 
UTb-map|21] = 0x23: uint8 t UTD isWithinRange(int8 t x, int8 t y, int8 t x2, int8 t y2 
( uint8 t range) 
UTD lives = 30; 
UTD-money z 22: e. X = (X >= x2) 7? (x-x2) : (xX2- x); 
ackColor = Oxbe; 
break; é // first quickly test Chebyshev distance: 
case 5: if (x <= range) 

UTD map[0] = 0x55; 
UTD map[1] = 0x34; - >= y2) ? - y2) : 2 - 
UTD-mab 2| z x04! y-(y y2) ? (y - y2) : (y y); 
UTD map[3] = 0x13; // now test proper Euclidean distance: 
UTD map[4] = 0x21; if (y <= range && SAF_sqrt(x * x + y * y) <= range) 
UTD map[5] = 0x15; return 1; 
UTD map[6] = 0x01; á 
remap NE 

_map = 0x23; 
UTD-map[9] = 0x11: y eeun co; 
UTD map[10] = 0x22; 
UTD-mab 12] = oxes: #define UTD DRAW MODE WHOLE © 
UTD-map[13] = 0x34: #define UTD DRAW MODE TOP 1 

N i 
UTD mab[14] = Oxff. #define UTD_DRAW_MODE_BOTTOM 2 

ES š void UTD drawImage(uint8 t x, uint8 t y, uint8 t imageIndex, uint8 t colori 

Urb-mabliel = exili , vinta color2, üinté t transform, uintB t hasMask, uint8 t mode) : 

z ; 
UTD-mab = Oxia! UTD loadImage(imageIndex,UTD ramImage) 
UTD map = 0x22; t uint8 t * kaio 
UTD map = 0x16; const uint8 t "mas ; 
UTD map = 60x02; 
UTD map = 0x31; if (hasMask) 
UTD_map = 0x03; 
UTD_map = 0x35; UT "load Image (image tndex * 1,UTD ramMask) 
UTD map = 0x21; mask = UTD_ramMask; 
UTD_map = 0x35; } 
UTD_map = 0x01; 
UTD_map = 0x33; i == 
UTD map Z 0x24! if (mode UTD DRAW MODE TOP) 
UTD map = 0x13; E 
UTD map = 0x01! pTD ramtmage[1] = 4; 
UTD_map = 0x11; } f 

: else if (mode == UTD DRAW MODE BOTTOM) 
UTD lives - 1; 
UTD money - 30; UTD ramImage[1] - 4; 
UTD backColor = Oxda; += 4: 
break; hasmask = 0; 
default: break; for (uint8 t i= 2; i < 6; ++i) 


UTD_ramImage[i] = UTD_ramImage[i + 4]; 


// create the tilemap: 
SAF_drawImage1Bit (UTD_ramImage, x, y,mask, colori, color2, transform); 
for (uint8 t i = 0; i < UTD MAP WIDTH * UTD MAP HEIGHT; ++i) 


UTD mapTiles[i] = UTD TILE NONE; UTD ramImage[1] = 8; 
H 
uint8 t *b - UTD map; 
uint8 t end - 0; void SAF init(void) 
while (!end) // for each path UTD sound = 1; 
{ UTD_goToMenu( J; 


uint16_t *currentTile = UTD mapTiles + 
(*b >> 4) * UTD MAP WIDTH + (*b & OxOf); 
void UTD drawTower(uinti6 t tower, uint8 t x, uint8_t y) 


uinti6 t *previousTile - currentTile; SM 
uinti6 t *pathStartTile = currentTile; uinti6 t imageIndex = UTD TOWER IMAGE(tower); 
be; uint8 t c = UTD towerColor(UTD TOWER TYPE(tower)) 


; 
while (1) // for each segment 


: if (UTD TOWER IS SMALL(tOwer)) 
uint8 t v - *b; { 


btt; UTD drawImage(x,y,imageIndex + (tower & UTD UPGRADE1 ? 1 : 9), 
UTD backColor,c,0,0,UTD DRAW MODE TOP); 
if (v == 0) // end of map? 
UTD drawImage(x,y,imageIndex + (tower & UTD UPGRADE2 ? 1 : 9), 


end = 1; UTD backColor,c,0,0,UTD DRAW MODE BOTTOM) 
break; 
d 
if (v == 255) // end of segment? if (UTD TOWER TYPE(tower) == UTD TOWER FIRE) 
break; imageIndex = UTD IMAGE TOWERS BIG + 8; 
int8 t tileShift - 0; if (tower & UTD UPGRADE1) 
E imageIndex += 4; 
uinti6 t di = UTD TILE ROAD U, 
d2 - UTD TILE ROAD D; #define drawPart(px,py) \ 
UTD-drawImage(x * Pl * by imageIndex, UTD_backColor,c,\ 
switch (v >> 4) . 0,0, UTD DRAW MODE WHOLE);V 
imageIndex++; 
case 0: 
tileShift = -1 * UTD_MAP_WIDTH; drawPart(0,0 
break; drawPart(8,0 
drawPart(0,8 
case 1: drawPart(8,8 
tileShift = 1; 
di = UTD TILE ROAD R; #undef drawPart 
d2 = UTD TILE ROAD L; } 
break; } 
case 2: void UTD draw(void) 
tileshift - UTD MAP WIDTH; 1 . 
di - UTD TILE ROAD D; /* Someone once said: "Do not write functions longer than one screen." 
d2 = UTD TILE ROAD U; He was a stupid man. */ 
break; 
SAF clearScreen(UTD backColor); 
case 3: 
tileShift - -1; Switch (UTD gameState) 
di - UTD TILE ROAD L; 
d2 = UTD TILE ROAD R; case UTD GAME STATE MENU: 
break; { 


UTD_drawLogo(); 
default: break; 
' int8_t pos = 0 - (SAF_frame() % 8); 


for (uint8 t i = 0; i < (v & 0x0f); ++i) for (uint8 t i = 0; i < 9; ++i) // draw the wave 
previousTile = currentTile; UTD drawImage(pos,28,UTD IMAGE WAVE 
currentTile += tileShift; SAF_COLOR_WHITE, SAF_COLOR_BLUE_DARK, 0, 0, 0) 
*previousTile |= d1; pos += 8; 
*currentTile |= d2; H 


} 
} 
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SAF drawRect(0,40,SAF SCREEN WIDTH, 6,SAF COLOR GRAY. DARK, 1); 
if (UTD IS TOWER(v)) // tower? 


char t[10] = "MAP x"; 
uint8 t attackProgress - UTD TOWER ATTACK PROGRESS(v); 


if (UTD menuItem -- UTD MAPS) 
t d (attackProgress !- 0) 


t[0] = 'S'; t[1] = 'N'; t[2] = 'D'; t[3] = ':'; 
t[4] 9 tet: UTD Creep c - UTD creeps[UTD TOWER TARGET(v)]; 
if (UTD sound) int8-t.cX, .cY; tX; tY; 
t[5] = 'n'; t[6] = 0; UTD pathPositionTo2D(c.pathStart,c.pathPosition,&cX, &cY) ; 
dis UTD squarePositionTo2D(squarePos, &tX, &tY) ; 
{ cX -= cameraPixelOffset; 
t[5] = 'f'; t[6] = 'f'; t[7] = 6; tX -= cameraPixelOffset; 
Tisa if (!UTD TOWER IS SMALL(v)) 
t[4] = '1' + UTD menuItem; 
tX += 4; 
ty += 4; 


if (UTD_menuItem < UTD_MAPS) 
SAF drawText(t,18,41,SAF COLOR YELLOW, 1); 
uint8 t speed; 
t[0] = 'b'; t[1] = 'e'; t[2] = 's'; t[3] = 't'; t[4] = ':'; t[5] 2 ' "5 
SAF intToStr(SAF load(UTD menuItem),t + 6); 
SAF drawText(t,1,59,SAF COLOR GRAY DARK, 1); 


UTD getTowerInstanceStats(v,0,0,&speed); 
switch (UTD TOWER TYPE(v)) 


} case UTD_TOWER_GUARD: 
else UTD. EM uud qn rar attackProgress, speed); 
SAF drawText(t,15,41,SAF COLOR YELLOW, 1); SAF drawPixel(cX,cY,SAF COLOR BLACK) 
break; if (cY !- tY && (cX - tX) / (cY - tY) !- 0) 
} CX++; 
else 
gee UTD_GAME_STATE_LOST: cY++; 
char t[15]; BAL. drawPixe (cX, CY, SAF. COLOR BLACK) 
reak; 
ae reve storing Port ee og Arduino with thig one weird griek, j, 
= i = ; F ; = ; = 1 = 1; case UTD_TOWER_CANNON : 
f =n th = '\nl; HEEL dc = 'r'; t[10] Sito") UTD_interpolateCoords(&cX, &cY, tX, tY, attackProgress, speed); 
tí11] = 'u'; t[12] = 'n'; t[13] = 'd'; t[14] = 0; SAF_drawPixe CX, CY, 0x00 
+ 
SAF_drawText(t,12,14,SAF_COLOR_BLACK, 1); Sar drawpixe Pere uy 
t SAF drawPixel(cX + 1,cY + 1 x6d); 
SAF drawText(SAF intToStr(UTD round,t),UTD round < 10 ? 29 : 23,31, break; 
SAF COLOR BLACK, 2); 
case UTD TOWER ICE: 
break; UTD interpolateCoords(&cX, &cY, tX, t Y, attackProgress, speed); 
} SAFE drawPixe (cX, cY, SF. COLOR. BLUE) ; 
CX++; CY--; 
case UTD GAME STATE CONFIRM QUIT: SAF drawPixel(cX,cY,SAF COLOR BLUE) 
case UTD GAME STATE PLAYING: cY += 2; 
case UTD_GAME_STATE_PLAYING_MENU: SAF ! drawPixe (cX,cY,SAF COLOR BLUE) 
case UTD GAME STATE PLAYING WAVE: CX -- 2; 
{ SAF | drawPixe (cX, cY,SAF. COLOR BLUE) 
uinti6 t *tile = UTD mapTiles + UTD cameraPos; cY 
SAF drawPixe (cX, cY, SAF_COLOR_BLUE) ; 
// draw tiles: break; 
: X fpa $ = case UTD_TOWER_MAGIC: 
for (uint&_t y = 8; y < 64; y += 8) UTD amber po larecoords (acy, 8 &cY, Dou v Bktackbrogréss, speed) ; 
i - . . - rawCirc Le(c * c rame 
for (uint8_t x = 0; x < 64; x += 8) break; 
inti6 t = *tile; 
eee od qase UTD TOWER SNIPER! 
if (v !- UTD TILE NONE) UTD Tange pnolarecacrderepe &cY, tX, tY, jou pP MCA Speed); 
: UTD interpolateCoords(&tX &tY, cX, CY,SAF frame % 8,8 
if ufi dranTower (013) S tower? SAF drawLine(cX,cY, tX, tY, 0x62) ; 
else // path "e break; 
UTD drawImage(x,y UTD.. IMAGE TILES - 3 * v, 
UTD_backColor, (v == UTD TILE START || v —- UTD TILE FINISH) ? fore (UTD TONERCATTAGK:  PROGRESS(v) > 2) 
SAF COLOR BLACK : SAF_COLOR_GRAY_DARK, 0, 0,0); B ' drawLine(tX,tY, 
H 
) CX - 1 + SAF rahel) % % 3, gf) - 1 + SAF frame() % 4, 
SAF_frame() % 2 ? Ox Ox5f 
: break; 
tilet++; 
case UTD_TOWER_WATER: 
tile += UTD_MAP_WIDTH - 8; UTD_interpolateCoords(&cX, &cY, tX, tY, rattackProgress, speed) ; 
SAF_drawCircle(cX - 2 + SAF  frame() % 2,cY - 3,0x01 + 
attackProgress / 2,1); 
UTD Creep *c = UTD creeps; } break; 
// draw creeps: 
. case UTD TOWER FIRE: 
int8 t cameraPixeloffset = UTD_cameraPos * 8, 
xMin = (UTD_cameraPos - 1) * 8; UTD interpolateCoords(&cX, &cY, tX, tY, attackProgress, speed); 
uint8 t uint8 t r = (9 - attackPro ress); 
xMax = (UTD_cameraPos + 8) * 8; // this might not fit into signed byte uint8_t shift = SAF_frame() % 2; 
for (uint8_t i = 0; i < UTD_creepCount; ++i) for (int8_t dX = cX - r / 2 + shift; 
> dX < cX -r / 2+ r + shift; ++dX 
int8 t x, y; for (int8 t dY = cY -r / 2; dY«cY-r/2-*r; ++dY) 
i sher random las, an”) 
if (UTD pathPositionTo2D(c-»pathStart,c-»pathPosition,&x,&y) && 2 rawPixe 
E = #if SAF PLATFORM COLOR. COUNT == 2 
x >= xMin && x <= xMax) : SAF. COLOR. BLACK 
i MESE : "else 
uint8 t cType c->typeFreeze & Ox0f; SAF_COLOR_RED 
UTD_drawImage( sendif ) 
Y - cameràPixelOffset - 4, 
zo 5oct 
a c->pathPosition >> 3) & 0x01) = break; 
(UTD_updateCounter >> 2) & 0x01)), } 
UTD_IMAGE_CREEPS + cType * 2, 
#if SAF PLATFORM COLOR COUNT > 2 default: break; 
0x77, F 
#else } 
SAF_COLOR_WHITE, } 
#endif 
uTD_creepColor (cType), 0,1,0); squarePos++; 
tile++; 
c++; I 
H 


uint8 t cursorX 
tile - UTD | mapTiles; cursorY 
uint8 t squarePos - 0; 


(UTD cursorPos - UTD cameraPos) % UTD MAP WIDTH) * 8, 
UTD cursorPos / UTD MAP WIDTH) * 8; 


for (uint8 t i = 0; i < 7; ++i) // cursor 


uint8 t c = ( (SAF frame() >> 3) + i) % 3) ? 
for (uint8_t y = 0; y < 64; y += 8) SAF COLOR | : UTD backColor; 


// draw projectiles: 


^ j SAF drawPixel(cursorX + 7,cursorY + i, 9 
uinti6 t v = *tile; SAF drawPixel(cursorX + 7 - i,cursorY + 7,c) 
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for (uint8_t x = 0; x « 128; x += 8) SAF. STAHL cursor + i,cursory,c); 


SAF drawPixel(cursorX,cursorY * 7 - i,c); 


// draw health bars: 


if (SAF buttonPressed(SAF BUTTON B)) 
C = UTD creeps; 
for (uint8 t i = 0; i « UTD creepCount; ++i) 
int8 t x, y; 


if (UTD pathPositionTo2D(c-»pathStart,c-»pathPosition,&x,&y) && 
( x »- xMin && x «- xMax) 


uint8 t cH,cS,cR; 
UTD | getcreepstats(c- >typeFreeze & OxOf,&cH,&cS,&CR); 


x= x - cameraPixelOffset - 4; 
-= 7: 
SAF drAwRect (x, y,8, 3, SAF. COLOR. BLACK, 1); 


X++; 
t ga 


uint16_t hp = c->healthLives & Ox3f; 
= (hp * 5) / cH; 


} SAF drawLine(x,y,x + hp,y,SAF COLOR RED); 


j Ctt; 
3 


// draw bar and menu: 


uint8 t barY = UTD cursorPos >= UTD MAP WIDTH ? 1 : SAF SCREEN HEIGHT - 


if (UTD gameState == UTD GAME STATE PLAYING MENU || 
UTD gameState == UTD GAME STATE CONFIRM QUIT) 


barY = 1; 
uint8_t menuY = SAF_SCREEN_HEIGHT - 9; 


uint8_t drawRadius = 0; 
uint8_t centerOffset = 4; 
char itemName[13]; 


uinti6 t item = UTD getPlayMenuItem(UTD menuItem,0,itemName); 
if (UTD playMenuItemAvailable(item)) 
d (UTD IS TOWER(item)) 


if ute te frame() & 0x08) 
D_drawTower (item, cursorxX, cursory); 


UTD getTowerStats(item,&drawRadius,0,0,0,0); 


if (!UTD TOWER IS SMALL(item)) 
centerOffset - 8; 


l 
else if (item == UTD UPGRADEi1 || item == UTD UPGRADE2) 
// preview range upgrade 
UTD getTowerInsStanceStats(UTD mapTiles[UTD cursorPos] | item, 
} &drawRadius, 0,0); 
H 
if (drawRadius == 0) 
uinti6 t tile = UTD mapTiles[UTD cursorPos]; 
if (UTD IS TOWER(tile)) 


uint8 t tD,tS; 
UTD getTowerInstanceStats(tile,&drawRadius,&tD,&tS); 


H 
H 
if (drawRadius !- 0) 
F drawCircle(cursorX + centerOffset,cursorY + 
centeroffset, drawRadius, 
SAF COLOR | BLACK, 0); 
SAF drawCircle(cursorX + centerOffset,cursorY + centerOffset, 
SAF frame() % drawRadius,SAF COLOR BLACK, 0); 


SAF drawRect(0,menuY,SAF SCREEN WIDTH, 

9, SAF. COLOR BLACK, 1); 
SAF drawLine(0,menuY,SAF SCREEN WIDTH, menuY,SAF COLOR BLACK); 
uint8 t menuOffset - UTD menuItem » 3 ? UTD menuItem - 3 : 0; 


if (menuoffset > 5) 
menuOffset 5; 


menuY++; 

SAF_drawRect(0,SAF_SCREEN_HEIGHT - 15,SAF_SCREEN_WIDTH, 6, 
UTD_backCo or, 1); 

SAF. _drawText(itemName, 1,SAF_SCREEN_HEIGHT - 14,SAF_COLOR_BLACK, 1); 

for (uint8_t i = 0; i < 8; ++i) // play menu items 


uint16_t icon = 0; 


uint8_t itemIndex = i + menuOffset; 
uinti6 t item = UTD_getPlayMenuItem(itemIndex, &icon, 0); 


uint8 t c1 
c2 


SAF COLOR WHITE, 
SAF. COLOR BLACK; 


uint8 t highlightPos - UTD menuItem - menuOffset; 
if (highlightPos -- i) 


ci SAF COLOR BLUE DARK; 
c2 SAF. COLOR GREEN; 


} 


uint8 t drawX = i * 8; 
UTD drawImage(drawX,menuY, icon, c1,c2,0,0,0) 


if (!UTD_ ptayMenurtemAvaslab le item) 
for (uint8 t iz menuY; y < menuY + 8; ++y) 
for (uint8 t x - drawX; x < drawX + "8; MX) 
if (x % 2 == y % 2) 
j SAF. | drawPixel(x, y, SAF COLOR BLACK); 
} 


if (UTD_gameState == UTD_GAME_STATE_CONFIRM_QUIT) 
SAF. irae 10,40,20,SAF COLOR BLACK, 1 


SAF_drawRect (13,11, 38, 18, SAF_COLOR_WHITE, 1 
SAF_drawText ("QUIT?", 19, 18, SAF_COLOR_BLACK, s 


char text[8] = "$..."; 


SAF intToStr(UTD money,text + 1); 
SAF drawText(text,1,barY,0x0c, 1); 


SAF_intToStr(UTD_round, text ) 
SAF_drawText (text, 37, bary, Hm 1); 


SAF intTOStr(UTD lives,text 
SAF drawText(text,SAF | SCREE Í WIDTH - 10,barY, 


#if SAF PLATFORM COLOR i COUNT -- 


SAF. COLOR BLACK, 


#else 
0x80, 
#endif 
break; 
3 


ae UTD towerHits(uinti6 t tower, uint8_t isSplash) 


uint8 t tD - 0; 
UTD | getTowerInStanceStats(tower, 0, &tD,0); 


UTD TOWER TARGET(tower ) 
UTD creeps[creepindex]. l ealthLives & Ox3f; 


UTD TOWER TYPE(tower); 


uint8 t creepIndex 
uint8 t creepLives 


uinti6 t towerType 


if (towerType -- UTD TOWER ICE || 
(Ege Type -- UTD TOWER ELECTRO && (tower & UTD UPGRADE2) 
(SAF random() % 4 == 0))) 
// freeze / shock 
UTD creeps[creepIndex].typeFreeze - 
(UTD | creéps[creepindex | t typeFreeze & Oxof) } 


(euro cheeps[creepindex .typeFreeze & 0x0 


) == UTD_CREEP_WOLF ? 
X70 : OxfO); // ^ wolves get frozen for sho 


rter time 


l 
else if (towerType == UTD TOWER WATER && SAF random() 96 10 == 9) 
UTD_creeps[creepIndex].pathPosition -= 10; // a wave can knock creeps back 


if (isSplash) 
tD /= 2; // splash deals half the damage 


if (tD >= creepLives) // splash can't kill, it would complicate the loop 
tD = creepLives - 1; 


else 
if (towerType == UTD_TOWER_CANNON || towerType == UTD_TOWER_FIRE) 
í int8 t x, y; 
UTD Creep *c = UTD creeps + creepIndex; 
UTD pathPositionTo2D(c-»pathStart,c-»pathPosition,&x,&y); 
C = UTD creeps; 
for (uint8 t i = 0; i « UTD creepCount; ++i) 
if (i != creepIndex && UTD canAttack(tower,c-»typeFreeze & OxOf)) 
int8 t x2, y2; 
UTD pathPositionTo2D(c-»pathStart,c-»pathPosition,&x2,&y2); 
if (UTD isWithinRange(x,y,x2,y2,UTD SPLASH RANGE)) 
UTD towerHits(UTD TOWER TARGET. SET(tower,i),1); 


j Crt; 
3 
3 


if (tD >= creepLives) 


uint8_t c,cH,cS,cR; 
UTD Creep creep = UTD creeps[creepIndex]; 


c = creep.typeFreeze & Ox0f; 
UTD | getCreepStats(c, &cH, &cS, ,&cR); 


UTD money += CR; 


UTD creepEnds SEP BID de XM éj oe dies 
UTD_p LaySound(SAF_SOUND_BUMP 


if (c == UTD_CREEP_SPIDER_BIG) 
// big spider will spawn two small ones 


UTD addCreep(UTD CREEP SPIDER,creep.pathStart,creep.pathPosition,9); 
UTD addCreep(UTD CREEP SPIDER,creep.pathStart,creep.pathPosition - 5,9); 


else 
creepLives -- tD; 


UTD creeps[creepIndex].healthLives - 
(UTD | creeps[creepIndex]. healthLives & 0xc0) | creepLives; 


Lione UTD gameStep(void) 
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switch (UTD gameState) 
case UTD GAME STATE PLAYING MENU: 
t if (SAF buttonJustPressed(SAF BUTTON B)) 
UTD gameState - UTD GAME STATE PLAYING; 
return; 
uinti6 t item = UTD getPlayMenuItem(UTD menuItem, 0,0); 


if (SAF buttonJustPressed(SAF BUTTON A) && 
UTD playMenuItemAvailable(item)) 


ra (UTD IS TOWER(item)) 


// build tower 
UTD mapTiles[UTD cursorPos] - item; 


uint8 t tP; 
UTD | getTowerStats(item, 0,0,0,&tP,0); 


UTD money -- tP; 
UTD gameState - UTD GAME STATE PLAYING; 


j UTD playSound(SAF SOUND CLICK); 
else if (item == UTD UPGRADE1 || item == UTD UPGRADE2) 


UTD mapTiles[UTD cursorPos] |- item; 

UTD money -= UTD ! getUpgradeCost(UTD mapTiles[UTD cursorPos]); 
UTD gameState = TTD. GAME_STATE_PLAYING; 

UTD playSound(SAF. SOUND CLICK); 


due if (item == UTD PLAY MENU SELL) 


uint8 t tP - 0; 
UTD D getTowerSt&Es UTD. TOWER TYPE(UTD mapTiles[UTD cursorPos]),0,0,0, 


UTD mapTiles[UTD cursorPos] - UTD TILE NONE; 


UTD money += tP / 2; 
UTD gameState - UTD. GAME_STATE_PLAYING; 
UTD. playSound(SAF. SOUND. BOOM) ; 


l 
else if (item == UTD PLAY MENU GO) 


UTD updateCounter - 0; 

UTD | spawnCreeps(); 

UTD gameState - UTD GAME STATE PLAYING WAVE; 
UTD playSound(SAF. SOUND BEEP); 


l 
élse if (item == UTD PLAY MENU QUIT) 


} UTD_gameState = UTD_GAME_STATE_CONFIRM_QUIT; 
} 
if (UTD buttonPressedOrHeld(SAF BUTTON RIGHT)) 
UTD menuItem = (UTD menuItem < UTD PLAY MENU ITEMS - 1) ? 
UTD menuItem + 1 0; 
else if (UTD | buttonPressedorHeld(SAF. BUTTON LEFT)) 


UTD menuItem = (UTD menuItem > ©) ? UTD menuItém - 1 : 
UTD PLAY MENU ITEMS - 1; 


break; 


3 
case UTD_GAME_STATE_LOST: 
if (SAF_buttonJustPressed(SAF_BUTTON_A) || 
SAF_buttonJustPressed(SAF_BUTTON_B) ) 
UTD_goToMenu(); 
break; 


case UTD_GAME_STATE_CONFIRM_QUIT: 
if (SAF_buttonJustPressed(SAF_BUTTON_A) ) 


í UTD goToMenu 
UTD aa end iar SOUND BUMP); 


élse if (SAF buttonJustPressed(SAF BUTTON B)) 
UTD gameState - UTD GAME STATE PLAYING MENU; 


break; 
case UTD GAME STATE MENU: 
uint8 t click - 
if (UTD buttonPressedOrHeld(SAF BUTTON RIGHT)) 
UTD menuItem = (UTD menuItem + à % (UTD MAPS + 1); 
else if (UTD. buttonPressedOrHeld(S F | BUTTON |_LEFT) ) 
UTD menuItem = UTD menuItem == © ? UTD MAPS : (UTD menuItem - 1); 
else if (SAF buttonJustPressed(SAF BUTTON A)) 
if (UTD menuItem « UTD MAPS) 
UTD loadMap(UTD menuItem); 
else 
UTD sound = !UTD sound; 


else 
click - 


if (click) 
UTD playSound(SAF. SOUND CLICK); 


break; 


} 


case UTD_GAME_STATE_PLAYING_WAVE: 
case UTD_GAME_STATE_PLAYING: 


{ 
if (UTD gameState == UTD GAME STATE PLAYING WAVE) 
UTD updateCounter-*; 


UTD Creep *c - UTD creeps; 

// update creeps: 

for (uint8 t i = 0; i « UTD creepCount; ++i) 
uint8 t cH, cS, CR; 
UTD getCreepStats(c-»typeFreeze & O0xOf,&CcH, &CS, &CR) ; 
uint8 t freeze = c->typeFreeze >> 4; 


if (freeze !- 0) 


cS += 15; 
c->typeFreeze = (c->typeFreeze & OxOf) | ((freeze - 1) << 4); 


if ((UTD_updateCounter % (cS)) == 0) 
c->pathPosition++; 


int8_t dummyi, dummy2; 

if A OSERSEdE E Op »- 0 && !UTD pathPositionTo2D( 
c-»pathStart,c-»pathPosition, &dummy1, &dummy2) ) 
UTD creepFinishes(i); 


Ctt; 


H 
uinti6 t *t = UTD mapTiles; 
// update towers: 


if (UTD updateCounter % 3 == 0) 
for (uinti16 t i = 0; i < UTD MAP WIDTH * UTD MAP HEIGHT; ++i) 


uinti6 t tower = *t; 

if (!UTD IS TOWER(tOower)) 
tt; 
continue; 


uint8 t attackProgress = UTD TOWER ATTACK PROGRESS(tower); 


tower & UTD UPGRADE2 
UTD applySpeedAura(i); 


if (Mone UTD UP RADED]) UTD TOWER MAGIC && 
t (attackProgress == 0) 
// look for a new target: 


uint8 t skipFrozen = UTD TOWER TYPE(tower) == UTD TOWER ICE; 
// ^ ice tower will always look for a new target to freeze 


int8_t towerX, towerY, radius; 
UTD squarePositionTo2D(i,&towerX,&towerY); 
if (!UTD TOWER IS SMALL(tOwer)) 


towerX += 4; 
towerY *- 4; 


uint8 t tR, tS, tD; 
UTD | getTowerInstanceStats(tower, &tR, &tD, &tS); 


radius - tR; 
UTD Creep *c - UTD creeps; 
for (uint8 t j = 0; j « UTD creepCount; ++j) 
int8 t x, y; 
if (UTD canAttack(tower,c-»typeFreeze & OxOf) && 
UTD . pathPositionTo2D(C- >pathStart,c->pathPosition, &x,&y) && 
UTD isWithinRange(x,y,towerX, towerY, radius) && 
!(skipFrozen && (c- StypeFreeze >> 4 I= 0)) 
tower - UTD TOWER TARGET. SET(tower, j); 
attackProgress - tS; 
break; 


} 


Ctt; 


} 


else 


{ 
if (attackProgress == // hit 
UTD towerHits(tower,0); 


attackProgress--; 


tower - UTD TOWER ATTACK PROGRESS SET(tower,attackProgress); 
*t - tower; 
n ttt; 
if (UTD gameState !- UTD GAME STATE LOST && UTD creepCount == 0) 
UTD money += UTD WAVE BASE REWARD + UTD round / 4; 
UTD round-t*; 
UTD | gameState = UTD GAME STATE PLAYING; 
if (UTD round > SAF load(UTD mapIndex)) 
SAF save(UTD mapIndex,UTD round); // save high score 
lise if (SAF buttonJustPressed(SAF BUTTON A)) 
UTD menuItem - 0; 
if (UTD mapTiles[UTD cursorPos] -- UTD TILE NONE) 
uint8 t cur sorNot Top. UTD_cursorPos >= UTD_MAP_WIDTH, 


~cursorNotLeft UTD_cursorPos % UTD_MAP_WIDTH 12 0, 
movedLeft = 0; 


if (cursorNotLeft && 
UTD IS TOWER(UTD mapTiles[UTD cursorPos - 1]) && 
!UTD TOWER I$ SMALL(UTD mapTiles[UTD cursorPos - 1])) 


UTD cursorPos--; 
movedLeft - 1; 


l 
else if (cursorNotTop && 
UTD 1S TOWER(UTD mapTiles[UTD cursorPos - UTD MAP ID TH) wee 
!UTD TOWER I$ SMALL(UTD mapTiles[UTD cursorPos - UTD MAP WIDTH])) 
UTD cursorPos -- UTD MAP WIDTH; 


l 
else if (cursorNotLeft && cursorNotTop && 
UTD 1S TOWER(UTD mapTiles[UTD cursorPos - UTD MAP WIDTH - e 


Ate TOWER_IS_SMALL(UTD_mapTiles[UTD_cursorPos - UTD_MAP_WI 
4 
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UTD cursorPos -- UTD MAP WIDTH + 1; 
movedLeft - 1; 


if provedl ert && UTD_cameraPos > 0) 
UTD cameraPos--; 


UTD gameState - UTD GAME STATE PLAYING MENU; 
return; 


if (UTD buttonPressedOrHeld(SAF BUTTON RIGHT)) 
UTD cursorPos += (UTD cursorPos % UTD MAP WIDTH) « UTD MAP WIDTH - 1 ? 
: 0; 
D_MAP_WIDTH 
} UTD_cameraPos++; 
else if (UTD buttonPressedOrHeld(SAF BUTTON LEFT)) 
UTD cursorPos -- (UTD cursorPos % UTD MAP WIDTH) > 0 ? 
i 
if (SAF_buttonPressed(SAF_BUTTON_B) && UTD_cameraPos > 0) 
UTD cameraPos--; 


examples/minigames.h 


yt 
Simple minigames for SAF. 


if UDATA pattern 75354 (5^F7 BUTTON B) && UTD cameraPos « 


xy drummyfish, released under CCO 1.0, public domain 


//#define SAF SETTING FORCE 1BIT 1 
#define SAF SETTING BACKGROUND COLOR 0xe8 
#define SAF PROGRAM NAME "Minigames" 


define SAF SETTING FASTER 1BIT 2 
#define SAF SETTING ENABLE SOUND 1 
#define SAF SETTING ENABLE SAVES 1 
#define SAF SETTING BACKGROUND COLOR 0 
//#define SAF SETTING FORCE 1BIT 1 


#include "../saf.h" 
#define GAMES 5 ///« number of minigames 


static const char *gameNames[GAMES] - 
"SNEK", 
"MINE", 
"BLO 
"2948" 
"RUNR"' 
N 


#define MEMORY SIZE 512 
#define MEMORY VARIABLE AREA ((32 * 29) / 2) // = 464 


#define BUTTON HOLD PERIOD 18 

void (*stepFunction) (void); 

void menuStep(void); 

void quitGame(void) 
stepFunction - &menuSt 


SAF playSound(SAF : SOUND PéLtcK); 


/** Memory that's used by the games: the memory is shared between games and at 
any time at most one game is using the memory. This helps save RAM on 
platforms that don't have much of it. The memory has two parts: 


- array area. first MEMORY_VARIABLE_AREA bytes): used for 2D array data, the 
size e.g lows to store 32 * 29 half-byte values. 
- variable ared: game's global variables should be mapped into this area */ 
uint8 t abie area: cue gl 


#define VAR(type, index) (*((type *) (memory + MEMORY_VARIABLE_AREA + index))) 


void clearMemory() 
uint8 t *m - memory; 


for (uinti6 t i = 0; i « MEMORY SIZE; ++i, ++m) 


9; 


void setMemoryHalfByte(uint16_t index, uint8 t data) 


uint8_t *m = memory + index / 2; 


*m = (index % 2) ? ((*m & Oxf) | data) ((*m & exef) | (data << 4)); 


uint8 t getMemoryHalfByte(uinti6 t index) 


return (index % 2) ? (memory[index / 2] & OxOf) (memory[index / 2] »» 4); 


UE buttonPressedOrHeld(uint8 t key) 
uint8 t b - SAF buttonPressed(key); 
return (b == 1) || (b >= BUTTON HOLD PERIOD); 

void drawTextRightAlign(int8 t x, int8 t y, const char *text, uint8 t color 
uint8 t size) 


uint8_t l = 
while (text[l] != 0) 
le; 


i 
X-2x-1l*5*size-*1; 


SAF_drawText(text,x,y,color,size); 


void blinkHighScore() 
if (SAF frame() & 0x10) 


l 
else if (UTD buttonPressedOrHeld(SAF BUTTON UPd) 
UTD_cursorPos -= UTD_cursorPos >= UTD_MAP_WIDTH ? UTD_MAP_WIDTH : 0; 
EL if (UTD buttonPressedOrHeld(SAF BUTTON DOWN) M 
cursorPos += UTD cursorPos « (UTD MAP HEIGHT - 1) * 
UTD MAP. WIDTH ? 


UTD MAP. WIDTH : 0; 


uint8 t cursorX - UTD cursorPos ?6 UTD MAP WIDTH; 


if (cursorX >= UTD cameraPos + 8) 
UTD cameraPos--; 

if (cursorX « UTD cameraPos) 
UTD cameraPos--; 


break; 


H 

defualt: break; 
3? 
uint8_t SAF_loop(void) 
i UTD —gamestep(); 


UTD_draw(); 
return 1; 
l 
SAF drawRect(5,20,54,16,SAF COLOR GRAY DARK, 1); 
n SAF drawText "HTSCORE!", 11,25,SAF COLOR | GREEN, 1) 
H 


void saveHiScore(uint8 t index, uinti16 t score) 


SAF save(index * 2,score & Ox00ff 
SAF save(index * 24 1,score / 25 T 


uinti6 t getHiScore(uint8 t index) 
return SAF load(index * 2) + (((uinti6 t) SAF load(index * 2 + 1)) * 256); 


// SNAKE 


#define SNAKE BOARD W 32 
#define SNAKE BOARD H 29 
#define SNAKE START LEN 6 
#define SNAKE MOVE SPEED 6 


define SNAKE COLOR1 SAF COLOR BLACK 
#define SNAKE COLOR2 SAF COLOR RED 


#define SNAKE SQUARE EMPTY 0 
#define SNAKE SQUARE SU 
#define SNAKE SQUARE SR 
#define SNAKE SQUARE SD 
#define SNAKE SQUARE SL 
#define SNAKE SAVE SLOT 


// snake segment pointing upwards to next segment 


OBRWNE 


// variables: 
#define SNAKE_TAIL_SQUARE EE 


#define SNAKE HEAD SQUARE VAR(int16_t, 2 

#define SNAKE FOOD SQUARE VAR(inti6 t,4 

#define SNAKE MOVE COUNT VAR Cuint8. t ,6) // countdown to next snake move 

#define SNAKE DIRECTION VAR(uint8_ a 

#define SNAKE_FOOD_STEPS VAR(uint8_ t ) 

#define SNAKE SCORE VAR(uinti6 t,9) 

#define SNAKE GAME STAT! VAR(uint8 t,11) // 0: playing, 1: end, 2: end, hiscore 


void snakeSpawnFood() 


inti6 t square = 


hs ((uinti6 t) SAF random()) << 8) | SAF random()) % 
(SNAKE BOARD W H 


SNAKE. BOARD. H) ; 


while (getMemoryHalfByte(square) !- SNAKE SQUARE EMPTY) 
square = ((square != 0) ? square : (SNAKE BOARD W * SNAKE BOARD H)) 


SNAKE FOOD SQUARE - square; 


void snakeInit() 


clearMemory(); 
// TODO: init snake to random colors? 


SNAKE_TAIL_SQUARE = GSNAKE_BOARD_H / 2) * SNAKE BOARD W + SNAKE BOARD W / 2 
- SNAKE START LEN 2; 


SNAKE GAME STATE - 0; 

SNAKE HEAD S! UARE = SNAKE - TAIL -SQUARE + SNAKE_START_LEN - 1; 
SNAKE DIRECTION = SNAKE |. SQUARE 

SNAKE MOVE COUNT SNAKE MOVE . SPEED; 

SNAKE_FOOD_STEPS 0; 

SNAKE SCORE - 0; 


for (uint8 t i = 0; i < SNAKE START LEN; ++i) 
setMemoryHalfByte(SNAKE TAIL SQUARE + i,SNÀKE SQUARE SR); 


snakeSpawnFood( ) ; 


} 


inti6 t snakeNextSquare(inti6 t square) 
p (getMemoryHalfByte(square)) 
case SNAKE SQUARE SU: return square - 32; break; 
case SNAKE SQUARE SR: return square + 1; break; 
case SNAKE SQUARE SD: return square + 32; break; 
case SNAKE SQUARE SL: return square - 1; break; 
default: return square; break; 


i! 

void snakeDraw() 
SAF clearScreen(SAF COLOR WHITE); 
SAF drawRect(0,SAF SCREEN HEIGHT,SAF SCREEN WIDTH, -6,SAF COLOR GRAY DARK,1); 
char scoreText[6]; 


SAF drawText(SAF intToStr(SNAKE. SCORE, scoreText),2,SAF SCREEN HEIGHT - 5, 
SAF COLOR WHITE, 1); 
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uint8 t collides - 0; 
inti6 t square = SNAKE TAIL SQUARE; 


uint8 t val - getMemoryHalfByte(square); int8 t diff = (nextSquare % 32) - (SNAKE HEAD SQUARE % 32); 
sif SAF PLATFORM COLOR COUNT > 2 if ( // collision with map borders 
uint8 t pattern - 1; // pattern of next and prev square, for coloring diff !- 0 && diff !- 1 && diff !- “2d M 
#endif (nextSquare < 0) || (nextSquare >= NAKE BOARD W * SNAKE BOARD H))) 
while (1) // draw from tail to head collides = 1; 
uint8_t combinedPattern = 0; if (!collides) 
Hif SAF PLATFORM COLOR COUNT > 2 uint8 t squareVal - getMemoryHalfByte(nextSquare); 


switch (val) 
if (squareVal !- SNAKE SQUARE EMPTY) 


case SNAKE SQUARE SU: combinedPattern - 1 pattern; pattern - 4; break; collides - 1; // collision with self 
case SNAKE SQUARE SR: combinedPattern - 2 pattern; pattern - 8; break; 
case SNAKE SQUARE SD: combinedPattern - 4 pattern; pattern - 1; break; 
case SNAKE SQUARE SL: combinedPattern - 8 | pattern; pattern - 2; break; if (collides) 
} default: break; { 
SAF | playSound SAF SOUND, | BOOM); 
#endif SNAKE _GAME_! STATE 1; 
uint8_t x = (square % 32) * 2; if (SNAKE_SCORE >= getHiScore(SNAKE_SAVE_SLOT 
uint8_t y = (auare 7 33} * 2: The i getHiScore( -SAVE SLOT)) 


i saveHiScore(SNAKE_SAVE_SLOT, SNAKE_SCORE) 
#if SAF F_PLATFORM | COLOR COUNT. E 2 ares 
rawPixe combinedPattern & (1 8 combinedPattern == (2 = 
4))) SA FSAREP. axeltx,y, (com banedpatt (118)) II ¢ (2 | SNAKE_GAME_STATE = 2; 
SAF drawPixel(x + 1,y,(combinedPattern & 2) ? SNAKE COLOR2 : SNAKE, COLOR1); 
SAF drawPixel(x, y : 1, (combinedPattern & 4) ? SNAKE COLOR2 : SNAKE COLOR1); return 
SAF drawPixel(x + 1,y + 1,SNAKE COLOR1); 3 


#else 
SAF_drawPixel SAF. REOR ORB A 
1,y,SAF COLOR BLACK 
" 
1 


Yr 


setMemoryHalfByte(nextSquare, headVal); 


SAF_drawPixel 
1,SAF COLOR BLACK SNAKE HEAD SQUARE = nextSquare; 


x,y 
xX + 

SAF drawPixel(x,y Ji 
X + 1,y * 1,SAF COLOR BLACK); 


SAF drawPixel 


#endif if (nextSquare == SNAKE_FOOD_SQUARE) // takes food? 

if (square == SNAKE HEAD SQUARE) SNAKE SCORE += 20 - g NAKE.; FOOD STEPS / 25; 

break; SNAKE_FOOD_STEPS = 
SAF. x DlaySound(SAr - SOUND | CLICK); 

square - snakeNextSquare(square); j snakeSpàwnFood( ) 
sif SAF PLATFORM COLOR COUNT > 2 d 

val - getMemoryHalfByte(square); nextSquare - snakeNextSquare(SNAKE TAIL SQUARE); 
Pendir setMemoryHalfByte(SNAKE TAIL SQUARE, SNAKE SQUARÉ EMPTY); 


// draw food: SNAKE TAIL SQUARE = nextSquare; 


uintg_t x = (SNAKE FO0D_s UARE % 32) * 2 
uint8_t y = (SNAKE FOOD. SQUARE / 32) * 2; SNAKE. MOVE. COUNT = SNAKE. MOVE. SPEED; 
SAF. drawPixel(x,y,SAF COLOR BLUE); 3 

SAF drawPixel(x +1, y, SAF_COLOR BLUE staker 
SAE drawPixelix,y +1; SAF COLOR BLUE } 
SAF_drawPixel(x + 1,y * 1,SAF_COLOR see 


#if SAF_PLATFORM_COLOR_COUNT <= 2 // MINESWEEPER eee 
SAF_drawRect(x - 1,y - 1,4,4,SAF_COLOR_WHITE, 0); 
#endif 
sgeine WINES BOARD M 22 
if (SNAKE_GAME_STATE == 2) erine 
SNAKE -GAME STAT "define MINES SQUARE SIZE 5 
blinkHighScore(); define MINES MINE COUNT 22 
"define MINES OFFSET X 2 
. #define MINES OFFSET Y 8 
void snakeStep() #define MINES SAVE SLOT 1 
if (SAF buttonPressed(SAF BUTTON B) »- BUTTON HOLD PERIOD) sSderine MINESCSOUARES COVERED MARKED: XOF 
quitGame(); #define MINES SQUARE COVERED xoc 
; #define MINES SQUARE MINE MARKED 0x0 
if (SNAKE GAME STATE !- 0) #define MINES SQUARE MINE 0x0c 


if (SAF buttonJustPressed(SAF BUTTON A)) 


snakeInit(); #define MINES SELECTED SQUARE VAR(uinti6 t,0) 


#define MINES GAME STATE VAR(uint8 t,2) /* 0: start, 1: play, 2: lost, 3: won, 


4: won, hiscore 
snakeDraw(); #define MINES SQUARES . LEFT VAR(uint8_t, 3) 
#define MINES MS ELAPSED VAR(uint32 t,4) 


return; 
void minesInit() 
SNAKE MOVE COUNT--; MINES GAME STATE - 0; 
uint8 t timePressed - 0; MINES SELECTED SQUARE - (MINES BOARD W * MINES BOARD H) / 2; 
// we register the button pressed for shortest time (allows best control): for (uinti16 t i = 0; i < MINES BOARD W * MINES BOARD H; ++i) 


setMemoryHalfByte(i,MINES SQUARE COVERED); 
#define checkButton(b,d)\ 


if (SAF | buttonPressed 52 88 MINES SQUARES LEFT - MINES BOARD W * MINES BOARD H - MINES MINE COUNT; 
(timePressed -- AF. Aon rEONPEGSSH UB] « timePressed)) {\ MINES MS ELAPSED = 0; 
timePressed - SAF oMigecnprested (ty: \ } 


SNAKE | DIRECTION = d; 
void minesPlaceMines(uinti6 t clickSquare) 


checkButton(SAF BUTTON UP, SNAKE. SQUARE. SU) { 
checkButton(SAF BUTTON. RIGHT, SNAKE SQUARE SR) for (uint8 t i = 0; i < MINES MINE COUNT; ++i) 
checkButton(SAF BUTTON DOWN, SNAKE. SQUARE. SD 
checkButton(SAF BUTTON LEFT, SNAKE SQUARE SL uinti6 t square = SAF random() % (MINES BOARD W * MINES BOARD H); 
if (SNAKE. MOVE COUNT <= while (getMemoryHalfByte(square) == MINES SQUARE MINE | 
(SAF buttonPressed(SAF BUTTON A) ? © : (SNAKE MOVE SPEED * 3) / 4)) Square == clickSquare) 


; square = ((square != 0) ? square : (MINES BOARD W * MINES BOARD H)) - 1; 
if (SNAKE FOOD STEPS « 255) 


SNAKE FOOD STEPS-**; setMemoryHalfByte(square,MINES SQUARE MINE) 
uint8 t headVal - getMemoryHalfByte(SNAKE HEAD SQUARE); } 
if (SNAKE DIRECTION !- headVal) void minesDraw() 
í uint8_t opposite = 0; uint8_t state = MINES_GAME_STATE; 


uint8_t color = SAF_COLOR_WHITE; 
aa (headVal) 


sif SAF PLATFORM, COLOR COUNT > 2 


case SNAKE SQUARE SU: opposite - SNAKE SQUARE SD; break; if (state == 
case SNAKE SQUARE SR: opposite = SNAKE SQUARE SL; break; color - SAF COLOR RED; 
case SNAKE SQUARE SD: opposite - SNAKE SQUARE SU; break; else if (state -- IB State == 4) 
case SNAKE_SQUARE_SL: opposite = SNAKE_SQUARE_SR; break; color = SAF_COLOR_GREEN; 
} default: break; #endif 
SAF_clearScreen(color); 
// disallow turning 180 degrees (instadeath): 
if (SNAKE_DIRECTION != opposite) uint16_t square = 0; 
headVal = SNAKE eo TRECTION: // ba 
} setMemoryHaLfByte (SNAKE HEAD SQUARE, headVal) ; SAF. drawRect (0,0, SAF_SCREEN_WIDTH, MINES OFFSET Y - 2,SAF COLOR GRAY. DARK, 1); 
H 


char text[5]; 


inti6 t nextSquare - snakeNextSquare(SNAKE HEAD SQUARE); 
E q 3 ( SQ L SAF drawText(SAF . ae aa MS ELAPSED / 1000, text), 26,1, 


// check collision: SAF COLOR WHITE, 1 
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SAF drawText(SAF intToStr(MINES SQUARES LEFT, text),3,1,SAF. COLOR WHITE, 1); checkSquares &- Oxd6; 


SAF drawText("E",58,1,SAF COLOR WHITE, 1); coordinate - square / MINES BOARD W; // y 
// background rect: if (coordinate == 0) 
SAF_drawRect (MINES_OFFSET_X, MINES_OFFSET_Y, checkSquares &- Ox1f; 
MINES BOARD W * MINES | SQUARE : SIZE, else if (coordinate == "MINES | BOARD H - 1) 
MINES BOARD H * MINES SQUARE . SIZE, checkSquares &- Oxf8; 
#if SAF PLATFORM COLOR COUNT <= 2 
else COLOR BLACK, uint8 t checkSquaresbackup = checkSquares; 
denne = COLOR_BROWN, for (uint8_t i = 0; i < 8; ++i) 
1); if (checkSquares & 0x80) 
// squares: = + í 
for (uint8 t = MINES OFFSET Y; squareVal getMemoryHalfByte(square offsets[i]); 


y < (MINÉS BOARD H * MINES" | SQUARE SIZE) + MINES OFFSET Y; if uareVal == MINES SQUARE MINE squareVal == 
y += MINES. | SQUARE _ ee ee MINES_SOUA . MINE MARKED) k || sq 

for (uint8 t x - MINES OFFSET X; mineCount++; 
X € (MINES BOARD W * MINES | SQUARE : SIZE) + MINES OFFSET X; 
X *- MINES SQUARE SIZE) 


uint8 t squareVal - getMemoryHalfByte(square); checkSquares ««- 1; 


uint8 t marked - squareVal -- MINES SQUARE COVERED MARKED || 


SquareVal -- MINES SQUARE MINE MARKED; setMemoryHalfByte(square,mineCount); 

Hif SAF PLATFORM COLOR COUNT > 2 if (mineCount == 0) | . 

color - marked ? SAF COLOR RED : for (uint8_t i = 0; i < 8; ++i) 
Jass ((squareVal < MINES SQUARE MINE) ? SAF COLOR WHITE : SAF COLOR GRAY); if (checkSquaresbackup & 0x80) 

color = (squareVal >= MINES SQUARE MINE) ? minesReveal(square * offsets[i]) 

SAF COLOR WHITE : SAF COLOR BLACK; 

#endif } checkSquaresbackup <<= 1; 
ui <pSqwareVal, c MINES SQUARE MINE ? MINES SQUARE SIZE 
(MI Tiest SQUARE | SIZE - 1); } #undef checkSquare 


SAF drawRect(x,y,s,s,color,1); void minesStep(void) 


i = { 
#if SAF PLATFORM COLOR COUNT <= 2 if (SAF buttonPressed(SAF BUTTON B) >= BUTTON HOLD PERIOD) 


if (marked) 


dendif SAF drawText("*",x,y,SAF COLOR BLACK, 1) ; quitGame(); 
endi 
if (MINES GAME STATE == 0 || MINES GAME STATE == 1) 
if (squareVal « MINES SQUARE MINE && squareVal > 0) i? (MINES SQUARES LEE T 362 8) 2 Win 


#if SAF PLATFORM COLOR COUNT > 2 
coe (squareVal) SAF playSound(SAF SOUND BEEP); 


case 1: color - SAF COLOR BLUE; break; MINES GAME STATE - 3; 


case 2: color = SAF COLOR GREEN; break; 
case color - SAF COLOR RED; break; uinti6 t score = getHiScore(MINES SAVE SLOT); 
case d Spr = MD OQ QU DAN Break 
case color = H rea i == 
ease. color = SAF COLOR RED DARK, ue if (score © || MINES_MS_ELAPSED / 1000 < score) 
case color = ws a rea i . 
case 8: color = SAF COLOR BROWN; break; MINES GANE TATE S ee ee 71008) 
default: break; 
#else S 
" color = SAF COLOR WHITE; jee 
#endif 
MINES MS ELAPSED += SAF MS PER FRAME; 
char AE Hm = np 
numText[0] += squareva uint8_t x = MINES SELECTED SQUARE % MINES BOARD W; 
} SAF_drawText (numText, x, y, color, 1) ; uint8 t y = MINES SELECTED SQUARE / MINES BOARD W; 
else if (state == 2 && squareVal — MINES SQUARE. MINE) if (buttonPressedOrHeld(SAF. BUTTON RIGHT) && x « MINES BOARD W - 1) 
char t[2] - "e"; M. NES SELECTED SQUARE; 
AF drawtext else if (but tonPressedQrHeld(SAF_BUTTON_LEFT) && x > 0) 
Hif SAF POATEORM. COL & ' COUNT 2-2 MINES SELECTED SQUARE--; 
SAF COLOR RED, 
#else if (buttonPressedOrHeld(SAF BUTTON UP) && y > 0) 
SAF COLOR BLACK, MINES SELECTED SQUARE -- MINES BOARD W; 
sendif else if (buttonPressedOrHeld(SAF BUTTON DOWN) && y « MINES BOARD H - 1) 
; MINES SELECTED SQUARE += MINES BOARD W; 
H 
uint8 t squareVal - getMemoryHalfByte(MINES SELECTED SQUARE); 
square-**; 
// mark/unmark: 
if (SAF buttonJustPressed(SAF BUTTON B) && squareVal »- MINES SQUARE MINE) 
uinti6 t selectedSquare = MINES SELECTED SQUARE; setMemoryHalfByte(MINES SELECTED SQUARE, squareVal ^ 0x01); 
= MINES OFFSET X + (selectedSquare % MINES BOARD W) * // reveal: 
NINES Squat SIZE; ( 3 ) if (SAF buttonJustPressed(SAF BUTTON A)) 
yee MINES. OFFSET Y * (selectedSquare / MINES BOARD W) * { 
MINES Sata E SIZ if (squareVal -- MINES SQUARE COVERED) 
#if SAF PLATFORM COLOR COUNT <= 2 if (MINES GAME STATE == 0) 
1, SAF- na Ke" o]: „Y - 1,MINES SQUARE-SIZE + 1,MINES SQUARE SIZE + minesPlaceMines(MINES SELECTED SQUARE) 
E SAE drawRect Xk oft ,y - 2,MINES SQUARE SIZE + 3,MINES SQUARE SIZE + } MINES_GAME_STATE = 1; 
#else f 
SAE _drawRect (x - 2,y - 2,MINES SQUARE SIZE + 3,MINES SQUARE SIZE + minesReveal(MINES SELECTED SQUARE) 
3, SAF COLOR BLACK, 0); H 
#endif else if (squareVal == MINES SQUARE MINE) // loss 
if statacs MINES GAME STATE - 2; 


) 
blinkHighScore(); 
inkHighScore() SAF. playSound(SAF. SOUND. BOOM) 


void minesReveal(uinti16 t square) F 


else // won or lost, waiting for keypress 
if (SAF buttonJustPressed(SAF BUTTON A) || 
SAF buttonJustPressed(SAF BUTTON B)) 


uint8 t squareVal - getMemoryHalfByte(square); 


if (squareVal !- MINES SQUARE. COVERED && 
Squareval !- MINES SQUARE COVERED MARKED) minesInit(); 
return; 


minesDraw(); 
MINES SQUARES LEFT--; 


uint8 t mineCount - 0; CAP BLOCKS See tatoos Set ee E EE LL ieu eu EE ELI E EE NE C EE 
inte_t EV Fwd /* square format is following: 
2343 
7i MINES BOARD W + 1, MSB 76543210 LSB 
-1, 1, 
MINES, BOARD_W - 1, 012: block Dart oat © = empty square 
MINES BOARD W, 3456: for rotation, says the position of the block within the tetromino 
MINES BOARD W *cb Ts 1 for an active Yallin) block, © otherwise 
uint8 t checkSquares = Oxff; the square with value Oxff is a flashing square to be removed */ 
uint8 t coordinate = square % MINES BOARD W; // x #define BLOCKS BOARD W 10 
qgetine BLOCKS_BOARD_H 15 ( » ) 
et #define BLOCKS BOARD SQUARES (BLOCKS BOARD W BLOCKS BOARD H 
if (coordinate: = 926b; #define BLOCKS SQUARE: gree A 
else if (coordinate == MINES BOARD W - 1) define BLOCKS BLOCK TYPES 8 
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#define BLOCKS LINE SCORE 10 t 

#define BLOCKS LAND SCORE 1 uint8 t square - memory[i]; 
#define BLOCKS LEVEL DURATION (SAF FPS * 60) 

#define BLOCKS SPEED INCREASE 3 if (square & 0x80) 


#define BLOCKS START. SPEED 25 

#define BLOCKS SAVE SLOT 2 

#define BLOCKS OFFSET X \ uint8 t index = 2 * ((square >> 3) & Ox0f) 
(SAF SCREEN WIDTH - BLOCKS BOARD W * BLOCKS SQUARE SIZE) uint8 t newPos = i + rotationMap[index + 1]; 


#define BLOCKS OFFSET Y 2 if (left) 
" { 
#define BLOCKS STATE VAR(uint8 t,O 

#define BLOCKS SPEED VAR(UintB- t/1 A BOUREPATAO MOPE TIMES 
define BLOCKS NEXT MOVE VAR(uints_ 2), 


#define BLOCKS WAIT TIMER VA\ (uinté_ d index - rotarionMapl indes] $ 


#define BLOCKS_LEVEL VAR(uint8_t newPos += rotationMap[index + he 
#define BLOCKS SCORE VAR(uint16_ p ) 1 F x 
#define BLOCKS_NEXT_LEVEL_IN VAR(uint32_ t,7) index = rotationmap [index |] 
newPos += rotationMap[index + 744; 
uint8 t blocksSquareIsSolid(uint8 t square) J 
uint8 t val = memory[square]; int xDiff = (newPos % BLOCKS BOARD W) - (i % BLOCKS BOARD W) 


return (val != 0) && (val & 0x80) == 0; 
xDiff = xDiff >= 0 ? xDiff : (-1 * xDiff); 


uint8 t blocksSpawnBlock(uint8 t type) if ((xDiff » 2) || // left/right outside? 
, newPos >= BLOCKS BOARD SQUARES) || // top/bottom outside? 
if (type == 0) DlockssguareTesolid(newPos)) 
type = 7; return; // can't rotate 
uint8_t vH] = fee 5,14,15}; // start with square tetromino newValues[blocksProcessed] - (square & 0x87) | (rotationMap[index] «« 3); 
uint8 t v[4] - ,9,6); // all center squares, unrotatable newPositions[blocksProcessed] - newPos; 
/* the v array holds the position of the tetromino like this: blocksProcessed++; 
0 if (blocksProcessed »- 4) 
123 break; 
45678 } 
9ab } 
CG. FZ 
i ] E" for (uint8 t i = 0; i < BLOCKS BOARD SQUARES; ++i) 
switch (type) // modify to a specific shape if (memory[i] & 0x80) 
memory[i] = 0; 
case E tf, neverse 13; 
s[0] = 3; S|1] = i for (uint8_t i = 0; i« 4; ++i 
vfo = 1; v[1] = 5; v[3] = 7; memory[newPositions[i]] = newValues[i]; 
break; H 
RA void blocksDraw(void) 
A E 
vel 5; v[1] = 3; v[3] = 7; SAF clearScreen(BLOCKS STATE ? SAF COLOR RED DARK : SAF COLOR GRAY DARK) 
; 
: SAF drawRect 
case 3: // S Hif SAF PLATFORM COLOR COUNT » 2 
s[0] = 6; or "e ES BLOCKS OFFSET X,BLOCKS OFFSET Y 
uec 3; v[1] = 2; v[2] = 5; v[3] = 6; : BLOCKS BOARD W * BLOCKS SQUARE SIZE, BLOCKS BOARD H * BLOCKS SQUARE SIZE, 
; #else 
BLOCKS_OFFSET_X - 1,BLOCKS_OFFSET_Y- 1,BLOCKS_BOARD_W * BLOCKS_SQUARE_SIZE 
case 4: // Z + 2, BLOCKS BOARD H'* BLOCKS SQUARE, SIZE + 2, 
s[2] = 16; #endif 
v[O] = 1; v[1] = 2; v[2] = 7; v[3] = 6; SAF_COLOR_WHITE, 1); 
break; 
| char text[16] = "L "; 
case 5: // upside-down T 
s[0] - 16; SAF intToStr(BLOCKS LEVEL,text + 1); 
vt0] = 7; v[1] = 2; v[2] = 5; v[3] = 6; SAF drawText(text,2,3,SAF COLOR WHITE, 1); 
break; SAF intToStr(BLOCKS SCORE, text); 
SAF_drawText (text, 2,10, SAF_COLOR_WHITE, 1); 
Case D: th T T d 
EI = 3; S = 6; i E E 
MER = 7! sB] = 5! v[3] = 8; E 9r 
break; for (uint8_t i = 0; i « BLOCKS BOARD SQUARES; ++i) 
default: break; uint8 t square - memory[i]; 
type |- 0x80; if (square) 
X if (square !- Oxff) 
uint8 t result - 1; square &- 0x07; 
for (uint8 t i = 0; i < 4; ++i) uint8_t color = 0; 
uint8_t square = s[i]; #if SAF_PLATFORM_COLOR_COUNT > 2 
switch (square) 
if (memory[square] != 0) { 
result = 0; case 1: color = SAF_COLOR_RED; break; 
case 2: color = Rez bu 
memory[square] = type v[i] << 3)); case 3: color = Di - rea 
y[square] = type | ((v[i] i case 4: color = SAF COLOR YELLOW; break; 
case 5: Conor = BAF COLOR ORANGE; break; 
2 case 6: color = SAF_COLOR_BLUE; brea 
return result; case 7: color = SAF COLOR. GREEN. DARK; break; 
Oxff: color = ((SAF frame() >> 2) & 0x01) ? SAF COLOR BLACK : 
. a . SAF | COLOR HITE: break; 
yoid blocksInit(void) default: break; 
clearMemory(); #else 
conor = conuare != Oxff) ? SAF COLOR BLACK : 
BLOCKS SPEED - BLOCKS START SPEED; . ((SAF_ rame() >> 2) & 0x01) ? SAF COLOR BLACK : SAF COLOR WHITE; 
BLOCKS NEXT | MOVE = BLOCKS START SPEED; #endif 
BLOCKS WAIT TIMER = 0; 
BLOCKS LEVEL - 0; uint8 t 
BLOCKS SCORE - 0; drawX - BLOCKS OFFSET X * x * BLOCKS SQUARE SIZE 
BLOCKS NEXT _ LEVEL. IN - 9; drawY = BLOCKS OFFSET Y + y * BLOCKS SQUARE. SIZE; 


BLOCKS STATE = 0; 


piocksspawnB LOBE tue ran donc) REBCOCRS BLOCK IYPES): SAF_drawRect (drawX,drawY,BLOCKS SQUARE SIZE,BLOCKS SQUARE. SIZE, color, 1) 


H 
tt; 
void blocksRotate(uint8 t left) j 
const int8 t rotationMap[13 * 2] = "d (x >= 10) 
/* old new square offset x29: 
{/* 0 */ 8, 2* BLOCKS BOARD_W + 2, nn 
/*i1*/ 3, 2, 3 ytt; 
/* 2 */ 7, BLOCKS BOARD W + 1, } 
a 3 11, 2 * BLOCKS_ BOARD W, 
4 O -2 * BLOCKS_BOARD_W + 2 / 
/* 5 */ 2, -1 * BLOCKS BOARD W + 1, if (BLOCKS STATE && BLOCKS SCORE -- getHiScore(BLOCKS SAVE SLOT)) 
/*6*/ 6, 0 T blinkHighScore(); 
/* 7 */ 10, BLOCKS BOARD W - 1, 
/* 8 */ 12, 2 * BLOCKS BOARD W - 2, 
/* 9 */ 1,  -2 * BLOCKS BOARD W, uint8 t blocksFallStep(void) 
/* 10*/ 5,  -1 * BLOCKS BOARD W - 1, n 
4t711*/. 9, -2, uint8 t canFall - 1; 
/* 12*/ 4,  -2 * BLOCKS BOARD W - 2); 
for (uint8 t i = 0; i < BLOCKS BOARD SQUARES; ++i) 
uint8 t blocksProcessed - 0; if (memory[i] & 0x80) 
uint8 t newPositions|4]; 
uint8 t newValues[4]; if (i / BLOCKS BOARD W -- BLOCKS BOARD H - 1) 
for (uint8 t i = 0; i « BLOCKS BOARD SQUARES; ++i) canFall - 
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break; 


if (blocksSquareIsSolid(i + BLOCKS BOARD Ww)) 


canFall - 0; 
break; 


H 
} 
if (canFall) 


for (uint8 t i = BLOCKS BOARD W * (BLOCKS BOARD H - 1) - 1; i != 255; --i) 
d (memory[i] & 0x80) 


memory[i + BLOCKS BOARD W] = memory[i]; 
memory[i] = 0; 


} 


return canFall; 


void blocksMoveHorizontally(uint8_t left) 


uint8 t limitCol left ? © : (BLOCKS BOARD W - 1); 
int8 t increment left ? -1 : 1; 


for (uint8 t i = 0; i < BLOCKS BOARD SQUARES; ++i) 
if ((memory[i] & 0x80) && 


(i % BLOCKS BOARD W == limitCol) || 
blocksSquareIsSolid(i * increment 


return; 


uint8 t i0 = 0, ii = BLOCKS BOARD SQUARES; 


if (!left) 
i0 = BLOCKS BOARD SQUARES - 1; 
ii = 255; 
for (uint8 t i = i0; i !- i1; i -= increment) 


d (memory[i] & 0x80) 


memory[i + increment] = memory[i]; 
memory[i] = 0; 


H 
void blocksRemoveLines(void) 


for (uint8 t i = 0; i < BLOCKS BOARD SQUARES; ++i) 
if (memory[i] -- Oxff) 


BLOCKS SCORE += BLOCKS LINE SCORE; 


for (uint8 t j = i + BLOCKS BOARD W - 1; j >= BLOCKS BOARD W; --j) 
memory[j] = memory[j - BLOCKS BOARD W|; 


for (uint8_t j = 0; j < BLOCKS BOARD W; ++j) 
memory[j] = 0; 


H 
void blocksStep(void) 


1 
if (SAF buttonPressed(SAF BUTTON B) »- BUTTON HOLD PERIOD) 
quitGame(); 


blocksDraw(); 
if (BLOCKS STATE -- 1) 


if (SAF buttonJustPressed(SAF BUTTON A) || 
SÀF buttonJustPressed(SÀF BUTTON BJ) 


1 
blockstnit(); 
} BLOCKS_STA = 0; 


return; 


1» (BLOCKS NEXT LEVEL IN == 0) 


BLOCKS LEVEL += 1; 
BLOCKS NEXT LEVEL IN - BLOCKS LEVEL DURATION; 


if (BLOCKS SPEED » BLOCKS SPEED INCREASE) 
BLOCKS SPEED -- BLOCKS SPEED INCREASE; 
BLOCKS NEXT LEVEL IN -- 1; 
if (BLOCKS WAIT TIMER > 0) 
BLOCKS WAIT TIMER -- 1; 


if (BLOCKS WAIT TIMER == 1) 
blocksRemoveLines(); 


return; 


BLOCKS NEXT MOVE - BLOCKS NEXT MOVE - 1; 


if (SAF buttonJustPressed(SAF BUTTON A)) 
// drop the block: 


while (blocksFallStep()); 
SAF playSound(SAF SOUND BUMP); 


n BLOCKS NEXT MOVE = 0; 


if (buttonPressedorHeld(SAF BUTTON LEFT)) 
b ocksMovenorazontally(1) i 

else if (buttonPressedOrHeld(SAF BUTTON RIGHT)) 
blocksMoveHorizontally(0); 


if {SAF _buttonJustPressed(SAF_BUTTON_UP))) 
b ocksRotate (9); 

else if (SAF_buttonJustPressed(SAF_BUTTON_DOWN) ) 
blocksRotate(1); 


if (BLOCKS_NEXT_MOVE == 0) 


í a (!blocksFallstep()) 


for (uint8 t i = 0; i « BLOCKS BOARD SQUARES; ++i) 
memory[i] &- 0x07 ; 


// scan for completed lines: 

uint8 t col - 0; 

uint8 t count - 0; 

uint8 t lineCompleted - 0; 

for (uint8 t i = 0; i « BLOCKS BOARD SQUARES; ++i) 


if (memory[i] != 0) 
count++; 


col++; 
if (col >= BLOCKS_BOARD_W) 
if (count >= BLOCKS_BOARD_W) 
lineCompleted = 1; 
for (uint8 t j = i - BLOCKS BOARD W + 1; j <= i; **j) 
memory[j] = Oxff; 


col = 0; 
} count = 0; 
H 
if (lineCompleted) 
BLOCKS WAIT TIMER - 20; 
SAF playSound(SAF SOUND BEEP); 


BLOCKS SCORE += 1; 


if (!blocksSpawnBlock(SAF_random() % BLOCKS BLOCK TYPES)) 
BLOCKS STATE - 1; // game over 


SAF playSound(SAF SOUND BOOM); 


if (BLOCKS SCORE >= getHiScore(BLOCKS SAVE SLOT)) 
sáàveHiscore(BLOCKS SAVE SLOT, BLOCKS SCORE); 


} 3 

BLOCKS_NEXT_MOVE = BLOCKS_SPEED; 
} 3 
// 2048 


/* The first 16 bytes of the board hold the power values of the squares, and 
another 16 byte block follows which contains info for animation: each square 
has the previous square value in the lower 4 bits and the travel distance in 
the upper 4 bits. */ 


#define G2048 SQUARE SIZE 11 

#define G2048 BOARD SIZE ((G2048 SQUARE SIZE + 1) * 4 + 1) 

#define G2048 SQUARES 16 

#define G2048 OFFSET X ((SAF SCREEN WIDTH - G2048 BOARD SIZE) / 2) 
#define G2048 OFFSET Y 

#define G2048 SAVE SLOT 3 


#define G2048 ANIMATION FRAMES 8 


#define G2048 ANIMATION COUNTDOWN VAR(uint8_t,0 
#define G2048 ANIMATION DIRECTION VAR(uint8 t,1 
#define G2048 WON VAR(uint8_t, 2) 

#define G2048 MS ELAPSED VAR(uint32 t,3) 

#define G2048 HIGHSCORE COUNTDOWN VAR(uint8_t, 7) 


void g2048Spawn(void) 
uint8 t square = SAF random() % G2048 SQUARES; 
for (uint8 t i = 0; i « 62048 SQUARES; ++i) 
uint8 t s = (square + i) % G2048 SQUARES; 
if (memory[s] == 0) 
memory[s] = (SAF random() < 200) ? 1: 2; 
j 
H 
H 
H 
yoid g2048Init (void) 
G2048_ANIMATION_COUNTDOWN 
G2048_ANIMATION_DIRECTION 
G2048_WON = 0 


G2048_MS_ELAPSED = 0; 
G2048 HIGHSCORE COUNTDOWN = 0; 


for (uint8 t i = 0; i < G2048 SQUARES; ++i) 
memory[i] = 0; 


} g2048Spawn(); 


void g2048Draw( void) 


if SAF_PLATFORM_COLOR_COUNT > 2 

SAF clearScreen(SAF COLOR GRAY); 
#else 

SAF clearScreen(SAF COLOR BLACK); 
#endif 


SAF drawRect(G2048 OFFSET X,G2048 OFFSET Y, 
G2048 BOARD SIZE, G2048 BOARD SIZE,SAF COLOR WHITE, 1); 


uint8 t square - 0; 


uinti6 t animationNominator = G2048 SQUARE SIZE * 
(62048 ANIMATION FRAMES - G2048 ANIMATION COUNTDOWN + 1); 


for (uint8 t = 0; y < 4; ++y) 
for (uints_t x ='0; x <'4; ++x) 


uint8_t v = memor 


x y[ 
G2048_ANIMATION_COUNTDOWN == © ? square : (62048 SQUARES + square)]; 
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if (v == 0) uint8 t *animSquare = memory + G2048_SQUARES + square; 
T uint8 t distance - 0; 

square++; 
3 continue; uint8_t squareVal = memory[square]; 


int8_t animX = 0, animY = 0; 
if (G2048_ANIMATION_COUNTDOWN 


uinti6 t offset 


12 9) 


=v >> 4; 


offset = (offset * animationNominator) / G2048_ANIMATION_FRAMES; next Square: = gze4sNextsquare(nextSquare, direction); 
switch (G2048_ANIMATION_DIRECTION) A dye d OF büard 

CAE E animy = PERS bres SAK; uint8_t squareVal2 = memory[nextSquare]; 

case e animY - offset; break; 

case animx = -1 * offset; break; if (squareVal2 == squareVal) 

default: break; 
} memory[nextSquare] = squareVal + 1; 
v & Oxf; a (squareVal == 10) 

G2048 WON = 1; 
uint8 t drawX = G2048 OFFSET X + 1 + x * (G2048 SQUARE SIZE + 1) + animx : 
drawY = G2048 OFFSET Y + 1 + y * (G2048-8 UARE SIZE + 1) * animY; uinti6 t score = getHiScore(G2048 SAVE SLOT); 


uint8 t color - SAF COLOR BLACK, 
color2 = SAF COLOR | GRAY | DARK; 


#if SAF PLATFORM COLOR COUNT == 2 


i color2 = SAF COLOR WHITE; n G2048 HIGHSCORE COUNTDOWN - 75; 
#else 
switch (v) } 
case 1: color = SAF_COLOR_RGB(31, 222,79); break; memory [previousquare| = 
case 2: color SAF_COLOR_RGB 122, 120, 236); break; shifte 
case 3: color SAF_COLOR_RGB( 235, 123, 89 break; distance++; 
case 4: color SAF COLOR RGB 179, 107, 77); break; break; 
case 5: color - SAF COLOR RGB(237,162,36); break; H 
DN e E arena 
case : color = cal 3E H rea i == 
case 8: color = SAF COLOR RGB(207,112,190); break; gr (sduareval2 == 0) 
eee r RAF Sora MR ELE" 62,445); menar yjnextoquarė] ceguera 
case 10: color = SAF COLOR RGB(80, 156,36); EARE ee = 
color2 = SAF COLOR WHITE; break; distance++: 
case 11: color = SAF_COLOR_RGB 224, 126, 26); break; 
default: color = SAF COLOR RGB(122, 15,5); élse 
color2 = SAF_COLOR_GRAY; break; 
} break; 
#endif 
SAF_drawRect (drawX, drawY *animSquare |= (distance << 4); 
G2048 SQUARE : SIZE, 63048 | SQUARE_SIZE,color,1); 
char t[3] =" "5 nextSquare = g2048NextSquare(square, oppositeDirection); 
uints_t plusx = 4; if (nextSquare < 0) 
if (v « 10 square *- nextLineOffset; 
MU ='0' +v; break; Í 
HE = TEE TENET. square - nextSquare; 
; 
plusxX = 0; } 


SAF drawText(t,drawX + plusX,drawY + (G2048_SQUARE_SIZE - 4) / 2, 
color2,1); 


square++; 


} 


SAF_drawRect( 
O,SAF SCREEN HEIGHT - 6,SAF_SCREEN_WIDTH, 6, SAF_COLOR_GRAY_DARK, 1); 


char timeText[8]; 


SAF _Grawrext (SAF AntTostr (G2048 MS ELAPSED / 1000, timeText),2, 
SAF SCREEN HEIGHT - 5,SAF_COLOR_WHITE,1); 


if (G2048 WON) 
SÀF drawText("WIN",SAF SCREEN WIDTH - 18,SAF SCREEN HEIGHT - 5, 
SAF COLOR YELLOW, 1); 


if v (92029 HIGHSCORE_COUNTDOWN ) 
blinkHighScore(); 


if (squareVal !- 0) 
while (1) // slide the square 


int8 t previouSquare - 


if (score -- 


} 
if (shifted) 


G2048 ANIMATION COUNTDOWN 
G2048 ANIMATION DIRECTION 


return shifted; 


J 
void g2048Step(void) 


if (SAF_buttonPressed(SAF_BUTTON_B) >= 
quitGame(); 


G2048 MS ELAPSED += SAF MS PER FRAME; 


if (62048 HIGHSCORE COUNTDOWN > 0) 
G2048 HIGHSCORE COUNTDOWN -= 1; 


if (62048 ANIMATION COUNTDOWN == 0) 


nextSquare; 


|| G2048 MS ELAPSED / 1000 « score) 
saveHiScore(G2048 SAVE SLOT,G2048 MS ELAPSED / 1000); 


G2048. ANIMATION FRAMES; 
direction; 


' 


BUTTON HOLD PERIOD) 


j int8 t direction - -1; 
int8 t g2048NextSquare(int8 t square, uint8 t direction) if (SAF | buttonJustPresséd(SAF- BUTTON UP)) 
3 2 , direction - 
switch (direction) else if (SAF_ buttondustPressed(SAr_ BUTTON_RIGHT) ) 
: " . g direction = 
case 0: return (square >= 4) ? square - 4 : -1; break; // up else if (SAF. bütondustPressed(SAF. BUTTON DOWN)) 
case 1: return (square % 4 != 3) ? square + 1 H -1; break; // right direction = 
case 2: LeEUrm gsquare ra 7 square Adr Sd break; //'down else if (SAF. bültonJustPressed(SAF. | BUTTON LEFT)) 
case return (square % 4 !- 0) ? square - 1 : -1; break; // left direction = 3: 
dfauit: return -1; 
} m direction >= 


H 
uint8 t g2048Shift(uint8 t direction) 
uint8 t shifted - 0; 
int8 t square - direction == 1 || direction == 


int8 t nextLineOffset = 0; j ; 
uint8 t oppositeDirection' = (direction + 2) % 4; 


2) ? G2048 SQUARES - 1 : 0; 


// make a copy of the board that will be used for animation: 


for (uint8 t i = 0; i « 62048 SQUARES; ++i) 
memory[G2048 : SQUARES + ij = memory[i]; 


switch (direction) 
case 0: nextLineOffset = -4 * 3 + 1; break; 
case 1: nextLineOffset = XH break; 
case a nextLineOffset = 3 - 1; break; 
case nextLineOffset = 1; break; 

} daraus: break; 


for (uint8_t i = 0; i < 4; ++i) // for each "line" 
while (1) // for each square in the "line" 


int8 t nextSquare - square; 


(qseqaghift(dzrection)) 
H gde4gSpawn(): 


else 
G2048_ANIMATION_COUNTDOWN -= 1; 


} g2048Draw(); 


// RUNNER 


/* Memory is a list of obstacles, 
bytes: 1st is type, 2nd is x position. 


#define 
#define 
#define 
#define 
#define 
#define 


RUNNER OBSTACLE NONE O 
RUNNER OBSTACLE WALL 1 
RUNNER OBSTACLE CEILING 2 
RUNNER OBSTACLE WALL TALL 3 
RUNNER OBSTACLE WALL LONG 4 
RUNNER OBSTACLE MOVING 5 
#define RUNNER REAL OBSTACLES 5 
define 
define 


RUNNER OBSTACLE BONUS 6 // item: 
RUNNER OBSTACLE SHIELD 7 // item: 
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terminated by 0. Each obstacle takes two 


iA 


extra points 
protection 


#define RUNNER SCORE OBSTACLE 2 while (memory[i] !- RUNNER OBSTACLE NONE) 
#define RUNNER SCORE BONUS 5 
uint8 t w, h, e; 


; , 
#define RUNNER PLAYER WIDTH 5 uint8-t pos + mémory[i + 1]; 

#define RUNNER PLAYER HEIGHT 8 

#define RUNNER PLAYER X POSITION 16 uint8 t obstacle - memory[i]; 

#define RUNNER GROUND POS 40 

#define RUNNER RENDER X OFFSET 8 // so that obstacles go whole behind L border runnerGetObstacleSize(obstacle, pos, &w, &h, &e) ; 


#define RUNNER PLAYER PHASE INCREASE 7 


#define RUNNER SAVE SLOT 4 if (pos >= RUNNER PLAYER X POSITION + RUNNER PLAYER WIDTH) 


A break; 
ggetinS RUANER-PORTEROM MCE Vina tue], 2) 
efine S (uin i = . 
#define RUNNER NEXT OBSTACLE IN VAR canbe: t,3 uint8_t obstacleTo = e + h; 
#define RUNNER SHIELD COUNTDOWN Ls uint8 t,4 
#define RUNNER STATE VAR(uint8 - Ph // 0: play, 1: lost, 2: lost, high score pos * w » RUNNER PLAYER X POSITION && 
define RUNNER SCORE VAR(uinti6 i an playerFrom >= e && playerFrom < obstacleTo) | 


playerTo »- e && playerTo « obstacleTo))) 


uint8_t runnerLevel(void) if (runnerObstacleIsTakeable(memory[i])) 


return (RUNNER POSITION »» 8) & Oxff; runnerRemoveObstacle(i); 
if (obstacle == RUNNER OBSTACLE SHIELD) 


void runnerAddObstacle(uint8 t type) RUNNER SHIELD COUNTDOWN = 255; 


uint8_t i = 0; SAF playSound(SAF. SOUND. CLICK) 
while (memory[i] != RUNNER OBSTACLE NONE) else if (obstacle == RUNNER OBSTACLE BONUS) 
i += 2; RUNNER_SCORE += RUNNER_SCORE_BONUS; 
SAF_playSound(SAF_SOUND_CLICK) ; 
memory[i] = type; 
else 
itt; " 
memory[i] = SAF SCREEN WIDTH + RUNNER RENDER X OFFSET; if (RUNNER SHIELD COUNTDOWN == 0) 
dus RUNNER STATE - 1; 


memory[i] - RUNNER OBSTACLE NONE; // terminate SAF playSound(SAF. SOUND. BOOM) ; 
EN EE m ; 


uint8 t level = runnerLevel(); uinti6 t score = getHiScore(RUNNER SAVE. SLOT) ; 


if (level » 10) 


level - 10; if (RUNNER SCORE > score) 
n mS aveHiScore(RUNNER SAVE SLOT,RUNNER SCORE 
int8 t minDistance - 25 - level; RUNNER SSTA E Sa as ' E ) 


uint8 t additionalDistance = SAF random() % (18 - level); " 
eise 


RUNNER NEXT OBSTACLE IN = minDistance + additionalDistance; 


} TR cea EOD RC LS et 
RUNNER SHIELD COUNTDOWI 
uint8 t runnerObstacleIsTakeable(uint8 t type) ) l 
return type -- RUNNER OBSTACLE BONUS || type -- RUNNER OBSTACLE SHIELD; return: 
; 
void runnerGetObstacleSize(uint8- t type, uint8 t position, ee 
( uint8 t *width, uint8 t *height, uint8 t *elevation) i += 2; 
*width = RUNNER_PLAYER_WIDTH; } 
*height = (RUNNER PLAYER | HEIGHT * 3) / 4; ' 
*elevation - 0; void runnerDraw(void) 
switch (type) SAF drawRect(0,0,SAF SCREEN WIDTH,RUNNER GROUND POS, SAF. COLOR WHITE, 1) 
case RUNNER OBSTACLE WALL TALL: uint8 t groundPos = RUNNER POSITION % 32; 
*width -- 1; *height - RUNNER PLAYER HEIGHT; 
break; for (uint8_t i = 0; i < SAF SCREEN WIDTH; ++i) // draw ground 
case RUNNER OBSTACLE, WALL- LONG: for (uint8_t j = RUNNER_GROUND_POS; j < SAF_SCREEN_HEIGHT; ++j) 
*width = (*width * 7) / 4; *height /- 2; SAE dr awk ixel (a 
break; sif SAF PLATF gi. COLOR | COUNT > 2 
" roundPos & 0x10 ? SAF COLOR GRAY : SAF COLOR GRAY DARK 
. else 
Gase RUNE ee ANER BEAVER: HETGHT - 2: (i % 2 == j % 2) ? SAF COLOR BLACK : SAF COLOR WHITE 
break; p^ E ' Sendir 
; 
case RUNNER OBSTACLE MOVING: 
*width -- Ed groundPos++; 
*elevati 
(SAFi COS ( (RUNNER POSITION * 4 - position * 2) & Oxff) + 128) / 32; 
break; uint8 t height - RUNNER, STATE oe 9j 2 dj 
c^ a e STATE -- AF COLOR BLACK : ) 
: SAF frame & 0x2 ? SAF COLOR BLACK : SAF COLOR WHITE 
Cae FUNNER-OBSTACLE BONUS D: dx = RUNNER | MATE X POSITION - RUNNER RENDER X OFFSET, ^' 
pwidth = 4; *height = 4; *elevation = (RUNNER_PLAYER_HEIGHT * 10) / 4; dy = RUNNER-GROUND-POS - height - runnerPlayerHeight(); 
reak; 
' // draw the player: 
default: break; 
H SAF. drawRect (dx, dy, RUNNER. PLAYER WIDTH, height, color,1) 
H 
if (RUNNER SHIELD COUNTDOWN != 0) 
il runnerInit (void) SAF_drawCircle(dx + RUNNER_PLAYER_WIDTH / 2,dy + RUNNER_PLAYER_HEIGHT / 
RUNNER_POSITION = 0; Hif SAF PLATFORM COLOR. COUNT 22 
RUNNER PLAYER | PHASE” 0; SAF COLOR BLUE, 
RUNNER NEXT ! OBSTACLE IN = 0; #else 
RUNNER SHIELD COUNTDOWN = 0; . SAF. COLOR BLACK, 
RUNNER STATE - 0; #endif 
RUNNER_SCORE = 0; 9); 
memory[0] = RUNNER OBSTACLE NONE; uint8 t i - 0; 


H 
uint8 t runnerPlayerHeight(void) 
return SAF sin(RUNNER PLAYER PHASE) / 8; 


while (1) // draw obstacles 


uint8 t obstacle - memory[i]; 


ir Cobstacle == RUNNER OBSTACLE NONE) 
reak; 
uint8 t runnerPlayerTallness(void) 


return RUNNER PLAYER PHASE !- 255 ? RUNNER PLAYER HEIGHT : 
(RUNNER PLAYER HEIGHT / 2); 


uint8 t w, h, e; 
runnerGetObstacleSize(obstacle,memory[i + 1],&w,&h,&e); 


dx 


q memory[i + 1] - RUNNER RENDER X OFFSET; 
y 


void runnerRemoveObstacle(uint8 t index) RUNNER GROUND POS - h - e: 
= E ; 


while (memory[index] !- RUNNER OBSTACLE NONE] if (runnerObstacleIsTakeable(obstacle)) 
2 


memory[index] = memory[index + 2]; , SAF drawCircle(dx,dy,w 
Gree aaa taI = nenorytindex: £31; ud SAF betac le CO RUNNER, OBSTACLE BONUS ? 
} DORÉ SAF COLOR YELLOW : SAF COLOR BLUE,1 
H #else 


SAF_COLOR_BLACK, obstacle == RUNNER_OBSTACLE_BONUS 


void runnerResolveCollisions(void) #endif 


: NN else 
uinte t i = 0; SAF_drawRect (dx, dy, w, h, 


Hif SAF PLATFORM ! CÓLOR | COUNT » 2 
SAF COLOR RED DARK, 


1 


uint8_t playerFrom = FunnarPlayerHeight(), 
playerTo = playerFrom + runnerPlaàyerTallness(); #else 
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SAF. COLOR BLACK, 
#endif 


; 
is-2; 


H 
char text[12]; 
SAF intToStr(RUNNER POSITION / 8,text); 
uint8 t p = 
while (text[p] != 0) 
p++; 


1 


text = me 
text pl qs = 0; 
ie ea eY awrext (text 2,2, 
sif SAF PLATFORM COLOR COUNT > 2 
SAF COLOR GRAY 
#else 


SAF_COLOR_BLACK 
#endif 


1); 


d E COLOR BLAGR Aj — SCREEN WIDTH - 2,2,SAF_intToStr(RUNNER_SCORE, text), 
SAF_COLOR_BLACK 


if (RUNNER_STATE == 2) 

blinkHighScore(); 
void runnerScroll(void) 

RUNNER POSITION += 1; 

uint8 t i = 0; 

while (memory[i] != RUNNER OBSTACLE NONE) 
memory Hi + 1] -= 1; 
i += 2; 


} 
uint8_t addScore = 0; 


if (memory[0] != RUNNER OBSTACLE NONE && memory[1] == 0) 


addScore = memory[0] !- RUNNER OBSTACLE SHIELD && 
memory[0] !- RÜNNER OBSTACLE BONUS; 


// remove the obstacle once it's at position O 
runnerRemoveObstacle(90); 

if (addScore 
RÜNNER SCORE += RUNNER SCORE OBSTACLE; 


void runnerStep(void) 


runnerDraw(); 


if (SAF buttonPressed(SAF BUTTON B) »- BUTTON HOLD PERIOD) 
quitGame(); 


if (RUNNER STATE !- 9) 
if SAF_buttonJustPressed( SAE BUTTON_A) || 


SAF_buttonJustPressed(SAF_BUTTON_B) ) 
runnerInit(); 


return; 


uint8 t duck - SAF buttonPressed(SAF BUTTON DOWN); 


if (RUNNER PLAYER PHASE == 0) 


if (SAE buttonJu stp ssa (sar BUTTON_A) | 
SAF buttonPressed(SAF 


1 
// ju 
RUNNER PLAYER. PHASE = RUNNER, PLAYER PHASE INCREASE; 
SAF. playSound(SAF : SOUND | BUMP); 


else if (duck) 
RUNNER PLAYER PHASE - 255; 


l 
else if (RUNNER PLAYER PHASE !- 255) 
RUNNER PLAYER PHASE += RUNNER PLAYER PHASE INCREASE; 


if (RUNNER PLAYER PHASE » 128) 
RÜNNER PLAYER PHASE = 0; 


bise 


examples/test.h 
i Simple testing program for SAF. 


«PY drummyfish, released under CCO 1.0, public domain 


#define SAF PROGRAM NAME "Test" 
#define SAF SETTING BACKGROUND COLOR 0xe8 


#define SAF SETTING FORCE 1BIT 0 
#define SAF SETTING 1BIT DITHER O 
#define SAF SETTING FASTER 1BIT 2 
#define SAF SETTING ENABLE SOUND 1 
include "../saf.h" 
uint8 t saveValue - 0; 
void screeni() 

SAF clearScreen(SAF COLOR BLACK); 


SAF drawText("SAF test!",2,2,SAF COLOR WHITE, 1); 


ui 
ui 


vo 


gi 
#e 


} 


vo 


ui 


} 


RUNNER_PLAYER_PHASE = duck ? 255 : 0; 


if (RUNNER SHIELD COUNTDOWN !- 0) 
RUNNER SHIELD COUNTDOWN -= 1; 


runnerScroll(); 

runnerResolveCollisions(); 

if (RUNNER NEXT. OBSTACLE IN == 0) 
uint8 t level = runnerLevel() + 1; 


if (level » RUNNER REAL OBSTACLES) 
level - RUNNER REAL OBSTACLES; 


uint8 t r - SAF random(); 
if (r > 240) 


runnerAddObstacle(r » 245 ? RUNNER OBSTACLE BONUS 
: RUNNER OBSTACLE SHIELD); 


lise 
runnerAddObstacle(SAF random() % level + 1); 


else 
RUNNER NEXT OBSTACLE IN -= 1; 


nt8 t menuItem - 0; 
nt8 t firstClick = = ‘0; 


id menuStep(void) 


SAF clearScreen(SAF COLOR WHITE); 
SAF drawCircle(13,47,17,SAF ! COLÓR | GRAY DARK, 1); 


SAF drawRect(0,29,SAF SCREEN WIDTH, 6,SAF COLOR GREEN, 1); 


f SAF PLATFORM COLOR COUNT > 2 
SAF irawText(gameNames [menuTtem], 12,25,SAF COLOR GRAY,2); 
ndi 


SAF drawText(gameNames [menuItem], 11,24,SAF COLOR BLACK, 2); 
uinti6 t score = getHiScore(menuItem); 
char scoreText[6] - "XXX"; 


if (score !- 0 
SAF intToStr(score, scoreText); 


SAF drawText(scoreText,score < 10000 ? 6 : 1,45,SAF COLOR WHITE, 1); 


it (buttonPressedOrHeld(SAF BUTTON RIGHT)) 


menuItem = (menuItem + 1) % GAMES; 
SAF playSound(SAF SOUND CLICK); 


l 
else if (buttonPressedOrHeld(SAF BUTTON LEFT)) 


menuItem = (menuItem > 0) ? menuItem - 1 : (GAMES - 1); 


SAF playSound(SAF SOUND CLICK); 
if (SAF buttonPressed(SAF BUTTON A)) 
if (!firstClick) 
SAF ri upra E frame()); // create a somewhat random initial seed 
firstClick - 


switch (menuItem) 


case 0: snakeInit i stepFunction = &snakeStep; break; 
case 1: minesInit Pup pir - &minesStep; break; 
case 2: blocksInit(); stepFunction - &blocksStep; break; 
case 3: g2048Init( sto unction = &g2048Step; break; 
case ünner init) ; stepFunction = &runnerStep; break; 


} default: break; 


SAF playSound(SAF. SOUND CLICK); 


id SAF init(void) 


stepFunction - &menuStep; 


nt8 t SAF loop(void) 


stepFunction(); 
return 1; 


uint8 t index - 0; 


for (uint8 t y = 0; y < 16; ++y) 
for (uint8_t x = 0; x « 16; ++x) 


uint8 t color = ((x % 8) << 5) | ((y * 8) << 2) | (x 78+2* (y / 8)); 
int8 t x2 


int&t y2 = 1242 * y; 
for (int8 t j = 0; j < 2; 5) 
TOT int8_t i = 0; i < 2; ++i) 
| drawPixel(x2 + i, e * j,color); 
index++; 


char btnChars[SAF_BUTTONS + 1] = "UDLRABC"; 
char btnString[2] = "x"; 


for (int8_t i = 0; i < SAF_BUTTONS; ++i) 
btnstring[0] = btnChars[i]; 
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uint8 t pressed - SAF buttonPressed(i); 
int8_t x =2+i* 8; 


DAE NOU 48,7,8,pressed ? SAF COLOR WHITE : SAF COLOR GRAY DARK, 1); 


drawText 


btnstring, x + 2,50,pressed ? SAF_COLOR_BLACK : 
SAF | COLOR WHITE, 1); 


TO int8 t j 2 0; j APERE CO / 32) *tj) 
A “drawPixel(x’ y j, 58, SAF_COLOR Sobre) 


SAF_drawCircle(48, 28,12, SAF_COLOR_WHITE, 0) 

SAF drawLine(4 28,48 + SAF san RAF, trino * 12 / 128,28 * 
(SAF Ccos(SAF frame()) * 12) / 128,SAF COLOR LOW) 
H 


void screen2() 
SAF clearScreen(SAF COLOR WHITE); 


SAE drawRect(43,46,SAF sin(((SAE. frameo) à 2l %4256)) / 
2, SAF_cos((SAF-frame() % 256 2;SAF COLOR RED, 1); 


SAF drawCircle(-10,-20,SAF frame() * 128,SAF COLOR BLUE, 0); 
SAF_drawCircle(31, 31,(SAF_frame() >> 1) % 32,SAF. COLOR GRÉÉN, 0); 


SAF_drawText("random:\n b",1,1,SAF COLOR BLACK, 1); 
uint8 t bit = (SAF frame() >> 4) % 8; 
char numberStr[2]; 


SAF intToStr(bit,numberStr); 
SAF drawText(numberStr,11,6,SAF COLOR BLACK, 1); 


bit - 0x01 «« bit; 


for (int8 t y = 0; y « 16; ++y) 
for (int8 t x = 0; x « 16; ++x) 


uint8 t value - SAF random(); 
SAF drawPixel(44 + x,11 + y, value); 
F_drawPixel(23 + x,11 + y, value < 128 ? SAF_COLOR_BLACK : 
SAF | CoPOR- | GRAY); 
value - value & bit; 
value - value ? SAF COLOR_BLACK : SAF_COLOR_GRAY; 
SAF_drawPixel(2 + x,11 + y,value); 


SAF_drawText ("frame\ntime\nplat.",1,30,SAF_COLOR_BLACK, 1); 
char numberStr2[32]; 


SAF_intToStr parara) 4 o CAE" col 
SAF_drawText(numberStr2, 34,30,SAF. COLOR BLACK, 1); 


SAF floatToStr(SAF time() / 1000.0,numberStr2,3); 
SAF drawText(numberStr2,34,35,SAF COLOR BLACK, 1); 


SAF drawText(SAF PLATFORM NAME, 34, 40, SAF COLOR BLACK, 1) ; 


gnar allchars[10][11] = 


MV NU 
"*- /01234^, 
"56789: ;<=>", 

"2@ABCDEFGH", 

"TJKLMNOPQR", 
" STUVWXYZ [ ] "; 
"^, Q' abc 


i 


SAF drawText(allChars[(SAF frame() >> 5) % 10],1,50,SAF_COLOR_BLACK, 1); 


char num[] = "xxx"; 


SAF drawText(SAF intToStr(saveValue,num 


SAF drawText("saved:",1,58,SAF COLOR Lack, 1),58,SAF COLOR BLACK, 1) ; 


} 


uint8 t im 


0x07, 0x06, alton 0x0 , 0x00, Oxff , 0x00, 0x00, Oxff , 0x00, Oxed, Oxed, 0x00, Oxed, 0xe0, 0x00 
Bibel orea Guar ked, eyed 0x60, OKO Ever Exe Oley, OXE OXEA Quad Ren Ger Da 


0x00, 0x60, 0x00, OxFF, Oxff, Oxff, OXFF, Oxff, 0x00, Oxf f, OxFF, Oxff}; 


uint8 t imgCompressed[227] = { 


0x13, 0x20, 0xe0, 0x00, 0x28, 0x7c, 0x07, Oxfe, Ox4c, Oxf fF, 0x71, 0x70, 0x95, Ox6d, 0x92, 0x24 
0x48, 0x49, 0x60, 0x41, OxdO, 0x01, Ox2d, 0x01, OxCO, 0x01, OXOF, 0x08, OxOa, Ox1c, OxO1, OxaO 
0x01, 0x08, 0x3a, 0x15, 0x01, 0x90, 0x01, 0x59, 0x06, 0x01, Oxa0, 0x06, OXO5, 0x27, 0x05, 0x06 
0xa0, 0x06, 0x15, 0x27, 0x15, 0x06, 0x90, 0x06, 0x15, 0x27, 0x15, 0x06, 0x70, 0x11, 0x38, OxOe 
0x08, 0x2a, 0x11, 0x30, 0x11, OxOf, 0x08, Ox7a, 0x08, Ox1c, 0x11, 0x00, x01, Ox3F, Ox3b, 0x38 
Ox1b,0x2c, 0x11, Ox3d, 0xa2, 0x06, 0x02, 0x01, 0x00, 0x11, OxOd, 0x16, Oxde, 0x12, OxOe, 0x08 
0x09, 0x1e, 0x08, 0x06, 0x11, 0x30, 0x01, 0x02, 0x69, 0x18, 0x11, 0x70, 0x06, 0x05, 0x47, 0x05 
0x06, 0x90, 0x06, 0x15, 0x27, 0x15, 0x06, 0xa0, 0x16, 0x25, 0x16, OxdO, 0x02, 0x03, 0x02, 0x80 
0x34, 0x20, 0x02, 0x03, 0x02, 0x10, 0x43, 0x00, 0x14, 0x10, 0x14, 0x10, 0x02, OxOa, 0x02, 0x10 
0x13, 0x10, 0x13, 0x14, 0x10, 0x14, 0x10, 0x02, OxOe, 0x02, 0x10, 0x13, 0x10, 0x13, 0x14, 0x10 
0x14, 0x10, 0x01, 0x02, 0x01, 0x10, 0x43, 0x00, 0x54, 0x10, 0x01, 0x02, 0x01, Ox10, 0x13, 0x10 
0x13, 0x14, 0x10, 0x14, 0x00, 0x01, Ox1c, 0x0a, 0x01, 0x00, 0x13, 0x10, 0x13, 0x14, Ox10, 0x14 
0x00, 0x01, 0x22, 0x01, 0x00, 0x43, 0x80, 0x01, 0x02, 0x01, OXfO, 0x01, 0x02, OxO1, OxfO, OxO1 
0x02, 0x01, 0xe0, 0x01, Ox1b, OxOC, 0x01, OxbO, 0x11, Ox3b, OxOc, x11, 0x80, 0x01, 0x82, OxO1. 


0x70,0xa1, 0x30}; 
uint8 t imgiBit[25] = 


{ 
OxOc, OxOf , Oxe9, Ox7C, 0x03, 0x40, 0x20, 0x00, 0x80, 0x11, Oxf8, 0x96, Ox9d, 0x69, Oxcf, 0x3a 


0x01, 0x90, 0x1c, Oxeb, Oxc1, Oxbe, 0x07, Oxe3, OxFO}; 
uint8 t imgiBitMask[25] = { 


examples/chess.h 
bd 


Ox0c, OxOf , 0x16, 0x83, Oxfc, Oxbf , Oxdf , Oxff , Ox7f , Oxef, Oxf f, Ox7f , Oxe3, Oxfe, Ox3f , Oxc7 
Oxfe, 0x7f, Oxe3, OxFc, 0x3f, Oxc1, Oxf8, Ox1c, 0x00) ; 

uint8 t imgLogo[2 + 8 * 8]; 

int8 t trianglePoints[6] - (1,2,3,4,5,6); 

void screen3() 

t SAF clearScreen(SAF COLOR YELLOW); 


int8 t s - SAF sin(SAF frame n 
int8 t c - SAF cos(SAF frame 
int8ta-32-s/2,b-32-*4sS/2; 


SAF drawLine(a,32 - 64,b,32 * 64,SAF COLOR RED); 
SAF drawLine(32 - 64,b,32 + 64,a,SAF. COLOR RED); 


uint8 t transform = SAF TRANSFORM NONE + (SAF frame() >> 4) % 4; 


if ((SAE frame() >> 3) % 2 
transform |= SAF_TRANSFORM_FLIP; 


SAF. jürawImage(img, 
3245s - img 2 / 2; 
32 +c / 4 - img 
transform } sak? R NSFORM SCALE 3 | ((SAF frame() & 0x10) ? 0 
SAF_ TRANSFORM. NVERT), SAF_COLOR Ce TE)! 


SAF drawImageCompressed(imgCompressed,1,1,transform,SAF COLOR RED); 
SAF drawImage(img,40,1,transform,SAF | COLOR |! WHITE); 
SAF -drawImageiBit(imgiBit, 40, 20, img1BitMask, 255,0, transform); 


SAF drawImageiBit(imgiBit,50,45,0,255,0,SAF TRANSFORM NONE); 


SAF drawImageiBit(imgLogo,2,40,imgLogo,SAF COLOR BLUE, 255,SAF TRANSFORM NONE); 
for (int i = 0; i < 6; ++i) 
int8_t add = SAF random() > 127 ? 1: -1; 


mu ((add > 0 && trianglePoints[i] < 16) || (add < © && trianglePoints[i] > 
trianglePoints[i] += add; 


for (uint8 t i = 0; i < 3; ++i) 
uint8-t iq = 2 * d, 49 = 2 * (io T) €* 6; 


SAF drawLine( 
trianglePoints[ii] + 25, 
trianglePoints[ii + 1] 4 40, 
trianglePoints[i2] + 25, 
trianglePoints[i2 + 1] 4 40, 
SAF COLOR BLACK); 


H 

uint8 t phase - 0; 

void SAF init(void) 
saveValue = SAF_load(0); 


saveValuet++; 
SAF save(0,saveValue); 


imgLogo -8; 

t TES EL ] = 8; 

imgLogo[2] = (SAF_LOGO_IMAGE >> 56) & Oxff; 
imgLogo[3] = (SAF LOGO IMAGE >> 48) & Oxff; 
imgLogo[4] = (SAF LOGO IMAGE >> 40) & Oxff; 
imgLogo[5] - (SAF LOGO IMAGE »» 32) & Oxff; 
imgLogo[6] = (SAF LOGO IMAGE >> 24) & Oxff; 
imgLogo[7 SAF LOGO IMAGE »» 16) & Oxff; 
imgLogo[8 SAF LOGO IMAGE >> 8. & Oxff; 
imgLogo[9] = S$AF LOGO IMAGE & Oxf 

H 

uint8 t SAF loop(void) 

fir 0 

screen2(); 

#else 


switch (phase) 


case 1: screen2(); break: 
case 2: screen3(); break: 


case 0: serena break; 
default: break; 


uint32 t f = SAF frame() % 64; 
if (f »- 24 && f « 35) 
SAF drawRect(3,56,45,6,SAF COLOR GRAY DARK, 1); 
uint8 t i = (SAF frame() / 64) % SAF. SOUNDS; 
char s[8] = "sound x"; 
s[6] = '0' + i; 
SAF drawText(s,4,57,SAF COLOR RED, 1); 
if (f == 24) 
SAF playSound(i); 


a (SAF frame() != © && SAF frame() % 128 == 0) 
phaset++; 
phase %= 3; 


return 1; 
#endif 


} 


Simple chess for SAF, using smallchesslib. 
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"d drummyfish, released under CCO 1.0, public domain 


#define SIMPLE 0 // simpler version with 1b graphics 
#define AI_COUNTDOWN 20 /* If -1, AI against AI will require pressing A to 
m 


another move. If >= O0, AI vs AI will wait this 
. number of frames before making another move. This 
is 
because AI takes long to compute moves and delay 
: SAF frames greatly, freezing rendering. * 
#define MAX_AI_LEVEL 5 


#ifdef SAF_PLATFORM_ARDUBOY 
#define SIMPLE 1 


#endif 
#if HI UT PEATEDRM | ARDUBOY) 
#define MÁX AI LEVI 2 
#define AI COUNTDOWN -1 
#elif defined(SAF PLATFORM POKTTTO | | SELBE (sae PLATFORM_GAMEBUINO_META) | 
" éd(SAF PLATFORM ESPBOY) || 


defined(SAF PLATFORM -RINGOJ Il d 
defined(SAF PLATFORM NIBBLÉ) 

define MAX AI LEVEL 3 

#define AI COUNTDOWN -1 

#define SCL RECORD MAX LENGTH 128 
#endif 


Hif defined(SAF PLATFORM NIBBLE) || defined(SAF PLATFORM ESPBOY) 
i #def ine SCL_CALL_WDT_RESET 1 
endi 


#define SAF SETTING ENABLE SAVES 0 
#define SAF PROGRAM NAME "Chess" 


#define SAF SETTING FASTER 1BIT 2 
#define SAF SETTING ENABLE SOUND 1 
#define SAF SETTING ENABLE SAVES 0 


sif SIMPLE 
#define SCL RECORD MAX LENGTH 1 
#endif 


#define SCL_EVALUATION_FUNCTION SCL_boardEvaluateStatic 
#define SCL_960_CASTLING 1 


#include "../saf.h" 
#include "smallchesslib.h" 


#define STATE MENU 0 
#define STATE PLAYING 1 
#define STATE_END 255 


#define MENU ITEMS 5 
#define GAME_TYPES 4 


#define SQUARE LIGHT 0xb6 
#define SQUARE DARK 0x92 
#define SQUARE PIECE 0x7a 
#define SQUARE MOVE xdi 
#define CURSOR COLOR 0xai 


sif SIMPLE 

#undef CURSOR COLOR 

#define CURSOR COLOR SAF COLOR BLACK 
#endif 


uint8_t state = STATE, . MENU; 
uint8 t menuItem = 9; 

uint8 t playerW 

uint8 t playerB - 0; 

uint8 t variant 9; 
uint8 t soundOn 
uint8 t visua Se lectedsquare = 0; 
uint8_t boardFlipped = 0; 

int8 t previousMove[2]; 

int8 t selectedPiece - -1; 


int8 t aiCountDown - AI COUNTDOWN; 


SCL Game game; 
SCL SquareSet allowedSquares; 


#define STR(s) s 


Hif !SIMPLE | 
SCL Board variantStartState; 
#endif 


const 

sif SAF PLATFORM HARWARD 
PROGMEM 

#endif 

st ca images[] = 


// PIECES (0): 

Oxff, Oxfc, Oxed, 0xb5, 0xe0, 0x00, // 
0x01, oxe3, 0x2d, 0xb5, 0xe0, 0x00, // 
Oxc6, Oxe7, 0x82, oxda, Oxe8, 0x00, // 
Oxce, Oxd7, Ox8c, @xb5, O0xe0, 0x00, // 
Oxb5, 0x27, Oxad, Oxb5, Oxe0, 0x00, A 


white pawn 
white rook 
white knight 
white bishop 
white queen 


Oxfe, 0x17, 0x9e, Oxb6, 0xd0, 0x00, // white king 
Oxff, Oxfc, Oxei, 0x84, 0x00, 0x00, // black pawn 
0x48, 0x00, 0x21, 0x86, 0x10, 0X00, // black rook 


Oxce, 0x10, 0x41, 0xc6, 0x00, 0x00, // black knight 
0xce, 0x10, 0x21, 0xce, 0x10, 0x00, // black bishop 
Oxb4, 0x00, 0x21, 0x84, 0x00, 0x00, // 10: black queen 
Oxfe, 0x10, 0x00, 0x86, 0x10, 0x00, // 11: black king 

// ICONS (12): 

Oxcf,0x30,0x12,0xce,0x13,0x00, // 12: human 

Oxfc, 0x05, Ox0a, 0x50, 0xa0, 0x00, // 13: game . 

0x84, Oxcf, 0x39, oxcf, Oxfc, 0xc0, // 14: question mark 
Oxdf, Ox3c, 0x75, Oxdc, 0x71, 0xcO, // 15: note 

Oxdf, 0x30, 0x40, 0x07, 0x3d, 0xc0, // 16: arrow 


(Q0 -Oo Uii (NHPO 


sif !SIMPLE 
// MASKS (17): 
0x00, 0x03, Ox1e, Ox7b, Oxf f, OxcO, 
Oxff, Oxff, Oxde, Ox7b, Oxff, Oxc0, 
0x39, Oxff, Oxff, 0x3d, Oxf7, 0xc0, 
0x31, Oxef, Oxf f, Ox7b, Oxff, Oxc0, 
Ox4b, Oxff, 0xde, @x7b, Oxff, 0xc0, 
0x01, Oxef, Oxff, 0x79, Oxef, Oxc0, 
0x00, 0x03, Oxie, 0x7b, Oxff, @xco, 
Oxb7, Oxff, Oxde, 0x79, Oxef, Oxc0, 
0x31, Oxef, Oxbe, 0x39, Oxff, 0xc0, 
0x31, Oxef, Oxde, 0x31, Oxef, Oxc0, 
Ox4b, Oxff, 0xde, Ox7b, Oxff, 0xc0, 
0x01, Oxef, Oxf Ff, 0x79, Oxef, O0xc0' 

#endif 


N 


uint8 t image[8]; 

Hif !SIMPLE 

uint8 t imageMask[8]; 

#endif 

void drawImage(uint8_t index, uint8_t x, uint8_t y) 
const uint8_t *byte = images + index * 6; 


for (uint8_t i = 2; i < 8; ++i, ++byte) 
#if SAF_PLATFORM_HARWARD 


image[i] = pgm_read_byte(byte); 
#else 

image[i] = *byte; 
#endif 
sif !SIMPLE 


if (index «- 11) 
byte = images + (index + 17) * 6; 


for (uint8_t i = 2; i < 8; ++i, ++byte) 
sif SAF PLATFORM HARWARD 
imageMask[i] - pgm read byte(byte); 
else 
imageMask[i] = *byte; 
#endif 


byte 


imageMask; 


else 
byte 

#else 
byte = 

#endif 


9; 


e 


NONE), nee (imags, ,x,y, byte, SAF_COLOR_WHITE, SAF_COLOR_BLACK, SAF_TRANSFORM_ 


H 
ye drawBoard(void) 
#if SIMPLE 


SAF clearScreen(SAF COLOR WHITE); 
#endif 


const char *c = game.board; 
uint8_t x = 0, y= 


boardFlipped ? 0 : 64 - 8; 


uint8_t square 0; 
for (uint8_t i = 0; i < 8; ++i) 
= boardFlipped ? 64 - 8 : 0; 
for (uint8_t j = 0; j < 8; ++j) 
char s = *c; 
uint8_t squareColor = SQUARE_LIGHT; 


#if SIMPLE : 

SAF drawPixel(x * 4, y * 4,SAF COLOR BLACK); 
#else . . 

if (square == selectedPiece || 
SCL_squareSetContains(al LowedSquares, square) ) 


squareColor = SQUARE_PIECE; 
else if (square == previousMove[0] || square == previousMove[1]) 
squareColor = SQUARE MOVE; 


else if (i % 2 == 


squareColor - SQUARE. ee 


SAF_drawRect(x,y,8,8,SquareColor,1); 


#endif 
if (s !='."') 
uint8 t image - 0; 
switch (s) 
case 'R': image - 1; break; 
case 'N': image - 2; break; 
case 'B': image - 3; break; 
case TE image - 4; break; 
case 'K': image - 5; break; 
case 'p': image - 6; break; 
case 'r image - 7; break; 
case 'n image - 8; break; 
case 'b image - 9; break 
case 'q image - 10; break; 
case 'k image = 11; break; 
default: brea 
H 
Hif SIMPLE ; 
if (square !- selectedPiece || SAF frame() & 0x04) 
#endif . 
drawImage(image,x + 1,y); 
C++; 


; 
x *- boardFlipped ? -8 : 8; 


square++; 
y += boardFlipped ? 8 : -8; 


if (state == STATE PLAYING &&( 
!Iplayerw && SCL_boardwhitesTurn(game. board) 
!playerB && !SCL boardwhitesTurn(game.board)) 


// cursor: 


x 
y 


SAF_drawRect (x, y, 8, 8, CURSOR COLOR, 0) ; 


{yisualselectedsquare / 8) * 8j 
} 
if (game.state != SCL_GAME_STATE_PLAYING && (SAF_frame() & 0x08)) 
SAF drawRect(32 - 10,32 - 10,20,20,SAF COLOR WHITE, 1); 
Hif SIMPLE 
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SAF drawRect(32 - 11,32 - 11,22,22,SAF COLOR BLACK, 0); H 
#endif else ; 
unselectPiece(); 


char resultStr[4]; 


sas 2 zd D initGame(void) 
resultstr[2] = '1'! #if SIMPLE 
resultStr[3] = 0; SCL_gameInit(&game, NULL); 


#else 


switch (variant) 


if (game.state SCL_GAME_STATE_WHITE_WIN) 


resultStr[2] 9'; case 1: 
else if (game.state == SCL GAME STATE BLACK WIN) SCL boardInit960(variantStartState,SAF frame() % 960); 
resultStr[0] = '0'; break: 
else f 
resultStr[1] = '/'; case 2: 
resultstr[2] = '2': SCL. Tantstarestareiesf eke SCL FEN HORDE); 
Su rt ; variantStartState[59] = ! 
break; 
SAF drawText(resultStr,24,30,SAF COLOR BLACK, 1) ; cáco-3 
H 3 SCL_boardFromFEN(variantStartState, SCL_FEN_KNIGHTS); 
break; 
void drawMenu(void) default: 
SAF clearScreen(SAF COLOR WHITE); } break; 
for t8t j-0 < 12; ++ d 3 
ruri i S al ici Du | WIDTH; ++i) SCL_gameInit(&game, variant == 0 ? NULL : variantStartState) 
if (Gf 4) % re (i 7 4) % 2) j #endif 
SAF drawPixel(i,j,SAF COLOR BLACK); 
nt : SCL v LondonSimp LeSeed ( SAF_ frame() * 256); 
define YO 15 previousMove[0] - - 
#define Y 9 previousMove[1] = d 
#define X 13 visualSe ectedSquare’ = SCL_BOARD_SQUARES / 2; 
#define X2 24 } unselectPiece(); 
uint8 t x = X, y = YO; 
A ^ void getAIMove(uint8 t *sO, uint8 t *s1, char *p) 
drawIma 2 E : r 
wImage(2,x, y); uint8 t level = SCL boardWhitesTurn(game.board) ? playerW : playerB; 
= X2; 
a ! vines t de m level; T 
uin extraDep = Leve 
Mu 2: uint8 t randomness = game.ply < 2 ? 1 : 0; 
else i 
for (uint8_t i - 0; i < playerW; ++i) sacl (level) 
+ s 
drawImage(0,x + i * 8,y); case 1: depth - 1; extraDepth - 1; break; 
x2X case 2: depth - 2; extraDepth - 1; break; 
=Y: case 3: depth = 2; extraDepth = 2; break; 
y m, case 4: depth - 3; extraDepth - 2; break; 
case 5: depth - 3; extraDepth - 3; break 
drawImage(8,x,y); } default: break; 
x = X2; 
if (playerB == 0) FC getAIMove(game board, depth, extrabepth, 0, SCL_boardEvaluatestatic, SCL_randoms 
drawImage(12,x,y); imple 
else d randomness, 0,0, SO, s1, p) 
for (uint8 t i = 0; i « playerB; ++i) Y} 
drawImage(6,x + i * 8,y); 
pu orientBoard(void) 
xX = X; 
y += Y; boardFlipped - !playerB && 
i playerw || 
drawImage(13,x, y) ; (state == STATE PLAYING && !SCL boardWhitesTurn(game.board)) 
x = X2; ) E 
uint8 t variantImgaes[] = {1,14,0,2}; ; 
drawImage(variantimgaes [variant], x,y); void playSound(uint8 t sound) 
ifndef SAF PLATFORM ARDUBOY 
x= X; // sounds are messed up on arduboy due to AI delaying frames 
y += Y; if (soundOn) 
SAF playSound(sound); 
drawImage(15,x, y); d 
if (!soundOn) . 4s ; 
for (uint8 t i = 0; i « 5; ++i) void SAF init(void) 
SAF. "drawPixel(x + i,y + 2 + i,SAF COLOR BLACK); i 
image - H 
a tmagela] = 7! 
drawImage(16,x,y); airsTMOLE 
y = menuItem * Y + 1 + YO; imageMask 2] z 9; 
NES #endi ' 
SAF drant ixet(a, gee COLOR BLACK); initGame() 
SAF. “dranbixel (x,y, SAF- COLOR BLACK); 
X++; 
SAF. ` dranbixet(x y, SAF COLOR BLACK); uint8 t SAF loop(void) 
x--; 
SAF “atawbixel (x,y, SAF COLOR BLACK); orientBoard(); 
x--; 
SAF I dvawbixel (x,y, SAF COLOR_BLACK) ; switch (state) 
gander X gase STATE_MENU: 
#undef Y 
#undef YO if (button(SAF BUTTON UP)) 
#undef X2 menuItem -- menuItem » ?1 


else if (button(SAF BUTTON KM 
menuItem += (menuItem « MENU EMS - 1) ?1: 0; 


uint8_t button(uint8_t button) 


switch (menuItem) 
return SAF_buttonPressed(button) == || SAF buttonPressed(button) > 12; { 


case 0: handleMenuItemPlayer(&playerW); break; 
case 1: handleMenuItemPlayer(&playerB); break; 


void handleMenuItemPlayer(uint8 t *player) 


t sif !SIMPLE 
if (button(SAF BUTTON RIGHT)) case 
*player += *player < MAX ÁÍ LEVEL ? 1 : 0; if (utton(SAF.. BUTTON RIGHT) 
else if (button(SAF BUTTON LEFT)) variant = (variant + i D mE TYPES; 
*player -= *player > 09? 1 : 0; else if (button(SAF BUTTÓN LEFT)) 
variant = variant > © ? (variant - 1) : (GAME TYPES - 1); 
void unselectPiece(void) . break; 
#endif 
selectedPiece = - 
SCL ee guaraserclear (al lawedsqdareeys case 


if (button(SAF | BUTTON RIGHT) || button(SAF BUTTON LEFT) | 
bütton(SAF BUTTON AJ) 


void trySelect(uint8 t square) soundOn - !soundOn; 
char c - game.board[square]; break; 
if (c != '.' && SCL pieceIsWhite(c) == SCL boardwhitesTurn(game.board)) case 


selectedPiece - square; if (Sar. buttonJustPressed(SAF BUTTON A)) 
SCL boardGetMoves(game.board, square, allowedSquares) ; initGame(); 
; 
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state - STATE PLAYING; SCL gameUndoMove(&game); 


previousMove[9] = -1; 
break; previousMove[1] = -1; 
unselectPiece(); 
default: break; } F 
if (SAF buttonJustPressed(SAF BUTTON B)) if (moveFrom !- 9 || moveTo !- 0) 
state - STATE PLAYING; { 


uint8_t capture = game.board[moveTo] != '.'; 


drawMenu(); 
O; SCL gameMakeMove(&game, moveFrom, moveTo, movePromote) ; 


break; 
moveFrom; 


previousMove[0 
moveTo; 


previousMove[1 


ase STATE_PLAYING: 
qr i it (game.state != SCL_GAME_STATE_PLAYING) 


uint8_t moveFrom = 9, moveTo = 0; state = STATE END: 


har Promot m 
dieu col E playSound(SAF. SOUND. BOOM) ; 
if (aiCountDown « 0) prewioucmeveld z ET 

unselectPiece(); 


if (SAF buttonJustPressed(SAF BUTTON A)) 
} aiCountDown = 0; élse 
élse if (aiCountDown > 0) playSound(capture ? SAF SOUND CLICK : SAF SOUND BUMP) 
aiCountDown--; 


; ; if (SAF buttonJustPressed(SAF BUTTON B)) 
if ((playerw && SCL boardwhitesTurn(game.board IB t a 
bed && T SCL PRIM ES Turn game Boards 3% state = STATE_MENU; 
if (playerW == 0 || playerB == 0 || aiCountDown == 0) HEBHBOREO C; 
i 
getAIMove(&moveFrom, &moveTo, &movePromote); } 


aiCountDown = AI COUNTDOWN; STATE END 
case | 


l { 
else if (SAF buttonJustPressed(SAF BUTTON B)) 
if (button(SAF BUTTON RIGHT)) initGame(); 
visualSelectedSquare += visualSelectedSquare % 8 < 7? 1 : 0; state - STATE MENU; 
else if (button(SAF BUTTON LEFT 
visualSelectedSquare -- visualSelectedSquare % 8 > 0? 1: 0; sif !SIMPLE. 
else if (button(SAF BUTTON UP)) else if (SAF frame() % 10 == 0) 
visualSelectedSquare -- visualSelectedSquare » 7 ? 8 : 0; { 
else if (out ton(SAF_BUTTON DOWN) ) game.ply = (game.ply + 1) % (SCL_recordLength(game.record) + 5) 
visualSelectedSquare += visualSelectedSquare « 56 ? 8 : 0; 
. if (variant == 0) 
if (SAF buttonJustPressed(SAF BUTTON A)) 1S L boardInit(game.board); 
else 
uint8 t selectedSquare - boardFlipped ? SCL boardCopy(variantStartState,game.board); 


visualSelectedSquare / 8) * 8 + 7 - visualSelectedSquare % 8) : 
7 - visualSelectedSquare / 8) * 8 + visualSelectedSquare % 8); uinti6 t i = 0; 


if (selectedPiece « 0) : i : : 
trySelect(selectedSquare); T (i < game.ply && i « SCL recordLength(game.record)) 
else uint8 t sO, s1; 
char p; 


if (SCL_squareSetContains(allowedSquares, selectedSquare) ) 


= ; i SE L-boshaMakeMove [dame Road i,&s0,&s1,&p); 
moveFrom - selectedPiece Lo! Yu © n 
moveTo = selectedSquare; ’ SCL boardMakeMove(game.board, s0, s1,p); 
} unselectPiece(); ink 
; 
else if (selectedSquare -- selectedPiece) } J 
unselectPiece(); #Hendif 
e 


se 
trySelect(selectedSquare) ; drawBoard(); 

i 
break 


} reak; 
else if (SAF_buttonJustPressed(SAF_BUTTON_C)) j } 
SCL gameUndoMove(&game); 

return 1; 


if (playerw || playerB) // against AI actually undo 2 plys 


Comun 
Readme 


comun 
The best programming language, for the benefit of all living beings. 


This repository contains specification of, supplemental materials for and implementation of comun, a minimalist and idealist KISS/suckless 
public domain language wholly made with selfless mindset of just creating purely good, non-consumerist, maximally helpful and harmless 
technology without any self interest. 


Currently there is a KISS C implementation, self hosted implementation is work in progress. Also keep in mind that 
EVERYTHING is work in progress. But it's usable already. 


Want to program in comun? There is a tutorial! 

Don't forget to check out the docs directory with specification, frequently asked questions etc. 

There is already a tiny game written with comun and SAF: Flying Ball. 

Fun note: I just noticed brainfuck is trivially translated to comun just by renaming commands, proving comun is indeed Turing complete :) 


about the language 

Brainfuck is minimal and elegant but practically unusable, C is extremely usable but bloated (500 page specs?) with unnecessary stuff (even 
the super minimal TCC has over 20 KLOC and took an enormous effort to write)... and is legally owned by ISO. We need something in between 
eid free; both legally and practically). Joke languages like C++ and Rust are an insult to intelligence and won't be mentioned beyond this 
sentence. 


We don't need another "modern" language because in the age when everything is getting worse "modern" means "as of yet the worst" -- we 
need a new iteration of an old language, additionally made with selfless attitude and a wider vision of how technology should ideally be, i.e. 
simple and helpful. 

The language needs to be usable but also simple as simplicity is necessary for true freedom because it implies that many implementations can 
be made on many platforms by many people and so no one controls/owns the language. It has to respect old and weak devices (such as 
embedded computers) and devices that would likely be made in ideal society (simple computers), and must of course have no dependencies 
on cancerous "modern" technology -- it must be free from it not only physically, but also by philosophy and mentality. It must ideally not 
depend on anything. 


The philosophy and features of the language are summed up here: 
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* completely free, public domain: Not only is the language implementation free by a license, as is standard nowadays (though many still try to keep 
trademarks), it is completely public domain without any legal restrictions, it is suckless (guaranteeing practical freedom rather than just freedom on 
paper) AND the language specification is also completely public domain (unlike e.g. with C). It's pretty depressing that nowadays it's even POSSIBLE 
to somehow "own" something about a language (its description, name, implementation or mere ideas used in the implementation) -- such concepts must 
be strictly shit on. 

* Specification that fits on a sheet of paper (well, using both sides and a lot of text squeezing), you can hold the whole language easily in your head -- 
there are about 50 built-in commands, most of which are typical operators such as +, -, < etc. 

* KISS/suckless, no bloat/bullshit: No package manager, no standard library, no floating point (say no to the float rabbit hole!), no Unicode (sorry, no 
pregnant men in comments), no IDEs, no legal conditions, no trademarks, no OOP, no generics, no furry mascots, no COCs, no memory safety, no 
handholding, no AI, no toxic woke discord communities etc. 

* great balance of minimalism vs usability: The language is pretty minimal but not "pseudominimal" (i.e. minimalist only on the outside, like most 
other languages nowadays) -- if desired, its interpreter can be implemented in a few hundred lines of pure C without any libraries, but it still tries to be 
usable for writing real programs (even if it may take more effort than with "modern" bloat languages in which you basically write an AI prompt and get 
a program). Programs written in simple languages are inherently superior in the end, and worth the effort; there is no counter argument that isn't 
justified by technology consumerism. 

* imperative, no bullshit paradigms: Computers are inherently imperative and therefore imperative paradigm is the closest, most natural, best 
predictable, most easily implemented and mapped to hardware paradigm while also being closest to natural human thinking. In terms of universal 
applicability there is nothing better, there is nothing to improve or invent, forcing arbitrary silver bullet paradigms is just a bullshit soydev fashion. 
Higher abstractions are to be implemented as a libraries or languages above this one. 

e Stack-based: Stacks are based so we base our language on stacks. The language is similar to FORTH, expression evaluation happens on stack, as well 
as passing arguments to functions. This is also how most CPUs compute, so it nicely maps to assembly. 

* reverse Polish notation: Simple, no complex parsers, grammars, no bracket symbols or operator precedence needed (yes, there are downsides like not 
being able to tell how many parameters a function takes from an expression, but it's no big deal). 

* optional pointers: Global pointers can be used to serve as variables or arrays in traditional languages, or to create and manage multiple stacks. With 
pointers memory can be statically allocated. There is no dynamic allocation, that's bloat. 

* minimal, intuitive and consistent syntax: The goal was to try to use as few symbols and rules as possible, no complex grammar; there are no 
semicolons, expression brackets, English words etc. Intuitive symbols are used instead (e.g. ? instead of if etc.). Consistent rules are used, e.g. 
directives start with ~, pointer commands with $, appending ' to a command makes it non-popping etc. 

* simple 1-2-3 symbol math-like commands, no English: This is firstly more elegant and secondly makes source code shorter (which may matter on 
devices with limited memory and small displays). Also it will make golfers happy. 

e low level but structured and portable: Traditional control structures exist, goto command can optionally be supported to e.g. allow the possibility of 
translating assembly to comun. 

* minimum abstraction: Only as little abstraction as possible should be present to offer portability. High abstraction hard wired to language is poison as 
any higher abstraction's scope is limited and causes problems outside this scope. Only generally applicable abstraction are portable imperative 
commands as every computer works this way. Any higher abstraction is to be offered by a library, not the language itself. 

* functions, recursion: must have 

* different width data types (optional): If you care about different width types, you may use separate type environments (one for native type, one for 
8bit integers, 32bit integers etc.). This allows utilizing memory well on devices with low amount of RAM if needed. Two's complement is guaranteed, 
values are considered unsigned but there exist signed operations (e.g. signed divide or signed compare, like in assembly languages). 

* avoiding issues with platform specifics (int width, pointer size, endianness, ...): Where these specifics would cause an issue, there is a mechanism to 
abstract them away (for example pointers exist in a table separate from the main memory so that their size doesn't matter to the program). Different 
width integers are in separate memories so byte sex doesn't affect the program etc. 

* comfy features that don't cost much: e.g. string literals, hex and bin literals, comments, a bit of syntax sugar like - - for printing strings, ... 

e file includes: Simple "copy-paste include" of files allows for creating libraries. 

* Unix philosophy/do one thing well: Be a programming language, not a platform, IDE, package manager, virtual machine or anything like that. 
Implement true modularity and reusability (not just that which serves internal project organization but one that truly encourages wild hacking by 
others). 

* no paying for unused features, non-basic features are optional: The design is such that if you e.g. don't want to use different data types, you simply 
do nothing and the language uses the default one (platform's native type). If you don't need pointers, they're not there, if you don't need functions, 
they're not there, if you don't need signed operations, they're not there, if you don't use preprocessor, it's not there etc. This is great because even partial 
Janguage implementations can still accept many programs that don't make use of advanced features. 

* avoid boilerplate: Why require some weird copy-paste magic code in a simple programs when it doesn't have to be there? 

* indentation doesn't matter: Some languages like Python make indentation express program structure. This is bad because there are many cases when 
you want to compile unindented or badly indented code, e.g. minified code, one liners or code in which you use wrong indentation to mark temporary 
debugging code. 

* non-commercial, no aim for profit, goal is purely higher good: The language is created as a part of LRS (less retarded software/society) which aims 
for creating purely good (free, simple, future proof, hackable, repairable, hardware nondiscriminating, ...), selfless technology that's supposed to help all 
living beings without exploiting them. 

* preprocessor using the same language: Preprocessor is present (though optional) because it is important e.g. for compile-time precomputations 
(important type of optimization), templated code or writing portable code that decides which platform-specific libraries to include or what constants to 
set before compilation etc. However it is specified in a very simple way (and is simple to implement), without needing a separate language: with 
preprocessing one simply writes a comun program that outputs a source code of the final comun program. 


examples/overview 

Simple "hello" program in comun may look like this: 

© "hello :)" --> 

Here are a few basic functions written in comun, notice how beautifully simple the code is (please forgive lack of syntax highlight, there is a 
syntax highlighted example in other/syntax highlight example.html): 


max: <' ?»« . ^, # takes maximum of two values ^1 
max3: max max . # takes maximum of three values 
# recursive factorial # iterative factorial 
factR: Tani: 
5! us 


$0 -- factR * 
f Q' 
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>< $1 * >< 
i # converts number to zero-terminated string 
numToStr: 
0 >< 
i @@ 
# power, raises A to B $0 10 % "OQ" + >< 
pow: 10 / 
1 >< 
$0 0 = ? 
' !Q 
>< $2 * >< . 
^ 
A >< A 
# converts signed number to zero-terminated string 
. n ; : : . 3 numToStrs: 
eet sine function approximation with quadratic curve $0 9 << 
sin8: 7 
$0 256 % 64 / # quadrant -1 >< - 1+ 
>< 64 % numToStr 
12% 1- ? : 
$ eet ' numToStr 
63 - $0 * 32 / . 
» # prints number 
>< 1 <=? printNum: numToStr --> 
255 >< - : s 
n # prints number as signed 
printNumS: numToStrS --> 


For more insight see the specification, tutorial and example programs. 


files 


The following is a summary of some of the important files in this repository: 


Src. c: comun implementation in C99 (until self-hosted one is finished) 
* comun.h: 
* full comun implementation as a library 
* «4000LOC 
* single header library, KISS/suckless 
* pure C99 
* no dependencies, not even standard library (except for tiny and trivially replaceable stdint.h) 
* no dynamic allocation (malloc, ...) 
* very efficient, works even on EXTREMELY weak embedded devices, so far tested on: x86 PC, Pokitto (ARM, 36 Kb RAM, ran 
the SAF comun game), Arduboy (8 bit CPU with only 2.5 Kb RAM, ran minitest.h) 
* Supported type environments: 0 (native type), 8bit, 16bit and 32bit 
* simple implementation-specific bytecode: 16 bit instructions (8 bit opcodes), assembly-like but with meta-information allowing 
also easy transpiling to higher level structured languages 
e Simple optional optimizations of the bytecode implemented: inlining, removing unused functions, replacing operations with more 
efficient ones etc. 
* comun.c: 
e standalone compiler/transpiler/interpreter/debugger/tool using comun . h 
e so far can compile to C, comun bytecode and comun (e.g. for decompiling bytecode) 
* transpiled code is itself KISS, it's a single file that doesn't use any libraries which aren't strictly needed 
e «960 kb binary (achieved with gcc -Os) 
* minicomun.h: 
* comun subset, yet simpler than full comun, can be used e.g. as a super tiny, extremely simple mini scripting language 
* tiny single header pure C99 implementation 
* «1000LOC 
e «20 kb binary (standalone version, achieved with tcc) 
* compared to full comun: no goto, no preprocessor, no file includes, only type environment 0, no pointers except for built-in 1 letter 
pointers that can only be used as variables 
* extremely KISS, interprets the source code string directly without any transformations (no bytecode, syntax trees etc.), uses no 
dynamic allocation etc. 
* single header library which can itself also be compiled into a standalone interpreter (just compile the header itself with - 
dMCM STANDALONE-1) 
* zero dependencies, not even standard library (only stdio required for the standalone version, NOT needed for pure library) 
docs: documentation and documents related to the language 
e specification. md: language specification, < 5000 words (wc -w) 
* bytecode.md: implementation-specific bytecode documentation 
e tutorial.md: language tutorial for beginners 
programs / *: various programs in comun, serving as examples and tests, including some basic libraries 
src cmn/*: 
* self hosted implementation (comun in comun) 
* WORKIN PROGRESS 
other/ *: other files, including e.g. vim syntax highlighter 


limitations 
There are still limitations, disadvantages, TODOs etc. These include: 


No uber features like memory safety, floats, huge standard library etc. -- this is actually a feature and should be pretty clear, the language is low 
level and simple. 

At the moment there is no switch statement (it may be added in the future). Multibranching therefore has to be done with if statements which firstly 
doesn't look awesome (many endifs at the end) and secondly is slower (compared to proper O(1) switch with address jump table) -- smart compilers 
(e.g. when you transpile to C) may still optimize such an if sequence to address jump table, but comun itself doesn't currently do this. 

Current C implementation limits the maximum token length -- this is for simplicity and also because of input flexibility; we need to keep the token 
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in memory to analyze it but don't want to use dynamic allocation, so we have a statically preallocated fixed sized memory for it. The implementation is 
also made to allow any input stream of characters, not just a string in memory, so it can't just keep a pointer to the token in input string, it has to copy it 
somewhere. This practically just limits you in one way: you can't use very long string literals, but this is easily solved: just split them. 

* No function pointers -- function pointers aren't necessary though they can be useful and fast in many situations. But they come with a lot of extra 
complexity. 

* Current C implementation isn't 100% correct and robust -- Again, for simplicity the current implementation doesn't work in 100% cases, e.g. some 
things such as maximum token length are limited, or as a primitive hash table is used for identifiers, it is possible for a name collision to occur -- though 
unlikely, this could prevent compilation of a theoretically valid program (still names up to a certain length are guaranteed to not collide, and you can 
always increase the size of the hash if you encounter issues). If you try hard enough you can probably segfault the current implementation by doing 
some real crazy stuff like trying to interpret some manually hexedited bytecode -- such things haven't been tested and they're sometimes not even 
checked. There may be more things like this. Keep in mind the current C implementation is for now considered a temporary solution to allow us to 
write comun programs until we make a beautiful self hosted implementation. 

* Current C interpreter isn't super efficient: it's written to be simple rather than extremely fast or memory efficient, it could be made much faster; self- 
hosted implementation will aim to improve this). 

* When enabled, preprocessor RAM usage grows with source code size, i.e. no O(1) preprocessor. This is because preprocessor generates a program 
that prints the final source code and for a bigger source code this program will be bigger -- a more complicated preprocessor (such as that in C) doesn't 
have to suffer from this, but is more complicated to make. Higher RAM usage isn't an issue on PCs or mainstream mobiles at all, but may play a role on 
very limited embedded devices. It however recommended and supposed that preprocessor won't be heavily used (like it is e.g. in C) and that only pretty 
complex programs will resort to it. Most things can be done without it (note that e.g. file includes are separate from preprocessor and don't trigger its 
use, i.e. you can happily include files without worrying about burdening your program too much). 

* Preprocessor is Turing complete -- while this may be also seen as a feature, it allows the preprocessor to e.g. get stuck in an infinite loop. 

* No block comments at the moment. So far there are only line comments (though they can be ended before end of line). This may be a small 
annoyance e.g. for debugging where you need to quickly disable big parts of code. This can now be achieved in other ways, e.g. with blind if statement, 
preprocessor, deleting the code or mass line-commenting the block with the help of your editor. But block comments would be nice, they'll be 
considered in the future. 

* Reverse Polish notation can be harder to read, firstly because we're not used to it and secondly because it lack some information and allows errors to 
sneak in, e.g. sometimes you can't tell how many arguments a function takes. But it's still OK and completely usable and very cheap to implement. I've 
also found this makes me better think about every expression I write so that in the end I write nicer code. 

* Separate type environments may sometimes be cache unfriendly. This is because they're typically far away from each other in RAM and if you e.g. 
make something like a struct with different data types in different type environments, this may kill CPU cache. However this only applies in specific 
cases, like the one mentioned, it can be prevented and could also be addressed by a different implementation (interleaved type environments?). It also 
probably won't ever be noticeable on "big" computers and small computers (embedded) many times don't even have any CPU cache so they don't care. 

"rights" 
NO RIGHTS RESERVED 


fuck copyright and capitalism 


|, Miloslav Ciz (aka drummyfish), have created everything in this repository (except for the text in the LICENSE file) myself (with occasional 
external PCS and feedback of other people) from scratch and my intent is to waive all my exclusive "intellectual property" rights so 
that my work can be used absolutely by anyone for any purpose without any conditions whatsoever. 


everyting in this repository is released under CCO 1.0 (public domain, https://creativecommons.org/publicdomain/zero/1,0/) + an extra waiver 
of all other IP rights (including patents and trademarks, just in case CCO isn't enough to ensure complete public domain). Some files in this 
repository have a waiver notice embedded in them (to better ensure they carry the information about their legal status even when taken out of 
this eo OT while some do not, however the waiver mentioned here applies to ALL files in this repository, no matter whether they bear the 
notice themselves or not. 


The additional waiver of all IP rights follows: 


The intent of this waiver is to ensure that this work will never be encumbered by any exclusive intellectual property rights and will always be in 
the public domain world-wide, i.e. not putting any restrictions on its use. 


Each contributor to this work agrees that they waive any exclusive ron. including but not limited to copyright, patents, trademark, trade 
dress, industrial design, plant varieties and trade secrets, to any and all ideas, concepts, procesors, discoveries, improvements and inventions 
conceived, discovered, made, designed, researched or developed by the contributor either solely or jointly with others, which relate to this 
work or result from this work. Should any waiver of such right be judged legally invalid or ineffective under applicable law, the contributor 
hereby danis to each affected person a royalty-free, non transferable, non sublicensable, non exclusive, irrevocable and unconditional license 
o this right. 


docs/specification.md 


Comun, The Programming Language Specification 
version 0.905, by Miloslav Ciz (drummyfish), 2023, released under CCO 1.0, public domain 
(https://creativecommons.org/publicdomain/zero/1.0/) 


This is a specification of the comun programming language. Currently it is rather informal, a more formal one may be made once the language 
matures. Many things are yet left unspecified so as to keep this short, simple and allow evolution -- for example error behavior and many 
commonly used terms are handled without precise definitions, common meanings are assumed. Where something is unspecified, suppose 
freedom of implementation, try to implement a simple and logical solution that respects the spirit of the language. 


Language naming and compliance: this is a recommendation for naming of implementations and modifications of the language. The 
language specified by this document is named comun; any implementation that calls itself a comun implementation should adhere to all 
mandatory requirements specified here. It is planned that future versions of this janguage will continue to be called comun, they will be 
distinguished just by the version number. A simplified version of comun that doesn't have to support reprocessing, file includes and user 
defined pointers and will typically only implement one type environment (environment 0) may be called minicomun. A name for versions 
further simplified to not even suppor user function definitions is microcomun -- such versions may still support calling of external functions. It 
is recommended different types of modifications choose yet a different name, which may or may not contain the word comunas its part. 


Version numbering of this document has the traditional MAJOR.MINOR format. The first two digits of MINOR number increase with changes 
in the specification that make the language different, its further digits increase with minor changes not affecting the language itself (such as 
typo corrections, formatting etc). MAJOR number is incremented and MINOR number is set to zero after many significant changes since the 
start of the current MAJOR version. Note that the specification version number and version number of its various implementations are of course 
generally not the same. 
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Basics 
The language is minimalist, statically typed, imperative, Turing complete, general purpose and low level, it mainly operates on stacks but also 
supports pointers for random memory access and implementing multiple stacks. It may be both interpreted and compiled. Postfix notation is 
used. English keywords are avoided; simple, short math-like symbols are preferred. The language aims for minimum of abstraction above and 
eneral similarity to traditional hardware architectures (i.e. easy mapping to assembly languages), it should enable good performance, being 
uture proof, universal and as much as possible free (i.e. public domain, not requiring complex hardware etc.). The following do NOT belong 
among the language goals: high abstraction (non-imperative paradigms, ...), handholding, rapid programming ("productivity"), parallelism, 
mainstream popularity, making profit or being beginner friendly. 


Character set: the language source code may only contain 7bit ASCII characters except for the character with value zero (this character is 
reserved for potentially terminating the source code string). Blank character is any character with ASCII value smaller or equal to that of 
space ( ); except for the first preprocessing stage, the characters [ and | are also considered blank (no matter where they appear). Platform 
specific newline sequences in the source code are to be considered a single newline character \n (ASCII value 10). 


Comments: during processing of source code if the hash character (#) is read and this character is not part of a string literal, the processing 
considers all characters read blank characters until the end of the next nearest hash character (#) or newline (\n). 


Tokens: source code of the language can be seen as a sequence of tokens. Token is a string appearing outside of comment, consisting of only 
non-blank characters, except for string literals which may contain blank characters but are considered a single token. 


Identifiers: identifier is a string composed of at least one character and each character of an identifier has to be either a letter (a - z, A- Z), 
decimal digit (0 - 9) or underscore (_), however the first character cannot be a decimal digit. 


Numeric literals: numeric literal may start with sign (+ or -). If sign is present, base specifier may follow. Then one to many digits of given 
base follow. Possible bases are: 


e decimal: Base specifier is d. This is the default base considered if no base specifier is present. Base digits are © to 9. Examples: 0, - 0, +d0123, 732. 
* hexadecimal: Has to start with a sign followed by base specifier x. Base digits are © to 9 and a to f. Examples: *x00f f, - x100. 


* binary: Has to start with a sign followed by base specifier b. Base digits are O and 1. Examples: +b0, -b1010110. 
ies a honenegative decimal literal without base specifiers and without any unnecessary leading zeros be called a plain decimal numeric 
iteral. 


String literals: a string literal is a string that starts and ends with the double quote character ("). Between these there is zero to many 
characters that are not double quote. There are no escape sequences for strings (values not representable in string literals can be pushed to 
stack as numeric literals). 


Data types: only atomic integer types that are implicitly considered unsigned exist in the language. A data type is defined only by its bit 
width N which is a non-negative integer. 0 is a special value used to signify the platform's native data type, the data type identified by 0 has 
bit width equivalent to the platform's native integer type if possible, but at least 16 bits. Data type with bit width N can hold exactly the values 
0 to 2^N - 1 (including both bounds). Some built-in operations may interpret memory values as signed; in that case two's complement 
representation is considered, i.e. results of operations are those that would be obtained in two's complement representation. For unsigned 
operations direct representation is considered. 


Each data type has its own separate type environment. A type environment is defined in the same way as data type: by its integer non- 
negative bit-width N. This also holds for the data type identified by O (the genome native data type). Note that type environment 0 is always 
separate, i.e. if for example given platform's native type has bit width 16, type environments 0 and 16 are still separate. Each type 
environment has its own pointer table and memory consisting of cells, each one holding a value of that environment's type. The cells have 
integer addresses, first one has address 0, the second one 1 and so on up until a limit imposed by the language processor. At any given point 
during source code processing exactly one type environment is active and the commands of the language operate on this environment's 
memory. l.e. the currently active type environment implies the currently set data type. The default type environment set at the start of 
language processing is the platform's native data type (0). 


The language doesn't have to support all possible type environments, only type environment 0 is required, however it is recommended to also 
implement at least type environments 8, 16 and 32. 


Program arguments: programs may receive external string arguments for example from the operating system. This passing of arguments 
can be seen just as if a string S was prepended to the source code where S is of form © Sn ... © S3 © S2 0 S1 N where SI ... Snare 
string literals of the arguments and N is the number of arguments (if no arguments are passed only a single zero value will be present on the 
stack at the start of the program). If no parameters are passed or if parameter passing is not supported, a single value 0 still has to be pushed 
on the stack before program execution starts. If preprocessing is implemented then argument passing to the preprocessor itself may be 
allowed in the same way. 


There must be at least 16 free (usable) cells in each supported type environment, starting from the initial main stack top address (however 
this should be much more if possible), before pushing program arguments. 


There is no standard library. 


Pointers 

A pointer is a name-value pair stored in a pointer table. The pointer name is an identifier (with an exception described below) unique within the 
pointer table of given type environment and its value is a non-negative integer address nd to a specific cell in the type environment 
whose pointer table the pointer resides in. As each type environment has a separate pointer table, there can exist pointers with the same 
name in different type environments. 


In each pe environment special pointers named 0, 1, ... 9 always exist by default (these pointer names are an exception to pointer names 
having to be identifiers). Pointers 1, ... 9 are readony and can NÒT be assigned addresses to directly with commands, their address is always 
derived from pointer ©. Pointer © always contains the current address at which commands operate, pointer 1 contains address stored in 
pointer © minus 1 etc. As most commands exhibit a stack behavior, we will also refer to the pointer © as the stack toppointer. The initial 
addresses stored in pointers, including the pointer 0, are decided by the language processor. 


Commands 
Here we describe the basic unstructured commands of the language, control structures are described in another section. 
Built-in operations of the language usually work on the stack of the currently set type environment (see pointers and stack top). 


Accessing (reading from or writing to) memory outside bounds (below 0 or above the maximum address) causes a run time error. Whether 
leaving memory bounds (without accessing it, e.g. merely moving stack top below address zero) causes an error is left to be decided by each 
implementation. 


Implementation of operations as described below must ensure they do NOT affect values above the final stack top address (because the 
programmer may have temporarily moved downwards the stack with the intention to return back up later). For example it might be tempting 
to implement the increment operation (++) as a shorthand for pushing the value one and invoking the add command (1 +), however this 
cannot be done for the above mentioned reason. 


A pop means decrementing stack top pointer. A pop itself mustn't modify any values in memory cells. A push of a value means incrementing 
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stack top pointer and then writing the value to the stack top memory cell. 


Type conversions: the result of an operation that's to be of data type of width N is the same as if first all the input operands of were 
converted to a binary number of infinite bit width (with sign extension if we are considering two's complement), then the operation was 
performed and lowest N bits of the result were taken. 


In the following description of commands let x, y and z be the value stored in the cell at the address of pointer 0, pointer 1 and pointer 2, 
respectively, before performing the command, interpreted as an unsigned integer in direct representation unless mentioned otherwise. 
Operations explicitly mentioned as signed interpret operands as signed integers in two's complement representation. 


Pointers and addresses: if a command works with an address of a pointer, the address just before invocation of the command is considered 
(this is significant e.g. with commands that modify stack top address and pop at the same time). If a command that cmd modifies a pointer 
SPERA applied to one of the special pointers 1, ... 9, nothing happens, as these pointers are considered just virtual read-only pointers 
relative to pointer 0. 


The language commands are 
* numeric literal: Pushes the value represented by the literal. 


* string literal: Pushes ASCII values cole sponding: to the characters in the string literal from back to front, minus the double quote 
characters. E.g. "abc" pushes 99, then 98, then 97. 


* identifier (function call): Pushes return address on call stack and jumps to executing the corresponding function. For details see the 
section on language structure. 


* + (addition): Pops 2 values, pushes the value y + x. 

* ++ (increment): Pops 1 value, pushes the value x + 1. 

* - (subtraction): Pops 2 values, pushes the value y - x. 

* -- (decrement): Pops 1 value, pushes the value x - 1. 

* * (multiplication): Pops 2 values, pushes the value y * x. 

e / (division): Pops 2 values, pushes the value y / x (integer division). If x is 0, error occurs. 


* // (signed division): Signed operation, pops 2 values, pushes the value y // x where // signifies signed integer division. If x is 0, error 
Occurs. 


* % (remainder): Pops 2 values, pushes the values y mod x (remainder after integer division). If x is 0, error occurs. 


* 906 (signed remainder): Signed operation, pops 2 values, pushes the value y - (y // X) * x where // is signed integer division. If x is 0, 
error occurs. 


* >< (swap): Pops 2 values, pushes the values x, then y. 
* ^(pop):Pops 1 value. 
* = (equality): Pops 2 values. If x is equal to y, pushes the value 1, otherwise pushes the value 0. 
* |= (inequality): Pops 2 values. If x is equal to y, pushes the value 0, otherwise pushes the value 1. 
* «(smaller inequality): Pops 2 values. If y « x, pushes the value 1, otherwise pushes the value 0. 
* «« (smaller signed inequality): Signed operation, pops 2 values. If y « x, pushes the value 1, otherwise pushes the value 0. 
* <= (smaller or same inequality): Same as smaller inequality, but the comparison performed is y <= x. 
* <<= (smaller or same signed inequality): Same as smaller signed inequality, but the comparison performed is y <= x. 
* »(greater inequality): Same as smaller inequality, but the comparison performed is y > x. 
* »» (greater signed inequality): Same as smaller signed inequality, but the comparison performed is y > x. 
* >= (greater or same inequality): Same as smaller inequality, but the comparison performed is y >= x. 
* >>= (greater or same signed inequality): Same as smaller signed inequality, but the comparison performed is y >= x. 
* || (logical or): Pops 2 values. If at least one of the values y and x is non-zero, pushed the value 1, otherwise pushes the value 0. 
* && (logical and): Pops 2 values. If both y and x are non-zero, pushes the value 1, otherwise pushes the value 0. 
! ! (logical not): Pops 1 value. If x is non-zero, pushed the value 0, otherwise pushes the value 1. 
e |!! (logical xor): Pops 2 values. If exactly one of the values y and x is non-zero, pushes the value 1, otherwise pushes the value 0. 
| (bitwise or): Pops 2 values, pushes the value y | x where | is a bitwise or operation. 
* &(bitwise and): Pops 2 values, pushes the value y & x where & is a bitwise and operation. 
! (bitwise not): Pops 1 value, pushes the value !x where ! is a bitwise negation operation. 
* |! (bitwise xor): Pops 2 values, pushes the value y |! x where |! is a bitwise xor operation. 
* |» (shift right): Pops 2 values, pushes the value y bit-shifted by x to the right (towards least significant bit). 
e |< (shift left): Same as shift right but the shift performed is to the left. 


e <- (input): Reads a single value from the input and pushes it. Typically this can mean reading a single text character from input and 
pushing its ASCII value, but this interpretation is not required. The operation is blocking and doesn't check for end of input. If end of 
input has been reached and this command is performed, 0 is pushed. 


e -> p Pops 1 value and outputs it. Typically this can mean printing out a character with ASCII value x, but this interpretation is 
not required. 


*  --»(string output): Equivalent to the sequence of commands Q' -> . ^. 
e <? (input unfinished): Pushes 0 if the previous <- command attempted to read from a finished input stream, otherwise 1. 
* ?? (conditional): Pops 3 values. If z is not zero, pushes y, otherwise pushes x. 


e >N where N is a plain decimal numeric literal (type environment transfer): Pops 1 value, then writes this value to the stack top in 
type environment N (without shifting the stack top pointer in environment N). Currently set data type isn't changed by this command. 


* pointer commande: Let N and M be pointer names already declared before the command. Then the following are possible pointer 
commands: 


* $N (pointer dereference): Pushes the value stored at the address pointed to by pointer named N. 
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e $:N (pointer assignment): Pops 1 value and stores it to the address pointed to by pointer named N. 
e $N»M (pointer copy): Copies the address stored in pointer named N to pointer named M. 


e $N-M (pointer comparison): Pushes value 0 if addresses in pointer N and M are the same, otherwise pushes 1 if address in 
pointer N is greater than address in pointer M, otherwise pushes 2. 


* $»N (pointer increment): Increments the address stored in pointer named N by 1. 
*  $«N (pointer decrement): Decrements the address stored in pointer named N by 1. 


e $+N (pointer add): Pops 1 value, interprets it as a signed value and adds it to the address stored in pointer named N. If N is 
0, mn a Sra address in pointer © will be that which there was just before invoking this command plus N (i.e. pop is 
ignored here). 


* $ (push): Pops 1 value, pushes the value x places below stack top. 
* $$ (address): Pushes the address stored in pointer 0 (stack top). 


* directives: Directives are compile-time commands that modify the language processor's state or behavior when it is analyzing the 
code, they don't represent a run time action (for example it is NOT possible to dynamically allocate a pointer with the pointer 
definition directive). Possible directives are: 


* -Nwhere N is a plain decimal numeric literal corresponding to one of the supported type environments (type environment 
switch): Makes the language processor immediately change its current type environment to type N. 


e -Ior-I:Nwhere/is identifier and N is a plain decimal numeric literal (pointer definition): Creates a new pointer within 
the current type environment with the name / and size equal to the number represented by N. Pointer name must be unique 
among all pointer names within given type environment. The first variant of the command (without explicitly specified N) 
supposes N equal to 1. Size N here means seing the pointer value so that it points to an address which is followed by at 
least N cells of which none is pointed to by any other pointer. Note that N = 0 is a valid value. 


e ~:I where / is identifier (label): Creates a new label with the name /. The label name must be unice among all label names 
in the source code. If the goto command isn't supported, this directive doesn't have to be supported. 


* -SwhereSis string literal (file include): Allows inclusion of source code from another file F identified by the string 
literal S which is a file name in given platform's format. If this command is encountered during compilation, it is replaced by 
the content of file F. Inclusion of a file that has already been opened is to be ignored (while issuing possible warning), i.e. any 
source code file can be processed at most once. 


Any above mentioned command that performs at least one pop, except for the - -> command (whose number of pops may be unknown at 
compile time), has also anon-popping variant whose name is formed by appending ' to the name of the command. E.g. the 
command +' performs the same operation as command + but doesn't perform any pops. 


Structure 

Simple branch is of the following form 

? COMMANDS . : 

Optionally there can also be an else branch, i.e. 

? COMMANDS ; COMMANDS2 . : . , . 2c : 

When at run time branch is encountered, a value is popped in the current type environment and it is checked whether this value was non-zero 
-- if so, COMMANDS are performed; if not and if an else branch is present, COMMANDS2 are performed. 


?' can be used instead of ? in which case no pop is performed by the branch condition check. 


Loop is of form 

@ COMMANDS . . g . / . M 

When at run time loop is encountered, a value is popped in the current type environment and it is checked whether the popped value was non- 
zero -- if so, COMMANDS are processed and the control jumps right before the loop start. 


19 is the loop break command. When this command is encountered at run time, program control Jumps right after the end of the current 
innermost loop. If this command is encountered outside any loop, an error occurs (it is recommended to be a compile time error but 
interpreters may also resort to a run time error only upon attempted execution of this command). 


@' can be used instead of @ in which case stack top is not popped when checking the loop condition. @@ can be used instead of @ to create an 
infinite loop, i.e. a loop that doesn't perform any condition checks (and no pops) and repeats until exited with the break command. 


Function definition has the following format 

functionName: COMMANDS . . : ! = : : : : i 1 

Here functionName is the function name, an identifier unique among all other defined functions, and COMMANDS is the function body that is 
performed when the function is called. Function definition must appear on the outermost level of global scope, i.e. it cannot appear inside 
another function definition, inside a branch, inside a loop etc. 


Function call is performed simply with a command equating the function name (argument passing and return values have to be performed 
via memory cells). Function calls work with a separate return address stack (different from the general stacks of data type environments), i.e. 
recursion is possible. It is possible to call a function that will be defined after the function call appears (forward declarations aren't needed). 


|. is the exit command. If this command is encountered inside a function, the function is immediately left (just as if its end was reached). If 
this command is encountered outside a function, it immediately halts the program. 


External functions can be called; once processing of source code is finished, any call to a function not defined in the source code is 
considered a call of an external function. Exposing functions from the language is also possible; the language processor can make all 
defined functions callable from external environments. In both cases the conventions for parameter passing and returning values are left to be 
decided by every implementation. Calling external functions and exposing functions is to serve the compatibility with other languages and 
computing environments, libraries made within the language itself are to simply use the file include command. 


>S where S is identifier is the goto command. Support of this command is optional. When this command is encountered at run time, the 
program control jumps to the location of label with name S. Jumping to a label which will be defined after the goto command is possible. 
Jumping into functions from outside is possible with behavior matching that of the traditional call stack implementation of function calls; when 
end of a function that's been jumped into is reached, control jumps to the address on top of call stack (and call stack is popped), unless call 
stack is empty in which case a run time error occurs. 


Preprocessor 

The language may opa t include a preprocessor that allows for automatically modifying the NERA source code before compilation. l.e. 
with preprocessor activated the source code is first preprocessed to form a new source code which is then compiled. Preprocessor uses the 
same language as has been defined so far. 


Blocks of preprocessing code start with the [ character and end with the ] character. Note that these characters are considered preprocessing 
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delimiters everywhere, i.e. even if they appear inside a comment or string literal etc. These characters don't have to be separated by blank 
characters as language tokens do. Preprocessing blocks cannot be nested. 


If preprocessing is active, any source code file's content is to be prepended with the ] character and appended with the [ character (this is 
important for correct behavior during file includes). 


Suppose we have source code S (with ] and [ already prepended/appended and with all include commands already replaced with the 
corresponding file contents which have also been prepended/appended with the same characters) which is to be preprocessed to form the final 
preprocessed source code S2. S2 can be seen as obtained from S like this: 


1. Replace all strings that start with ] and end with next nearest [ with language code that prints the string minus the bounding ] and [ characters. This 
code may only modify memory cells above the current stack top in each type environment and after execution has to leave addresses in all pointers 
unchanged. Let the code at this stage be called S1. S1 is the results of the first preprocessing stage. 

Execute S1; the output it gives is S2. S2 is the result of the second preprocessing stage. This is the final preprocessed code. 


2. 
Note that this is only a description of semantics, the language preprocessor doesn't actually have to create the intermediate code S1 if it can 
generate 52 in another way. 
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Comun Bytecode 

This is a description of implementation specific comun bytecode, which from now on we will just call comun bytecode. Note that this bytecode 
is NOT part of comun specification, it is a specific invention of this particular implementation -- other implementations may use this bytecode 
or a different bytecode or even no bytecode at all. 


Basics 

Fixed-size 2 byte (16 bits) instructions are used. The bytecode PB type environments 0, 8, 16 and 32 (this can't easily be extended, for a 
support of more type environments a different bytecode would have to be designed). Except for header everything (even data in code and 
metadata information) is encoded as a type of instruction, i.e. in the bytecode section each aligned 2 byte sequence can be read and 
interpreted as an instruction, without knowing the context. Not all instructions represent a direct action, e.g. instructions recording 
continuation of immediate constant or meta information. 


All memory cells and pointer addresses are implicitly considered to be zeros, so it is e.g. not necessary to explicitly initialize a specific pointer 
to zero. 


Jump address is address of an instruction that will be executed in the next cycle. 
It is recommended for files containing binary form of this bytecode to have the extension .cmb. 


Overall Structure 

The bytecode starts with a header of length 8 bytes whose meaning and possible values are following: 
0. 67('C) 

66 ('B) 

reserved 

reserved 

checksum: Sum of all bytes in the instruction section modulo 256. 

payload: This can be used to store any information by the compiler (e.g. its signature etc.). 

reserved 

. reserved 

After the header instruction section follows. It consists of a sequence of instructions which end with the END instruction. 


After the instruction section any data may follow which have no meaning from the bytecode point of view but may be used to store extra 
information, e.g. debug symbols etc. 


Well Formed Bytecode 
Well formed bytecode should follow these rules: 


SS: GS GOLA 


* There are no instructions in the bytecode that aren't defined in this document. 

* Bits in instruction codes that have no meaning are set to 0. 

* DES instructions are used to mark higher level constructs (e.g. mark that a jump is start of an if statement) and other meta information to allow easy 
transpiling. 

* There is exactly one END instruction, at the end of bytecode (to halt program early use jump instruction to skip to the ENDinstruction.) 

* Function code is preceded with jump instruction that skips it. There must be exactly one RET instruction in the function, at its end (to return early use 
jump instruction to skip to the RET instruction). 

* The bytecode is made so that before the first translated command of the source code is executed initial pointer addresses will be set and INI instruction 
is executed. This can happen e.g. at the very beginning of the bytecode or inside a special initialization function that's called at the beginning of the 
bytecode. 

Instruction Format 
Each instruction is of the following format: 
TTTTUUMM EEPFNNNN 


msb lsb msb lsb 
1st byte 2nd byte 


e TTTTUUMM: opcode, identifies instruction, is of format: 
* [f TTTT « 2 the instruction is special and UUMM has no special meaning. 
* Else (if TTTT >= 2) the opcode represents a typical stack operation and the following holds: 
e TTTTUU: Identifies instruction type. 
e MM: Identifies instruction mode, possible values are: 
* 00: pop 2, push 1 
e 01: pop 1, use immediate constant C, push 1 
e 10: pop 1, push 1 
e 11: push 1 
* EE: Type environment, possible values are: 
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* 00: environment 0 
* 01: environment 8 
* 10: environment 16 
* 11: environment 32 
* P: If 1, the instruction is non-popping, otherwise it potetnially pops. 
* F: If 1, immediate constant (C) continues in the next word (which has to be COC), otherwise not. 
* NNNN: Immediate constant (C) bits, with rightmost bit being least significant. 
Immediate constants: some instructions make use of immediate constants embedded in the instruction code. If an instruction uses 
immediate constant C, its bits are held in the NNNN part of the instruction; if these bits don't suffice for the constant, further higher bits will 
follow in immediately following COC instructions. Some instructions use two immediate constants C1 and C2 -- in this case these are encoded 
the same way: lower half of what would normally be C represents C1, the upper half C2. 


Sign interpretation of constants: if an instruction is to interpret immediate constant as signed, it will do so in the following way -- the 
signed value is the value of the constant in B bit two's complement encoding where B is 4 for if the instruction is PAC, otherwise 32 if the 
instruction's type environment is 0, otherwise it is equal to the number of bits of the type environment. 


Pointer indexing: pointer indices N — 0 to 15, including both bounds, mean the special values stack top minus N. Pointer with index 16 
stands for the first user pointer, 17 for second user pointer etc. 


Instruction List 

Let x, y and z be the values at top, top - 1 and top - 2 addresses before the operation is performed, respectively. C, C1 and C2 represent 
immediate constants. sig() signifies interpretation of value as signed, ptrs is the pointer table in given type environment, mem is the 
memory of given type environment. 


opcode mnemonic group description 
00000000 END end, end of bytecode 
00000001 NOP no operation, do nothing 
00000010 DES description, holds meta information 
00000011  COC constant continuation, extra bits for C 
00000100 ERR error, raise error specified by C 
00000111 CAL call, call function at address C 
00001000 CAE call external, call external function C 
00001001 RET return, return from function 
00001010  JIA jump if address, pop, if x then jump to addr. C 
00001011 JNA jump if not address, pop, if not x, jump to addr. C 
00001100 JMA jump address, jump to addr. C 
00001111 INI initialize, do initialization (push args etc.) 
00010000 PSC pointer set constant, ptrs[C1] = C2 
00010001 PAC pointer add constant, ptrs[C1] *- sig(C2) 
00010010 PAX pointer add, pop, ptrs[C] += sig(x) 
00010011 PCO pointer copy, ptrs[C1] - ptrs[C2] 
00010100 MEX memory set, pop, mem[ptrs[C]] = x 
00010101 MGE memory get, push mem[ptrs[C] ] 
00010110  PUX push xth, push xth value below stack top 
00010111 PCM pointer compare, push 0/1/2 if ptrs[C2] =/>/< ptrs[C1] 
00011010 CON constant, push C, pop; NOTE: pop is needed for optims. 
00011011 CND conditional, pop 3, pushz ? y : xX 
00011100 SWP swap, pop 2, push x then y 
00011101 TRA transfer, pop, mem[C][$] = x 
00011110 POP pop, pop C + 1 values 
00011111 OUT output, pop and output 
00100000 ADX AD add, pop 2, pushy + x 
00100001 ADC AD add constant, pop 1, push x + C 
00100100 SUX SU subtract, pop 2, pushy - x 
00100101 SUC SU subtract constant, pop 1, push xX - C 
00101000 MUX MU multiply, pop 2, pushy * x 
00101001 MUC MU multiply constant, pop 1, push x * C 
00101100 DIX DI divide, pop 2, push y / x 
00101101 DIC DI divide constant, pop 1, push x / C 
00110000 DSX DS divide signed, pop 2, push Sig(y) / sig(x) 
00110001 DSC DS divide signed constant, pop 1, push sig(x) / sig(C) 
00110100 MOX MO modulo, pop 2, push y % x 
00110101  MOC MO modulo constant, pop 1, push x % C 
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opcode mnemonic group description 


00111000 MSX MS modulo signed, pop 2, push sig(y) % sig(x) 
00111001 MSC MS modulo signed constant, pop 1, push sig(x) % sig(C) 
01000000 GRX GR greater, pop 2, push y > x 

01000001  GRC GR greater constant, pop 1, push x > C 

01000100  GEX GE greater or equal, pop 2, push y >= X 

01000101  GEC GE greater or equal constant, pop 1, push x >= C 
01001000 SMX SM smaller, pop 2, pushy < x 

01001001  SMC SM smaller constant, pop 1, push x « C 

01001100 SEX SE smaller or equal, pop 2, push y «- x 

01001101 SEC SE smaller or equal constant, pop 1, push x <= C 
01010000  GSX GS greater signed, pop 2, push sig(y) > sig(x) 
01010001 GSC GS greater signed constant, pop 1, push sig(x) > sig(C) 
01010100  BSX BS greater or equal signed, pop 2, push sig(y) >= sig(x) 
01010101  BSC BS Huc equal signed constant, pop 1, push sig(x) >= 
01011000  SSX SS smaller signed, pop 2, push Sig(y) < sig(x) 
01011001 SSC SS smaller signed constant, pop 1, push sig(x) < sig(C) 
01011100  LSX LS smaller or equal signed, pop 2, push Sig(y) <= sig(x) 
01011104 LSC LS ae equal signed constant, pop 1, push Sig(x) <= 
01100000  EQX EQ equals, pop 2, push y == x 

01100001  EQC EQ equals constant, pop 1, push x == C 

01100100 NEX NE not equals, pop 2, pushy !- x 

01100101 NEC NE not equals constant, pop 1, push x !- C 

01101000 BAX BA binary and, pop 2, pushy & X 

01101001 BAC BA binary and constant, pop 1, push x & C 

01101100 BOX BO binary or, pop 2, push `y 

01101101 BOC BO binary or constant, pop 1, push "x 

01110000  BXX BX binary xor, pop 2, push y ^ x 

01110001  BXC BX binary xor constant, pop 1, push x ^ C 

01110100 LAX LA logical and, pop 2, push y && x 

01110101 LAC LA logical and constant, pop 1, push x && C 

01111000 LOX LO logical or, pop 2, push "y 

01111001 LOC LO logical or constant, pop 1, push "x 

01111100 LXX LX logical xor, pop 2, push y ^^ x 

01111101 LXC LX logical xor constant, pop 1, push x ^^ C 

10000010  BNO BN binary not, pop 1, push ~x 

11110011 ADR address, push address of stack top 

11111011 INU input unfinished, push 0 if input has finished, else 1 
11111111 INP input, read and push value 


Possible C values for the DES instruction are: 


Next instruction is an if branch. 
Next instruction is else label. 

This is end of an if branch. 

Next instruction is loop start. 

Next instruction is loop break. 

Next instruction is loop end. 

Next instruction is start of a fun def. 
Next instruction is exit command. 
Next instruction is goto command. 

* 10: Marks location of a label. 

e 12 and above: Can be used by compiler to embed any information. 
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Comun Tutorial 
by drummyfish, released under CCO 1.0, public domain 


This is a tutorial that teaches programming in the comun language. This only teaches the pure language, not e.g. the details of the 
implementation specific bytecode or how to integrating comun to your programs -- such information will be provided elsewhere. 


. 
QUO DO Side co mu 
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Who is this for? To complete programming newcomers this tutorial may be too difficult to digest; we rely on some basics programming 
knowledge here and the language itself is low level and therefore not so easy to handle by beginners. To read this tutorial you should at least 
already be able to write very basic programs in an easy language such as Python and know basic terms such as algorithm, interpreter, data 
type, stack, function, array etc. If you already know about advanced topics such as pointers and can program in low level languages such as C, 
this tutorial should pose no difficulties. 


Besides this tutorial also consider reading the specification (which is very short, to an experienced programmer it can serve as a condensed 
tutorial and a cheatsheet), provided example programs and other documents in the documentation directory of this repository. 


What is comun and what is it good for? Comun is a programming language focused on simplicity and freedom, it is trying to take a 
different path than the mainstream languages such as Python or JavaScript. It's been wholly developed by a single guy with the goal of 
creating a basic language for an alternative, simpler cone technology than that which is currently plaguing the world. You can use comun 
in many ways, even if you don't share the worldview it is based on, for example you may utilize it as a simple scripting language in your game 
-- it's much simpler to incorporate into a program than for example Lua, a language that's itself considered very simple and easy to integrate. 
Comun will run even on extremely weak computers (we might even say calculators) with just kilobytes of RAM, it can be ported almost 
anywhere (this means NOT just comun programs, but the comun compiler itself). You may also use comun to write regular programs, the 
advantage you'll gain is freedom; you free yourself from the highly corrupted, bloated, proprietary and overcomplicated world of mainstream 
technology that's "protected" by copyrights and trademarks, that's ever changing, breaking, dropping compatibility and fueling consumerism. 
Programs written in comun are meant to last and hopefully be run along with other freedom-focused technology such as small embedded 
perona computers without operating systems. If you write your program in comun, it's very likely to survive far into the future and run on 
asically anything we might call a computer, simply because it's pretty easy to create comun compiler/interpreter. But beware, if you're 
looking for features of a "mainstream" language, such as great safety, huge standard library or rapid development, comun is not for you. 


A quick word about comun in case you know a bit about programming already: comun is very low level and similar to FORTH, it is 
imperative, stack-based and uses postfix notation. It can be both compiled and interpreted (current implementation even has its own simple 
bytecode). It offers the option to use different width integer types, pointers and even has an optional preprocessor. But all in all it tries to keep 
it simple and avoid what we call "bloat", so it doesn't sport advanced features such as floating point or user defined data types. 


Setting It Up, First Program 
We suppose you are using a Unix-like system (e.g. GNU/Linux) and know the basic of working with its command line. Other systems 
support the language as well, but you may have to make an extra effort to mimic the commands. 


Firstly download the whole repository with the language, e.g.: 
git clone https://codeberg.org/drummyfish/comun.git : i , X 
Now compile the C implementation of comun compiler with your favorite C compiler (here we use gcc, but you also may use clang, tccetc.): 


cd comun 
gcc -03 -o comun src c/comun.c 


‘To test whether everything is working, try to interpret some of the provided example programs, e.g.: 


./comun Malden nicte OF 


You should see a picture of the Mandelbrot set drawn in terminal. 


NOTE: If you are more experienced, you may check out various options of the compiler with ./comun -h -- for example you may compile 
comun programs to C as ./comun -C program.cmn. 


Now let's try to write a first "hello" program. Open a plain text editor, create a file named first.cmn in the directory we're currently in and 
write the following in the file: 


# our first program! 


© "hello :)" --» 

Now you should be able to run the program as: 

./comun first.cmn 

And see: 

hello :) : . " veu . ; 
What the source code actually means will be explained later. For the more experienced this is a summary: # our first program! is a 
comment, 0 pushes the value 0 on stack (which will serve as a string terminator), "hello :)" pushes the ASCII values of the string in reverse 
order on the stack and - -» is a built-in command that outputs a zero-terminated string from the stack. 


Basics (Stack, Operators, Commands, Postfix Notation, ...) 

The basic concept in comun is that of a stack. You should be familiar with the term, but a quick summary is this: stack is an abstract data type 
which we can imagine for example as a gun magazine, except that instead of bullets we have numbers. We may perform two main operations 
with the stack: push (insert a number) and pop (take one number from the top of the stack). l.e. stack behaves as so called LIFO (last in, first 
out). Stack top refers to the value that's been pushed last and is therefore at the very top of the stack. 


Comun internally sees computer memory as a stack. At the beginning there is nothing on the stack, we may visualize this as follows: 
memory: 9 0000000000000 
stack top . i 
Now in a comun program whenever we write a "number", we are telling the program to push that number to the stack. Consider e.g. the 
following comun program: 
1234 
This is a series of commands that say: push 0, push 1, push 2, push 3. If you run the program, comun executes the commands and its internal 
stack will look like this: 
memory: 0123 a 0000000090 
stack top , 
The beauty of stack is in that it can be used to make common computations very simply and elegantly. For example to add two numbers we 
can simply use the + operator which says "pop 2 numbers and push their sum". Let's try to add this operator to our comun program: 
1234+ 
If we run this, when comun encounters the + operator, it pops two top-most values (here 4 and 3), adds them (to get 4 + 3 = 7) and then 
pushes this sum on the stack. So at the end the stack will look like this: 
memory: 012 1 4000000000 
stack top TM - . $ 
Now notice one thing that may seem confusing: the value 4 stays in the memory after the value 7 -- this is a behavior that will be important 
for advanced manipulation of memory later. For now just notice it is so and ignore it -- for our purposes we may simply imagine that the values 
above stack top simply don't exist. 


Let's try to perform more operations now: 

1234+*+5/ 

The * operator will again make comun pop two values (7 and 2), multiply them (7 * 2 = 14) and push the product. Then there is another 
addition, then we push value 5 and perform division. Let's see the execution of the whole program step-by-step: 


step © memory: 00000000000000 
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step 1 memory: 9 1 0000000000000 
step 2 memory: 0 1 2 000000000090 
step 3 memory: 012 3 000000000900 
step 4 memory: 0123 4 0000000090 
step 5 memory: 012 K 4000000000 
step 6 memory: 0 1 1 74000000000 
step 7 memory: O 15 1474000000000 
step 8 memory: 0 15 5 74000000000 
step 9 


memory: 0 3 574000000000 


We can see the final value we have on stack top now: 3. Now notice that what we've written as our comun program could be traditionally 
written as a mathematical expression with the use of brackets: 


comun: 1234+%*+5/ 
normal arithmetic: 1+ * (3 + 4)))/75 


(2 
Here "normal arithmetic" means the common notation we are used to use in everyday life -- it is called an infix notation because we put 
operators (such as + and /) between the operands (numbers) -- here we sometimes need to use brackets to make it clear which operations to 
perform first. In comun we rather use so called postfix notation (or reverse Polish notation) which puts the operator after the operands -- this 
Is more convenient as it correspond: ORAY to how we perform operations on the stack (the operands and operators are written in the exact 
order in which they're executed) and it also turns out this notation doesn't need any brackets! 


Now let's make our program write out the final computed value so that you can experiment with these simple calculations. We will Spend a 
code that computes the quotient and remainder of the final value when divided by 10, then converts them to ASCII characters (add them to 
the ASCII value of character "9") and prints these characters with the -> command. Note that at this point you don't have to fully understand 
this code, just append it and let it work, the details will be explained later. Also note that this will correctly only write results that are lower 
than 100. With that said, try to run the following program: 


1234+%*+5/ 
$0 10 / "O" + -> 10 96 "O" + -> # this prints the final value 
You should see: 


Of course comun has more operators and operations you can use, here are just some of them (for a complete list see the language 
specification): 
e *,-, * (multiplication), / (integer division), % (remainder after integer division) 
e ++ (increment, i.e. add 1), - - (decrement) 
e <, >, <=, >=, =, |=: comparisons, two values are popped and either 1 or 0 is pushed based on the result of the comparison (e.g. 1 2 < pushes 1 
because 1 is smaller than 2) 
e ><: swaps two values at the stack top 
e ^: pop, performs a single pop of a value 
*  && (logical AND), | | (logical OR), & (bitwise AND), | (bitwise OR), ! (bitwise NOT) 
e ??: conditional (ternary operator), pops 3 values, pushes second popped value if third popped value is non-zero, otherwise pushes the first popped 
value 
* $0, $1, $2, $3, ... $9: pushes Nth value below stack top, i.e. for example $0 * squares the value at the stack top (it is duplicated and them multiplied 
with itself) 
e ->: pops 1 value and outputs (prints) it as ASCII character 
e <-: reads 1 value from the input (user) and pushes its ASCII value on the stack 
e -->:; string output, keeps popping values and printing them to output until it reaches the value 0 (if this value is not found, your program may crash!) 
Appending ' to a command makes it non popping: so for example +' pushes a sum of the two top-most values on the stack, without popping 
those two values. This is useful sometimes, but it doesn't work with some special commands (e.g. - -> or user functions). 


Furthermore for convenience we may specify numbers (numeric literals) in other bases, e.g. instead of 44 we may write the value as 
hexadeciaml +x2c or binary +b101100. 


There are also string literals which are a convenient feature for pushing ASCII values of text characters in reverse order, as this is a common 
operation when we want to work with text. For example the following program: 
"hi all" 
does exactly the same thing as a program: 
108 108 97 32 105 104 : . ; : . : . 
NOTE: There exist no escape sequences for special characters in strings; if you need such a value in your string, you have to push it manually 
as a numeric literal. 
Now recall the first program we've seen: 
# our first program! 
© "hello :)" --> : 
Now we may understand it better: 
* # our first program! is a comment for humans and has no meaning in the program, anything that starts with # is ignored by comun until the 
end of line or another £ character. 
* © pushes the value 0, this will serve as a stopper for the operation that will print our text string. 
* "hello :)" just pushes the individual ASCII values of the characters in this string, which will be here for the command that prints strings to the 
output. 
e --> is the built-in string output command that will print the zero-terminated string we've just pushed. 
Finally here are a few exercises: 
1. Modify the program we used to show expressions and operators to evaluate an expression we'd normally write as (8 + 6) / (2 * (4 - 3)). Hint: the result 
is 7. 
2. Write a program that reads two ASCII characters from the input (with the <- command) and then writes out a character that lies in the middle between 
them (e.g. given input AE the output will be C). Hint: the middle character is the average of the input characters. 
And here are the solutions: 


1. Change the comun expressionto8 6 + 2 4 3 - * /. 
2. <- <- +2 / -> 
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Control Structures (Branches, Loops) 
In any non-trivial program you will need to use branches ("ifs") and loops ("for", "while", ...). 
A branch in comun starts with ? and ends with . and can have an optional else branch (separated by ;), like this: 


? 
# commands 


í # if-commands 

' # else-commands 

It works very similarly to traditional languages: when comun encounters the branch, it pops one value and if it is non-zero (i.e. true), the 
commands inside the branch are executed, otherwise they're skipped (if there is an else-branch, then that is executed). 

For loops, there are basically just two types: a while loop, starting with Q, and an infinite loop, starting with @@. Loop again ends with 
the . character, i.e.: 

Q # while loo 


# commands to repeat 


QQ # infinite loop 
# commands to repeat 


Any loop can be exited immediately with the break command !Q. 


The infinite loop, unsurprisingly, just keeps repeating its commands forever (usually it is manually exited with the break command). The while 
loop behaves similarly to a branch; when encountered, one value is popped and if it's non-zero, the loop is entered; at the end of such loop the 
program jumps to just before the loop to perform the same pop and check again. 


Furthermore control structures can again be made non-popping, just as commands -- i.e. a branch/loop starting with ?'/@' performs its 
check without popping the stack value. 


Here is a simple example showing the use of a branch (NOTE: equality comparison in comun is just =, NOT == as in some other languages): 
© "Hello, did you have a good day? (y/n) " --> 


<- # read the answer 


"y" =? # is the answer equal to "y"? 
© 10 "That's great!" --> 
' 9 10 "Sorry to hear that." --> 


Now Let's see another example, this time combining both branching and a loop: 
10 


Q' 
$0 2 96 


iteration counter, perform 10 iterations 


while loop counter is non-zero. Abas 
duplicate stack top, take remainder after division by 2 


if this remainder is non-zero (i.e. 1) 
NOTE: 10 here is ASCII value of a newline 
otherwise the number is even 


HHH FH — db 


? 
0 10 "odd" --> 


' 9 10 "even" --> 


# decrement loop counter 
^ # pop the loop counter (no longer needed) 
When run, you should see: 
even 
odd 
even 
odd 
even 
odd 
even 
odd 
even 

d 


odd 

Notice how Q' has ' appended so that the loop doesn't pop the iteration counter as we'll need the loop counter in Vedere (we will 
only manually pop it with ^ after the loop ends). On the other hand the branch ? is popping because it checks a value which we won't need 
anymore. 


Functions 

Functions in comun are very similar to functions (also procedures or subroutines) in other languages. A function is basically a subprogramor a 
user-defined command, a named set of commands that can be invoked as a whole from different places in the code. The invocation of a 
function is called a function call. Functions are eene so that we can divide a big program into smaller parts and also so that we don't have 
to repeatedly write the same code in multiple places; suppose we e.g. need to solve a quadratic equation in many places throughout our 
program -- it would be very wrong to keep writing the same code for solving a quadratic equation in each such place; a function allows us to 
write such code only once and then refer to it from multiple places. 


A function is defined ("created") by writing its name (which may only consist of alphanumeric characters or the _ character, but mustn't start 
with a digit) with : at the end, then the function's commands follow and the . character terminates the function definition. A function call 
(invocation) is performed simply by writing its name (without the : at the end) anywhere a normal command could be used. 


Functions can be defined anywhere but not inside another function. However a function can call itself, i.e. recursion is possible. Function can 
also call functions that will be defined later in the source code (i.e. for C programmers: forward declarations aren't needed). 


Here is a simple example that defines a function named square which computes the square of a number (i.e. x * x), then calls the function 
with an input number 3 and prints the result (9): 


square: # function, pops 1 value, pushes its square 
$0 # duplicate Stack top 
* # multiply it with itself 


3 square 
Tony -5 


We see that unlike in traditional languages there are no parameters or return values indicated in the definition of the function -- in comun 
parameters and return values are passed to and from functions manually using stack. A function is simply a named piece of code. Ser 
when we call the function we don't pass arguments to it in a special way like in other languages (where such a function call might e.g. loo 

like square(3)) -- again, we pass the arguments by pushing then on the stack. 


You should also know there exists a "return" command, ! ., which we can use to immediately exit the function we're currently in -- it's pretty 
convenient many times. 


Functions can also be used to implement constants -- those coming from the C language may be used to define constants with preprocessor, 
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for example as #define PI 3.1415. Though in comun preprocessor can be used in the same way, it's usually easier to just do it with a 
function (for those fearing about performance: compiler will likely optimize this so there will be no penalty). Here is a simple example showing 
how we define a constant SQUARE. SIDE LEN that's later used in multiple places in the code: 


SQUARE SIDE LEN: 10 . # function used as a constant 


# draw a square with ASCII characters: 
SQUARE SIDE LEN @' 
SQUARE SIDE LEN @' 
"Haut -> -> 


^ 


10 -> 


A 
A very useful function is one for printing out numbers. The following is a primitive version of such function that works for numbers up to 999 by 
simply printing the number of hundreds, tens and units in the number: 
printHumo99: ea i Value (< 1000) and prints it 
$0 10 / 10 % "0" + -> 
$0 10 % "OQ" + -> 


As an exercise try to use a loop to write a function which works for number of any magnitude and which doesn't print any unnecessary 
leading zeros. This function will appear later in this tutorial so that you can check how it compares to your version :) 


Pointers 

Pointers in comun allow us to store and jump between memory addresses which can make many things easier and also allows to do a bit more 

aes ee If the advanced pointer stuff in this section seems too complicated for you, you can skip it for now, but remember to get 
ack later : 


We can use pointers e.g. in a way in which we use global variables in other languages -- this saves us many headaches in complex situations 
when we'd otherwise have to juggle many variables on the stack. 


Pointers also allow us to create multiple stacks. So far we've only operated only with one stack, but it may sometimes be much easier to e.g. 
have one "main" stack and then a number of different stacks, e.g. for functions, so that whenever we call a function we know that it won't 
mess up with our main stack. We may also use such separate stack as an array in which we want to store some larger data so that they don't 
stand in our way when we are performing computation on the main stack. 


What is a pointer anyway? Basically it's something that has a name and stores a memory address. In fact we've already seen one pointer; 
it's the special stack top pointer whose name is simply 0 (zero) -- the command $0 which we've known as "duplicate stack top" is actually a 
pointer command (which start with $) which pushes a value at address where given pointer (in this case 0) points. l.e. the pointer Oalways 
points to the stack top of the main stack, and $0 says "take the value from memory where pointer 0 points and push it". Besides the special 
pointer 0 there are also special pointers 1, 2, ... 9 which point that many places below stack top, so e.g. $2 pushes the value stored two 
addresses below the stack top address. 


Pointers are stored in a memory separate from the memory in which we make our computations, so called pointer table. This is for several 
reasons, some of which dad red (we can't just accidentally overwrite addresses in our pointers) and the possibility that addresses stored 
in pointers may in theory be higher than what would fit into one memory cell in the "main" memory. 


However now we need to talk about the main thing -- creating our own so called user defined pointers, or pointers to which we can give our 
own names and with which we can manipulate. We can create our own pointer by writing ~ and then its name (for user pointer names the 
rules are the same as rules for function names), so e.g. -ourPointer creates a pointer named ourPointer which will by default point to 1 
free memory cell that's reserved just for this one pointer (unless we specifically do something nasty, we don't have to be afraid that the value 
at this address will be overwritten by someone else). 


NOTE: the declaration of a pointer starts with — (and not $) because it is not really a run time command but rather a compile time directive. 
Also keep in mind that pointer definition is always global, there is no sense of a local scope as it might be in other languages, so it may be best 
to just declare all your pointers at the top of your program source code. 


If we want to write some value to the memory cell which ourPointer points to, we can simply do it as $: ourPointer - this will pop one 
value from the main stack and write that value to the memory where ourPointer points to. To get a value back from a memory cell 
where ourPointer points to, we simply do it as $ourPointer (notice the syntax is the same as for the $0 command). 


Here is a simple demonstration program of using pointers as variables: 


-ourPointer 


1234 # push some values on the main stack 

$:ourPointer # write the last one to our pointer "variable" 

5678 # push more values on the main stack 

$ourPointer # get back the value we saved in our pointer "variable" 
th 


When we run the program, after it finishes the internal state of our program may look like this: 


memory addresses Qo. d 2-3 4. 5. .6 -7..8.. 9.5.5 
memory cells 4 012 356 7 8 4.. 
^ 


^ 
ourPointer stack top 


pointer table: 
© (stack top) = 9 
r 


ourPointe 0 
Firstly we can see that the pointer table is separate from the main memory -- the addresses stored in the table for individual pointers 
correspond with the arrows that point to the main memory at the top. Stack top ended up pointing to address 9 at which final value 4 is stored. 
This value was pushes by the last command $ourPointer which took it from the address 0 which is where SEA aig The value 4 
was written to address 0 by the command $:ourPointer that took it from the stack top at the time the command was performed. 


Now let us move to a bit more advanced use of pointers. 


When declaring a pointer, we can specify the number of free (unoccupied) memory cells we want to get -- by default this is 1, i.e. above we 
only created a pointer and it automatically pointed to one free cell. But if we need to store more values, we can create something that can be 
seen as an array in a way which in languages such as C we would call static allocation. This we do at the time we are declaring a pointer 
as ~pointerName:N where N is the size (counted in cells) of the block of memory at the start of which pointerName will point. In the C 
language this would be equivalent to something like int myArray[N];. 


NOTE: The requested number of cells may be even 0. This will create a pointer that doesn't point to any free cell, i.e. it will point so some 
random cell which we shouldn't touch. Why create such pointers? It may be just for example a pointer which we use to temporarily save other 
pointer addresses to. 


Next we should take a look at more pointer commands that are necessary for advanced pointer manipulation. Let's just sum up the most 
DII ORARE we will typically use with pointers (note that for a few exceptions the name p may also be a name of the special pointers 
HAE 
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e ~p: declare pointer p with size 1 
e ~p:N: declare pointer p with size N 
* $p: push the value stored in cell to which pointer p points 
e $ip: pop 1 value and store it to the cell to which pointer p points 
*  $»p: make pointer p point one address "up" (increment the address stored in the pointer) 
* $<p: make pointer p point one address "down" 
*  $p»q: make pointer q point to the same cell as pointer p (copy address stored in p to q) 
Here is an example that prints given text string in reverse, showcasing what we've been talking about: 


-array:100 # array of 100 cells 
-stack2:0 # pointer we'll use for our second stack 
~tmp:0 # temporary storage for old stack top address 
printReversed: 
$array>stack2 # set stack2 pointer to start of the array 
$>stack2 # this is necessary to not pop at address 0 
0 $:stack2 # move string terminating © to stack2 
Q' # for all chars of the string on main stack 
>stack2 # shift second stack one address up 
:stack2 # move this char to the second stack 
^ # pop the string terminating 0 
$0>tm # store current stack top to emp 
$stack2>0 # set current stack top to stack2 
--> # print what's there 
$tmp>0 # restore the old stack top 
© "star dog" printReversed 


The program should print god. rats. Let's analyze what it's doing a bit. ~array:100 creates a pointer which will point to a block of 100 free 
memory cells -- we may see this continuous block of memory as an array and we'll use it as a second stack to reverse a string on the main 
stack. In the function printReversed we first set the stack2 pom to the beginning of the array and shift this pointer one address up -- 
this is because if stack2 theoretically pointed to address 0, the command -->at the end of the function would try to do a pop of the 
terminating 0 at the lowest possible address, which from comun specification can't be done (popping a value when at address 0 would get us 
to illegal address -1). The rest should be clear from the comments in the code: we use a loop to pop individual characters from the main stack 
to E second stack, then we temporarily move the main stack pointer to the second stack, print the string there, and move back to the main 
stack. 


Hopefully this wasn't all too difficult -- if so, don't worry, pointers are hard. Give it a bit of time, go through the examples again and try to 
experiment yourself, it should all make sense in the end. 


Data Types/Environments 

Comun has a notion of different width unsigned integer data types, but by default this is all hidden. All integers are implicitly unsigned and in 
two's complement representation, but some operations may consider integers signed -- for example / represents unsigned division 
while // means signed division (this is similar to how assembly languages work, there are distinct instructions for signed operations). Note 
that most operations, such as +, - or * don't have to distinguish between signed and unsigned integers, there is only one version for them. 


Suppose now that we are on a 32 bit computer -- this means that by default integers in comun have 32 bits and can store values from 0 to 
4294967295 (2^32 - 1). l you push value -1 on the stack, comun actually pushes the 
value 4294967295 (or 11111111111111111111111111111111 in binary), which in two's complement representation means -1. The value 
stored at stack top will be the same, 4294967295, it is up to us whether we, programmers, see it as a signed (-1) or unsigned (4294967295). 
We may for example perform the operation -1 -1 + just as well as 4294967295 4294967295 +, as this gives exactly the same result on a 
32 bit computer thanks to the wrap around behavior, the result will be 4294967294, or -2 if we see this value as signed. The distinction 
between signed and unsigned values is important to comun only in some situation, e.g. in case of division or comparison. For example -1 1 
< will result in value 0 because the < operator is UNSIGNED comparison and therefore it sees the operation as 4294967295 « 1 which is false; 
on the other hand if we use the signed comparison as -1 1 ««, we get 1 as the result because the operator really interprets the first value as 
negative one. 


In comun there are no composite data types -- comun is very low level and is only able to distinguish between different width integers. 
Anything more complex such as "structs", arrays or even objects has to be implemented by the programmer (note that arrays can however be 
implemented pretty easily with pointers). 


As mentioned, by default your program works with the platform's native integer type. It is only when you decide to care about data types more 
that you can tell comun to use different types. 


Data types in comun are implemented by so called type environments. A type environment is basically its own isolated "world" with its own 
memory and pointers (i.e. each environment has also its own stack top pointer, but note that e.g. functions don't belong to different 
environments as they simply name parts of the source code). Different type environments are distinguished by the width of their integer data 
type, i.e. the integer that's stored in that environment's memory cells. I.e. type environment 8 stores 8 bit integers in its memory cells, type 
environment 16 stores 16 bit integers in its memory cells etc. Type environment 0 is a special environment whose integer width is equal to 
the platform's native integer (but not smaller than 16) and which is the default type environment. 


The command to change type environments is ~N where N is the number of type environment, so e.g. ~8 switches to type environment 8 
and -0 switches to the native type environment. Keep in mind that this is not a run time command but a compile time one! Such a command 
in the source code just tells the compiler that from that point onward in the source code operations such as +, -, * and /will operate in the 
specified type environment. 


You can transfer values between type environments with the >N command where N is the environment to transfer the value to; the command 
pops 1 value in current type environment and writes it to the stack top of type environment N (watch out, it doesn't push the value, just 
overwrites stack top!). Thís allows e.g. for computing some expression in a type environment with high range of values (to prevent overflows) 
and then getting the final value back to the native environment. 
NOTE: comun implementation doesn't have to support all possible type environments (only type 0 is required), it may e.g. only include the 
common ones (such as 0, 8, 16 and 32). 
An example will demonstrate these concepts best: 
printNum: 
0 >< 
@@ 
$0 10 % "QO" + >< 
10 / 


$0 0 
!Q 


=? 


--> 
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# by default we're in type env. © (native type) 


© "highest value in type environment 0: " --> 

zl. # this will wrap around to the highest integer value 
printNum 

10 -> # newline 

~8 # swith to env. 8 

ea highest value in type environment 8: " --> 

>0 # transfer the value to env. 0 for printing 


-0 . # back to env. 0 
$0 printNum 10 -> 


~16 # switch to env. 16 


o hrghese value in type environment 16: " --> 
>0 


-0 p # back to env. 0 
printNum 10 -> 


$0 
This may print e.g.: 


highest value in type environment 0: 4294967295 
highest value in type environment 8: 255 
highest value in type environment 16: 65535 
Wh 


at is this good for? Sometimes you need control over the data type width, for example if you perform calculations in which you know 
values can get very high and might overflow, you may want to do that with 32 bit integer types (with maximum value 4294967295) because 
the default, native data type (environment 0) may in theory be only 16 bits wide (allowing a maximum value of 65535). On the other hand if 
you want to store large data in a form of a long array of bytes, you may want to do that in type environment 8 because there one byte fits 
exactly into one memory cells -- this will save a lot of RAM, which can be important e.g. on limited embedded devices. 


More Details: File Includes, I/O, Program Arguments, ... 
Now we'll mention some useful features we didn't get to yet. 


One such feature is a file include that allows for creating libraries. File includes make it possible to include source code from another file in 
your program. Thanks to this you may split your big project into multiple files or create libraries of reusable commonly used functions and then 
Just include these libraries in many different programs. A file include is done with the command -"filename" where filename is the path to 
the file to be included -- imagine this as a simple text copy-paste, whatever is in the included file will be pasted in the place where the include 
command appears. Note that the file include command in comun is not considered part of preprocessing (it can be used even with 
preprocessor disabled). 


Input/output: "vanilla" comun only has one input and one output stream of values; these values are understood to be ASCII values of text 
characters, so if you output value 65, A will appear on the output (usually on screen, but remember that on a Unix system your program's 
output may also be redirected e.g. to a text file). Similarly if you ask for input, you will get ASCII values of the text characters that are passed 
to your program (usually what user types on his keyboard). The built-in commands for input and output of a ingle value are <-and ->, 
respectively. There is also a command for checking whether input is still unfinished: «?. The command pushes 0 if all input values have been 
read (which applies mostly to reading from files) and is equivalent for checking for so called EOF (end of file) value in the C language. Finally 
there is a convenience function for printing out zero-terminated text strings which we've already seen: - ->. 


Program arguments: your program may receive arguments from the operating system when it starts, these arguments are typically the 
command-line flags with which your program is being executed (in C you may know this as argc and argv). Before the program starts, these 
arguments are pushed on the stack as zero-terminated strings (argv) and after them the number of these arguments is pushed (argc). 


Preprocessor 

Preprocessor is an advanced feature of the language, it can automatically modify the source code before it is processed, however in comun it's 
not supposed to be used very often (as is common e.g. in C). It allows for implementation of things such as templates, macros, conditional 
inclusion of libraries, selection of features to be compiled into the program etc. You very likely won't need to use preprocessor in most of your 
normal programs, but it may help in making some more complex ones. 


As said, unlike in the C language where preprocessor plays a crucial role, in the current official implementaion of comun preprocessor isn't 
enabled by default, it has to be enabled with the -p flag. It is not supposed preprocessor will be as heavily used in comun because it comes 
with more complexity, more difficult and hardware demanding compilation and it is usually easy to avoid anyway: note that things such as file 
includes and definition of global constants can be done without preprocessor (file includes are not part of preprocessor and constants can be 
implemented with functions). So consider only using preprocessor if you really have a good reason for it. 


Comun preprocessor uses the same languge -- comun -- for its work, i.e. unlike in C, preprocessor here doesn't use a special language. In 
comun a program to be preprocessed is basically a comun program that prints a source code of the final comun program to be compiled. There 
is a little bit of syntax sugar to make this all comfortable: preprocessor code is separated from the underlying code with [ and ]brackets, i.e. 
everything between such brackets is considered to be code that belongs to preprocessor. 


NOTE: for technical reasons [ and ] characters cannot be used for any other purpose in comun program, they cannot appear even in 
comments or strings. 


When source code is to be preprocessed, the preprocessor basically sees everything outside the [ and ] brackets as a string to be pumed out, 
and everything inside [ and ] brackets as a code to be executed. By executing a code in this way one gets the final code to that will be passed 
to the compiler. 


Let us see an example program: 


-polite. ; k 
© $:polite # switch between © and 1 to change politeness 


[ $polite ? ] 
. "Good sir, would you kindly enter a character please? " 


; 
enter some character: " 


E. 


polite ? | 
. "The excellent character you entered was: " 


j you entered: " 
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If we compile this program, the preprocessor looks at this program and sees something like this: 


-polite 
0 $:polite 


# print: 0 


$polite ? . . 
# print: "Good sir, would you kindly enter a character please?" 


; A 
# print: "enter some character: " 


# print --> 
# print <- 
# print 0 


$polite ? 
# print: "The excellent character you entered was: " 


ta print: "you entered: " 


13 

print: -> . 

Note that for readability here we put in comments what should really be true comun print commands. If you want, you can actually see the 
true output of preprocessor with special flags passed to comun compiler, see comun -h for details. Preprocessor executes the code and so 


creates the preprocessed code: 
fenter some character: " 
--> 


«- 


io} 
"you entered: " 
--> 


io -> 
This code is then passed to the compiler and compiled. A run of the program may therefore look like this: 


enter some character: a 
you entered: a 


Now if we want to change the politeness of our program, we can simply change the line in the original program from: 
© $:polite # switch between © and 1 to change politeness 
to 


:polite # switch between 0 and 1 to change politeness 


i $:poli ‘ 
This will lead to preprocessor passing a different code to the compiler. It may look like this: 
"Good sir, would you kindly enter a character please?" 

--> 


<- 


0 
"The excellent character you entered was: " 
--> 


-> 


10 -> 
And the run of the program may look like this: 


Good sir, would you kindly enter a character please? a 
The excellent character you entered was: a 


Now it should be at least a little obvious that preprocessor can make it possible to shape the source code by just changing a single value 
somewhere at the beginning of the code. Of course preprocessor may use all the power of the comun language, for example loops and 
functions, but here should also come a warning that this may be dangerous and lead to loss of readability, so always consider to use less 
rather than more. All in all, you should only start using preprocessor once you get very comfortable with the language. 


docs/faq howto.md 


Comun FAQ And How To 
by drummyfish 


This is a quick and dirty document providing some answers and directions so that people don't have to email me about common and/or trivial 
things. However if this document doesn't satisfy you, don't be afraid to mail me at drummyfish(adisroot.org. 


I found a bug and/or have a suggestion, what now? 
Just send it to my mail (at the top of this document). 


How do I integrate comun as a scripting language to my program? 

Currently the C implementation of comun can be integrated to C/C++ programs very EE you basically just include the header file of the 
implementation (comun. h, or possibly minicomun.h) and use functions it provides (you don't even need to install any dependencies or do 
any linking, the single-header libraries contain their implementation). 


Firstly consider if you want full comun or if minicomun will suffice (minicomum is a much smaller and simpler implementation of comun subset, 
present among the C sources). Even full comun should be very minimal, but why go more complex than necessary? 


With minicomun you just pass a string with the program to a function that interprets it. With comun.h you can do this too, there is a 
convenience function CMN_interpretStr that does this. 


I need something more complex such as compiling from a different stream of characters, controlling optimization, interpreting by 
individual steps etc., you have to handle this yourself with provided structs and functions (you'll have to use comun .h, minicomun.h doesn't 
provir as much control), mainly related to the compiler and interpreter -- it's still pretty easy, you'll just have to write a bit more code. Also 

eep in mind that preprocessor is a bit more difficult to integrate (take a look at comun. c if you need to do it), you should just not use it if you 
don't absolutely need it. Everything is documented in the header file itself so take a look at comun.h header and comments of the functions 
(you can also use doxygen to autogenerate an HTML documentation). If you want to see an example of integrating comun to C program this 
Way, one is provided with my SAF library at https://codeberg.org/drummyfish/SAF/src/branch/master/examples/saf comun.h. 


How fast/efficient is it? 

Comun was made with simple technology in mind, i.e. it was made for writing fast and efficient programs, which is necessary when you have 
potato computers. The C implementation was tested on a device with only 2.5 Kb RAM which was able to compile and run the minitest.h test 
program. Of course you can't really talk about a speed of pure programming language, specific implementation and its ability to optimize 
always matters as well as the quality of code you write in the language itself, architecture of your hardware etc., but generally comun should 
be very fast; no high level bloat (such as dynamic ec: garbage collection, bound checking etc.) is preventing it from being so -- it is very 
low level without overhead of complex abstraction, it should be easy to automatically optimize and should relatively easily map to assembly. 
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Keep in mind that current C implementation of comun interpreter isn't optimized for speed but rather for relative simplicity of code, it can be 
made MUCH faster, however if you need to write a fast program in comun right now, you can just transpile it to C, this sometimes even results 
in a program that's slightly faster than if you write in directly in C, see the table below. 


My plans now are to also write a small public domain CPU along with an ISA that would be friendly to comun code, i.e. probably something with 
stack-based computation in mind. With some existing CPUs nowadays there may be a bit of effort needed to generate absolutely optimal 
assembly from comun -- please keep in mind | am not an expert on CPUs at all, so take the following as more or less my best guess view of the 
situation: a straightforward/naive mapping of comun's stack-based computation to a typical CPU's assembly will be simple to make and quite 
fast but may not fully utilize a register architecture as basically each operation will mean a memory read, register operation, stack shift and 
memory write, i.e. several instructions, even though some CPU architectures (register-memory or register-plus-memory) may be very friendly 
to this as they allow to operate directly on memory. On load-store architectures some effort may be needed to convert operations on stack to 
operations done mainly with registers with minimum read/writes to/from main memory, for example we might copy a portion of the stack to 
registers, then perform N operations on this "stack emulated with registers" and then copy the whole block back to memory. However, lacking 
practical experience with this | can't really tell how close to reality | am thinking here. 


Here is a quick test | did, | made a program that computes 12345678 iterations of an algorithm x[n + 1] := (x[n] < 10000 ? (x[n] + 
2 + 8000 / (7 * x[n] + 1)) : XEM. - 9000)), x[0] := 123. The expression contains addition, subtraction, division, multiplication 
in 


and a branch. Here are the results (ran on Thinkpad X200): 
program execution time (sec) 

comun -> C-O3 0.08 

C -03 0.09 

comun -> C 0.83 

python 3.71 


comun interpreter 6.07 
minicomun 16.00 
I'd like to write a new compiler backend so that I can compile comun to my second favorite language. 


How do I do this? 

Take a look at how existing backend are made, i.e. the files backend. c.h and backend comun. h. Basically you make a new backend source 

code, say backend mylang.h and in it you create a function that takes comun bytecode, translates it to a program in your language and 

paints this to the file which is handed to that function. To understand the bytecode, see the bytecode documentation in /docs and how other 
ackends translate it. Then you just integrate this backend to comun.c which just involves including your new backend header, adding a new 

command line option and some ifs which just call your function -- again, just take a look at how this is done with the C and comun backends. 


Can I contribute? 

Not to this repo, but you can totally fork this and do absolutely anything you please -- in fact | highly encourage this, | reject any form of 
"intellectual property" and support hacking without any boundaries. Why don't | accept contributions then? As with my other projects, | want to 
keep the original repo completely my own work, ie because | am weird and absolutely can't collaborate with anyone, and secondly to 
prevent issues arising from other people hopping on the board, for example someone suddenly trying to "withdraw" a granted license and 
whatnot. Now I can say this is completely my own work from the ground up and | 100% waive all my "rights" to it in the clearest way possible. 


Why the name "comun"? 

| was searching for a good name for quite some time by browsing dictionaries of various languages etc., it's extremely hard to find something 
that's not already taken -- somehow | randomly came up with comun which seemed nice AND not already taken. | immediately liked the name 
for a number of reasons, some of them being: 


e It's a classy name but not overly pompous or cringe, not some kind of cheap zoomer/corporate bullshit along the lines of "potato rainbow" or "rust". I 
hate that shit with my soul. 

e It just sounds good. 

e Inasense it refers to the purpose: being a common programming language for good technology. 
It sounds like it's related to communism, which it is, so it will keep capitalists and especially Americans away. 


Can and should I write anything more complex than Tetris clone in this? Isn't this just esolang? 

Yes, yes and no. It is absolutely possible to write quite big programs even in assembly, see e.g. RollerCoaster Tycoon and Apollo 11 Moon 
landing, and comun is still higher level than assembly, so it will be easier. This just takes a bit more effort and requires skills that zoomer 
"programmers" no longer posses because they're brainwashed by capitalist cancer. Why do this when "modern" high level languages exist? 
See the question about ideology etc. 


Why this obsession with simplicity, why this license, why not just C++/Java/Lua, muh memory safety 


blablabla ideology, politics, philosophy, metaphysics blablabla capitalism communism... 

This is not a place to discuss such questions. If you just hate this, go enjoy your bloatware and steam gaymes, if you are open minded and 
curious or even like this approach and want to study it more, kindly follow the rabbithole that starts at my website (www.tastyfish.cz) and leads 
to my personal wiki about so called Less Retarded Software/Society. 


Is this comfortable for practical programming? 

Once you get into the language, it is very comfortable, but of course not as fast to program in as nn level scripting languages or even C. I 
was personally used to C programming but when I hopped to comun, after a few days aot comfortable with it and found arealer Joy in it than 
in C as the code is so much more compact and nicer, a function feels like a carefully crafted mathematical formula rather than some pragmatic 
duct tape code to just get some task done. 


Is this really the best programming language? 
Indeed, as far as | know it is. But things can always be improved, there are still some things in the TODO file. 


This sucks lol I made it crash. 
Nice, well done, let me know how you did it and | may try to fix it, but still at the moment the implementation is considered more or less 
temporary, everything is still work in progress, for the moment don't use this for anything that people's lives depend on. 


I just wanna talk to you. 
Thanks, this is the nicest thing l've heard in a while. Send me an email (see top of this document). 


Can I give you money? 
Thank you very much for this kindness «3 This is a selfless project, it's absolutely not made for any profit. If you absolutely insist, | have a 


79 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); Comun 


donation info on my website. But please know that | won't let money affect my projects in any way, | won't be giving any privileges to sponsors 


etc., i.e. all a donation will achieve is making me happy and giving me more time and freedom to do things I think are right. 


src c/comun.h 


#ifndef |COMUN H 
#define  COMUN H 


/** Comun programming language implemented as a KISS single header C99 library. 


Hoo Holl RER Holl HH 


The interpreter implemented here is 


supposed to be small and simple rather 
than fast and efficient. 


By drummyfish, released under CCO 1.0, public domain. */ 


#include <stdint.h> 


#define 
#define 
version 


CMN LANG VERSION STRING "0.9" 


///« implemented language version 
CMN LIB VERSION STRING "9.8d" 


///« implementation (not language) 


#define CMN NATIVE UINT unsigned int ///< data type of type env. 0 


#ifndef CMN TOKEN MAX LENGTH 
/** Maximum allowed token len 


#define CMN TOKEN MAX LENGT| 
#endif 


th. 
128 


x 


#ifndef CMN PARSE STACK SIZE 

/** Size of compile stack, says h 
#define CMN_PARSE_STACK_SIZE 12 

#endif 


ow many levels of nesting can be processed. */ 


#ifndef CMN INTERPRETER CALLSTACK SIZE 
17 Size of the interpreter call stack, says the max depth of function calls. 


#define CMN_INTERPRETER_CALLSTACK_SIZE 64 
#endif 


#ifndef CMN_STRING_PSEUDOHASH_SIZE 

/** Size, in bytes, of string pseudohash that's used in symbol 
should be at least 8. Increasing this lowers the probability 
collision (should be reasonably low with the default value). 

A adetine CMN_STRING_PSEUDOHASH_SIZE 8 
endi 


table. This 
oF string hash 


#define CMN MINIMUM STACK SIZE 16 ///< Minimum main stack size by 
specification. 


/** Converts an unsigned value to signed as it would happen in two's 
comp Lement, 
which is not guaranteed in C, so this function exists for portability. */ 


int32 t CMN unsignedToSigned32(uint32 t value, uint8 t bits); 
int CMN unsignedToSignedNative(CMN NATIVE UINT value); 


/** Creates a pseudohash from given string and type char (type char specifies 
a group of symbols e.g. function names, variable names etc.). Pseudohash is 
a Fixed width string with low probability of collisions with other 
pseudohashes. Pseudohash will only consist of such characters that it will be 
a valid Comune identifier, but keep in mind the temrinating © won't be 

resent. 

vola CMN pseudohash(char typeChar, const char *str, 

char hash[CMN STRING PSEUDOHASH SIZE]); 


uint64 t CMN_literalValue(const char *literalString, uint8 t *negative, 
uint8 t *ok); 


// tokenizer states: 


#define CMN TOKENIZER NOTHING 0x00 
#define CMN TOKENIZER TOKEN 0x01 
#define CMN TOKENIZER ERROR 0x02 
#define  CMN TOKENIZER BLANK 0x03 
#define  CMN TOKENIZER COMMENT 0x04 
#define  CMN TOKENIZER STR 0x05 
#define  CMN TOKENIZER STR END 0x06 
#define  CMN TOKENIZER NAME 0x07 
// possible types of tokens returned by tokenizer: 
#define CMN TOKEN ERROR 0x00 
#define CMN TOKEN COMMAND 0x01 
#define CMN TOKEN NAME 0x02 
#define CMN TOKEN FUNC 0x03 
#define CMN TOKEN NUMBER 0x04 
#define CMN TOKEN STRING 0x05 
#define CMN TOKEN BRANCH 0x06 
#define CMN TOKEN LOOP 0x07 
#define CMN TOKEN END 0x08 
#define CMN TOKEN ELSE 0x09 
#define CMN TOKEN BREAK 0x0a 
#define CMN TOKEN LABEL 0x0b 
/** Serves to convert a stream of source code characters to a stream of 
language 

tokens. */ 


typedef struct 


uint8_t state; 
char EokenString[CMN TOKEN-MAX LENGTH + 1]; 
uinti6 t tokenStringPos; 

} CMN Tokenizer; 


void CMN tokenizerInit(CMN Tokenizer *tokenizer); . 
uint8 t CMN tokenizerFeedChar(CMN Tokenizer *tokenizer, char character); 
uint8 t CMN identifyToken(const char *tokenString); 

#define CMN BYTECODE HEADER SIZE 8 

#define CMN BYTECODE CHECKSUM BYTE 4 


/// instruction parameters A 
#define CMN IPARAMS(typeEnv, noPop, constCont, immediateC)\ 


(((typeEnv) «« 6) | ((noPop) «« 5) | ((constCont) «« 4) | (immediateC)) 


// values for the DES instruction: 
#define CMN DES IF 0x01 
#define CMN DES ELSE 0x02 
#define CMN DES IF END 0x03 
#define CMN DES LOOP 0x04 
#define CMN DES LOOP BREAK 0x05 
#define CMN DES LOOP END 0x06 
#define CMN DES FUNC 0x07 
#define CMN DES EXIT 0x08 
#define CMN DES GOTO 0x09 
#define CMN DES LABEL 0x0a 


#define 
#define 
#define 
#define 


#define 


#define 


CMN_MASK_INSTR_NOPOP 
CMN_MASK_INSTR_CON 
CMN_MASK_INSTR_MODE 
CMN_MASK_INSTR_GROUP 


CMN_OPCODE_SPE 


CMN_LAST_SPECIAL_PTR 


// instruction modes: 


#define CMN_OPCODE_21 0 ///< 
#define CMN_OPCODE_1C1 1 ///« 


#define 
#define 


CMN_OPCODE_11 
CMN_OPCODE_01 


// instruction groups: 


#define 
#define 
#define 
#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 


#define 
#define 


#define 
#define 
#define 
#define 
#define 
#define 


CMN_OPCODE_AD 
CMN_OPCODE_SU 
CMN_OPCODE_MU 
CMN_OPCODE_DI 
CMN_OPCODE_DS 
CMN_OPCODE_MO 
CMN_OPCODE_MS 


CMN_OPCODE_GR 
CMN_OPCODE_GE 
CMN_OPCODE_SM 
CMN_OPCODE_SE 


CMN_OPCODE_GS 
CMN_OPCODE_BS 
CMN_OPCODE_SS 
CMN_OPCODE_LS 


CMN_OPCODE_EQ 
CMN_OPCODE_NE 


CMN_OPCODE_BA 
CMN_OPCODE_BO 
CMN_OPCODE_BX 
CMN_OPCODE_LA 
CMN_OPCODE_LO 
CMN_OPCODE_LX 


// SPECIFIC OPCODES: 


///« 
///« 
///« 


0x20 
0x10 
0x03 
Oxfc 
Oxif 


CIALS ///« 


15 ///« 


mode: 
mode: 
mode: 
mode: 


2 ///« 
3 ///« 


0x20 
0x24 
0x28 
Ox2c 
0x30 
0x34 
0x38 


0x40 
0x44 
0x48 
Ox4c 


0x50 
0x54 
0x58 
Ox5c 


0x60 
0x64 


0x68 
Ox6c 
0x70 
0x74 
0x78 
Ox7c 


// special instructions: 


#define 
#define 
#define 
#define 
#define 


#define 
#define 
#define 


#define 
#define 
#define 


#define 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 
#define 
#define 


// typical stack instructions, 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


#define 
#define 


#define 
#define 


#define 
#define 
#define 


CMN_OPCODE_END 
CMN_OPCODE_NOP 
CMN_OPCODE_DES 
CMN_OPCODE_COC 
CMN_OPCODE_ERR 


CMN_OPCODE_CAL 
CMN_OPCODE_CAE 
CMN_OPCODE_RET 


CMN_OPCODE_JIA 
CMN_OPCODE_JNA 
CMN_OPCODE_JMA 


CMN. OPCODE INI 


CMN. OPCODE PSC 
CMN. OPCODE PAC 
CMN. OPCODE PAX 
CMN_OPCODE_PCO 
CMN_OPCODE_MEX 
CMN_OPCODE_MGE 
CMN_OPCODE_PUX 
CMN_OPCODE_PCM 


CMN_OPCODE_CON 
CMN_OPCODE_CND 
CMN_OPCODE_SWP 
CMN_OPCODE_TRA 
CMN_OPCODE_POP 
CMN_OPCODE_OUT 


CMN_OPCODE_ADX 
CMN_OPCODE_ADC 
CMN_OPCODE_SUX 
CMN_OPCODE_SUC 
CMN_OPCODE_MUX 
CMN_OPCODE_MUC 
CMN. OPCODE DIX 
CMN. OPCODE DIC 
CMN. OPCODE DSX 
CMN. OPCODE DSC 
CMN. OPCODE MOX 
CMN. OPCODE. MOC 
CMN. OPCODE MSX 
CMN. OPCODE MSC 


CMN. OPCODE GRX 
CMN. OPCODE. GRC 
CMN. OPCODE GEX 
CMN. OPCODE GEC 
CMN_OPCODE_SMX 
CMN_OPCODE_SMC 
CMN_OPCODE_SEX 
CMN_OPCODE_SEC 


CMN_OPCODE_GSX 
CMN_OPCODE_GSC 
CMN_OPCODE_BSX 
CMN_OPCODE_BSC 
CMN_OPCODE_SSX 
CMN_OPCODE_SSC 
CMN. OPCODE LSX 
CMN. OPCODE LSC 


CMN. OPCODE EQX 
CMN. OPCODE EQC 


CMN. OPCODE NEX 
CMN. OPCODE NEC 


CMN. OPCODE BAX 
CMN. OPCODE BAC 
CMN. OPCODE BOX 
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0x00 
0x01 
0x02 
0x03 
0x04 


0x07 
0x08 
0x09 


Ox0a 
OxOb 
OxOc 


OxOf 


0x10 
0x11 
0x12 
0x13 
0x14 
0x15 
0x16 
0x17 


Oxia 
Oxib 
Oxic 
Oxid 
Oxie 
Oxif 


fit one 
AD 
AD 
SU 
SU 
MU 
MU 
DI 
DI 
DS 
DS 
MO 
MO 
MS 
MS 


CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 
CMN. OPCODE 


CMN. OPCODE GR 
CMN. OPCODE GR 
CMN. OPCODE GE 
CMN. OPCODE GE 
CMN. OPCODE SM 
CMN. OPCODE SM 
CMN. OPCODE SE 
CMN. OPCODE SE 


CMN. OPCODE GS 
CMN. OPCODE BS 
CMN. OPCODE BS 
CMN. OPCODE SS 
CMN. OPCODE SS 
CMN. OPCODE LS 
CMN. OPCODE LS 


CMN. OPCODE E 
CMN. OPCODE E 


CMN. OPCODE NE 
CMN. OPCODE NE 


CMN. OPCODE BA 
CMN. OPCODE BA 
CMN. OPCODE BO 


| 
| 
| 


"no pop" bit | 
"constant continue" bit . 
mode of typical instructions 


upper bound of special instructions 


last special pointer index 


pop 2, push 1 


use immediate const., 


Bus push 1 


of the predefined modes: 
CMN OPCODE 21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 


CMN OPCODE 21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 
CMN OPCODE 21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 


CMN_OPCODE_21) 
CMN_OPCODE_1C1) 
CMN OPCODE 21) 
CMN_OPCODE_1C1) 
CMN OPCODE 21) 
CMN_OPCODE_1C1) 
CMN_OPCODE_21) 
CMN_OPCODE_1C1) 


CMN_OPCODE_21) 
CMN_OPCODE_1C1) 


CMN OPCODE 21) 
CMN_OPCODE_1C1) 


CMN OPCODE 21) 
CMN_OPCODE_1C1) 
CMN OPCODE 21) 


#define CMN OPCODE BOC 
#define CMN OPCODE BXX 
#define CMN OPCODE BXC 


CMN. OPCODE BO 
CMN. OPCODE BX 
CMN. OPCODE BX 


CMN OPCODE 1C1) 
CMN OPCODE 21) 
CMN_OPCODE_1C1) 


#define CMN_OPCODE_LAX 
#define CMN_OPCODE_LAC 
#define CMN_OPCODE_LOX 


a CMN_OPCODE_LA 
#define CMN OPCODE LOC 


al CMN OPCODE 21) 
CMN. OPCODE LA CMN_OPCODE_1C1) 
CMN_OPCODE_LO CMN_OPCODE_21) 
CMN_OPCODE_LO CMN_OPCODE_1C1) 
#define CMN_OPCODE_LXX ii 


CMN. OPCODE LX CMN OPCODE 21) 
#define CMN OPCODE LXC 


CMN OPCODE LX | CMN OPCODE 1CÍ) 


#define CMN OPCODE BNO (0x80 | CMN OPCODE 11) 


#define CMN OPCODE INU CMN. OPCODE 01 


#define CMN OPCODE ADR (OxfO CMN. OPCODE 01 
#define CMN OPCODE INP CMN. OPCODE 01 


// interpreter status codes: 


#define CMN INTERPRETER END 0x00 ///« end of program reached 
#define CMN INTERPRETER OK 0x01 ///« execution continues 
#define CMN INTERPRETER ERROR Ox10 ///« generic error 

#define CMN INTERPRETER ERROR THROW 0x11 ///« error raised by ERR instr. 


#define CMN INTERPRETER ERROR OPERATION 0x20 ///« bad operation 

#define CMN INTERPRETER ERROR ZERODIV 0x21 ///« division by zero 

gder ine CMN_INTERPRETER_ERROR_BAD_CALL 0x22 ///< call of unknown external 
unc. 


#define CMN INTERPRETER ERROR MEMORY 0x30 ///« out of memory 
#define CMN INTERPRETER ERROR STACK OF 0x31 ///« memory stack overflow 
#define CMN INTERPRETER ERROR CALLSTACK 0x33 ///« call stack overflow/underf low 


#define CMN INTERPRETER ERROR BYTECODE 0x40 ///« malformed bytecode 
#define CMN INTERPRETER ERROR BC HEADER 0x41 ///« bad bytecode header 
#define CMN INTERPRETER ERROR BC OPCODE 0x42 ///« invalid opcode 

#define CMN INTERPRETER ERROR BC INSTR 0x43 ///« nonsense instruction data 


#define CMN INTERPRETER ERROR BC JUMP Ox44 ///« jump to nonexistent location 

/** Function used by the interpreter to perform I/O. The argument is value to 
print and will be either non-negative and lower than 256 in which case print 
of the value should be performed (and return value doesn't matter), or -1 in 
which case a 1 byte character should be read from input and returned. If a 
character is to be returned from finished input (EOF reached), -1 should be 
returned. */ 

typedef inti6 t (*CMN IOFunction)(inti6 t); 


/** Function used by compiler to indicate that a file include command has been 
encountered and that it should be read from. User of the library is supposed 
to implement this function. When the library calls it, it says the specified 
file is to be open and subsequent characters fed to compiler should be from 
that file. If preprocessing is active, the content of each file has to be 
prepended with '[' and appended with ']' (without preprocessor this may or 
may not be done). Once the file has been all read, the library user must NOT 
feed a 0 terminating character to compiler (which would indicate end of whole 
source code), but must simply silently start feeding characters from the 
previously opened file. © character must be fed at the very end of the source 
code. If this function is called asking for opening a file that is already 
open above in the include stack (i.e. which would cause a circular include), 
it must be ignored. The string passed as argument won't last after the 
function ends and has_to be copied if needed. */ . 

typedef void (*CMN FileIncludeFunction)(const char *fileName); 


struct | CMN InterpreterS; 


/** Function used by interpreter to signal exterunal function calls. The first 
parameter is external function index, the second parameter is pointer to the 
interpreter that calls the function. */ 

typedef void 
(*CMN ExternalCallFunction)(uinti16 t, struct  CMN InterpreterS *); 


[pedet struct _CMN_InterpretersS 


const uint8 t *bytecode; 
CMN. NATIVE UINT memoryóÓ; 
uint8 t *memory8; 
uinti6 t *memory16; 
uint32 t *memory32; 


uint32 t memorySizes[4]; ///« number of cells in each type env. 
uint32 t 'Doinfers[4 ; ///« pointer tables for each type env. 
const uint8 t *callstack[CMN INTERPRETER CALLSTACK SIZE]; ///« ret. addresses 


uinti6 t callStackTop; 
const uint8 t *currentInstruction; 
CMN IOFunction ioFunction; 
CMN ExternalCallFunction externalCallFunction; 
uint8 t inputEndReached; 
uint32 t ep; 
uint8 t argc; 
const char **argv; 
} CMN Interpreter; 


/** Initializes interpreter, returns 1 on success 
memory provided), minCells says the minimum number of memory cC 
allocate 
(in case automatic estimation underestimates it), argc and argv are arguments 
.passed to the program, argv must not be changed until interpretation ends! */ 
uint8 t CMN inter reterInit CMN Interpreter *interpreter, 
const uint8 t *bytecode, uint8 t *memory, uint32 t memorySize, 
uinti6 t minCells, CMN. foFunction ioFunction, 
CMN ExternalCallFunction externalCallFunction, uint8 t argc, 
const char **argv); 


otherwise 0 (919; too little 
ells to 


/** Executes given number of steps of execution of interpreted program 
one step ~= one non-empty instruction), returns the state 
.(see CMN INTERPRETER * ). */ . ] 

uint8 t CMN interpreterStep(CMN Interpreter *interpreter, uint32 t steps); 


uint32 t CMN interpreterGetInstrAddress(const CMN Interpreter *interpreter); 


/** Sets an address in bytecode at which execution will continue next. */ 
void CMN interpreterGoto(CMN Interpreter *interpreter, uint32 t address); 


void CMN interpreterCallFunction(CMN Interpreter *interpreter, 
uint32 t functionID); 


/** Gets a value that's currently on stack top of type environment 0 in 
interpreter's (with possible negative offset). This function doesn't check 
whether such value exists (i.e. if it isn't under address 0) -- in such case 
© is returned. The value is not popped. */ 

CMN NATIVE UINT CMN interpretGetValue(CMN Interpreter *interpreter, 
uint8 t stackTopOffset); 


/** Pushes value on stack in type environment © of given interpreter. */ 
void CMN interpreterPush(CMN Interpreter *interpreter, CMN NATIVE UINT value); 


/** Pops n values from type environment 0 of given interpreter. This function 
doesn E speck whether this is possible -- as many values as possible will be 
opped. 

void CMN_interpreterPop(CMN_Interpreter *interpreter, uint8_t n); 


/** Convenience function which just simply interprets source code passed as 
string, memory and memorySize specify memory used for the whole process . 
(bytecode generation, interpreter memory, ...), statusCallback is an optional 


function pointer which if non-zero will be called once with first paramteret 
either 0 (successful end, interpreter pointer passed), 1 (error during 
compileation, second parameter say string position of error) or 2 (error 
pouring run, interpreter pointer passed), maxSymbols says the maximum amount 


symbols in symbol table, maxSteps is the maximum number of interpreter steps 
or 0 (infinite). The function returns final value at the stack top in type 
environment 0. */ 

int CMN interpretStr(const char *source, uint8 t *memory, 
uint32 t memorySize, uinti6 t minCells, uint32 t maxSymbols, 
uint32 t maxsrens CMN IOFunction ioFunction, 
void (*statusCa lback)(uint8 t, uint32 t, CMN Interpreter *)); 


// preprocessor states: 

#define CMN PREPROCESSOR OK io} 
#define CMN PREPROCESSOR ERROR 1 
#define  XCMN PREPPROCESSOR OUT 2 
#define  CMN PREPPROCESSOR IN 3 


typedef struct 


uint8_t state; 
uint8 t minify; // whether stage 2 output should be minified 
CMN Tokenizer tokenizer; 
void (*outFunction)(char); 
} CMN Preprocessor; 


void CMN preprocessorInit(CMN Preprocessor *preprocessor, uint8 t minify, 
void (*outFunction)(char)); 


/** Feeds an input character to preprocessor. The preprocessor will possibly 
output several characters in return (via the callback function). */ 
uint8 t CMN preprocessorFeedChar(CMN Preprocessor *preprocessor, char c); 


/** Estimates how much memory will be needed for the execution of bytecode, 
returns estimated number of memory cells needed for each type environment 
(0 signifies the environment isn't used at all) and an exact number of 
pointers (user ones plus stack top) used in each type environment. This 
can be useful for preallocation of resources. The minStackSize says the 
minimum size of main stack that should be considered, however at least the 
minimum value given by specification will be taken into account. */ 

void CMN estimateMemory(const uint8 t *bytecode, uint32 t minStackSize, 
uint32 t memoryce Lis | À], uint32 t pointers[4]); 


static inline uint8_t CMN_instrTypeEnv(const uint8_t *instruction); 

void CMN_instrToStr(const uint8_t *instruction, char string[16]); 

uint64 t CMN_instrGetConst(const uint8_t *instr); 

void CMN instrGetConsts(const uint8 t *instr, uint64 t *c1, uint64 t *c2); 
uint8 t CMN instrGetConstBits(const uint8 t *instr); 

uint8 t CMN instrTouchesMem(uint8 t opcode); 

uint8 t CMN instrTouchesPtr(uint8 t opcode); 


uint8 t CMN bytecodeChecksum(const uint8 t *bytecode); 


/** Removes a continuous block of instructions from bytecode and modifies rest 
of bytecode to keep its semantics (recomputes jump addresses, recomputes 
header checksum, ...). */ 

void CMN bytecodeRemoveInstrs(uint8 t *bytecode, uint32 t startAddr, 
uinti6 t instrCount); 


typedef struct 


CMN Tokenizer tokenizer; 
uint8 t *bytecode; 
const uint8 t *bytecodeLimit; 
uint8 t *bytecodeEnd; 
uint8 t currentTypeEnv; 
pintat implicitAddressSize; /**« How many half-bytes are reserved for 
unknown 
addresses, if compilation fails due to 
address not fitting, increase this. */ 
uint32 t parseStack[CMN PARSE STACK SIZE]; 
uint8 t parseStackTop; 
uint8 t state; 
uint8 t flags; 
char *symbolTable; 


/**« Symbol table stores pseudohashes of strings 
(ptr and func ngmes), each pseudohash has a 
type indicated by its first char ('f': 


func. 
def., 'c': func. call, 's': info about 
pointer size, 'l': label def., d goto, 
'e': external call, '0', '1', '2' and '3': 
tr. in respective type env., 'n': unused). 


ach symbol has an index which is given by 
: its order among same type symbols. */ 
uinti6 t symbolCount; 
uinti6 t symbolTableSize; ///« Maximum number of items in the table. 
CMN FileIncludeFunction includeFunction; ///« If 0, includes aren't 
supported. 
} CMN Compiler; 


0x00000001 ///« Remove NOP instructions. 

0x00000002 /**« Remove dead parts of code, 
e.g. unused functions. */ 

0x00000004 /**« Replace operations with more 
efficient ones. * 

0x00000008 ///« Inline functions. 

Oxffffffff 


#define CMN OPTIMIZE REMOVE NOPS 
#define CMN OPTIMIZE REMOVE DEAD 


#define CMN OPTIMIZE REPLACE OPS 


#define CMN OPTIMIZE INLINE 
#define CMN OPTIMIZE ALL 


/** Applies selected optimizations to bytecode, compiler pointer can optionally 
be passed $9 that its symbol table is adjusted to match the optimized 
ytecode. * 

void CMN bytecodeOptimize(uint8 t *bytecode, uint32 t types, 
CMN Compiler *compiler); 


#define CMN BYTECODE SANITY OK 0x01 ///« all OK... 

#define CMN BYTECODE SANITY ERROR 0x02 ///« unspecified error 
#define CMN BYTECODE SANITY ERROR HEADER 0x03 ///« malformed header 
#define CMN BYTECODE SANITY ERROR CHECKSUM 0x04 ///< bad code checksum 
#define CMN BYTECODE SANITY ERROR INSTR 0x05 ///« bad instruction 
#define CMN BYTECODE SANITY ERROR NO END 0x06 ///« no end instruction 


/** Performs a basic sanity check of given bytecode and returns appropriate 
status code. Note that passing this test does not guarantee sanity or 
safety of the bytecode, it just catches most obvioüs errors. */ 

uint8 t CMN. bytecodeChecksanity(const uint8 t *bytecode, uint32 t maxSize); 


// compiler status codes: 

#define CMN COMPILER OK 0x00 
#define CMN COMPILER ERROR BAD TOKEN 0x01 
#define CMN_COMPILER_ERROR_UNEXPECTED_TOKEN 0x02 
#define CMN_COMPILER_ERROR_UNEXPECTED_END 0x03 
#define CMN COMPILER ERROR BYTECODE TOO BIG 0x04 


#define CMN COMPILER ERROR UNKNOWN NAME 0x05 
#define CMN COMPILER ERROR REDEFINED 0x06 
#define CMN COMPILER ERROR UNSUPPORTED 0x07 
#define CMN COMPILER ERROR PARSE STACK 0x08 
#define CMN COMPILER ERROR SYMBOL TABLE 0x09 
#define CMN_COMPILER_ERROR_GENERIC Oxff 


void CMN compilerInit(CMN Compiler *compiler, uint8 t *bytecode, 
uint32 t bytecodeMaxSize, char *symbolTableMemory, uint32 t symbolTableSize, 
CMN FileIncludeFunction includeFunction); 


/** Feeds a single source code character to the compiler. Note that compiler 
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does not perform preprocessing (see the preprocessor struct). The compiler 
potential y generates part of the bytecode, sets it status code and returns 
1t. 

uint8 t CMN compilerFeedChar(CMN Compiler *compiler, char character); 


/** Adds symbol to compiler's Symbol table. */ | 
int32_t CMN_compilerAddSymbol(CMN_Compiler *compiler 
char symbol[CMN STRING PSEUDOHASH SIZE]); 


/** Finds symbol by name, returns its index or -1 if not found. */ 
int32 t CMN compilerFindSymbol(const CMN Compiler *compiler 
char symbol[CMN STRING PSEUDÓHASH SIZE]); 


/** Given a name of function, returns its index according to symbol table, or 
-1 if match isn't found. This function may only be used after the code has 
been compiled. */ 

int32 t CMN compilerFindFunction(const CMN Compiler *compiler 
const char *funcName, uint8 t isExternal); 


M d symbol with given index and type (index is the sequential number 

within 
symbols in the same type group). */ 

uint8 t CMN compilerGetSymbol(const CMN Compiler *compiler, char typeChar 
uint32 t id, char SYmbOL[CMN STRING PSEUDOHASH. SIZE]); 


// privates: 
char |CMN numPseudohash(uint8 t n) 
n %= 64; 


if (n < 2) 
return ' '; 


if (n « 12) 
return n + 'Q' - 2; 


if (n < 38) 
return n+ 'a' - 12; 


return n + 'A' - 38; 


unsigned int _CMN_strLen(const char *s) 
unsigned int r = 0; 


while (s[r] != 0) 
r++; 


1 


return r; 


uint8_t _CMN_typeEnvBits(uint8_t typeEnv) 


typeEnv = typeEnv == 0 ? uint8_t) sizeof(CMN_NATIVE_UINT)) 
(typeEnv + (typeEnv == E 


f 


return typeEnv * 8; 


static inline uint8_t CMN_instrTypeEnv(const uint8_t *instruction) 


return instruction[1] >> 6; 


int32_t CMN unsignedToSigned32(uint32 t value, uint8 t bits) 


return (value & (0x00000001 << (bits - on ? A 
-1 ? (ss ((((-value) & (Oxfffff >> (32 - bits)))) + 1)) 
} ((int32_t) value); 


int CMN_unsignedToSignedNative(CMN_NATIVE_UINT value) 


CMN NATIVE UINT tmp = -1; 
tmp /- 2; 


if (value «- tmp) 
return value; 


value - PECCAN NATIVE UINT) -1) - value) * 1; 
return - ((int) value); 


#define _COMP switch (greater | (eq << 1)) (^ 
case 0: return v1 < v2; break; 
case 1: return v1 > v2; break;\ 
case 2: return v1 <= v2; break;N 
case 3: return v1 >= v2; break; \ 
default: return 0; break; } 


(tub pe tn SEHE v1, uint32 t v2, uint8 t greater, uint8 t eq) 


Tinto y aia ih v1, int32 t v2, uint8_t greater, uint8 t eq) 
. COMP 


#undef |COMP 


uint64_t _CMN_interpreterGetX(CMN_Interpreter *interpreter, uint8 t typeEnv) 
rad (typeEnv) 


case 0: return interpreter-»memoryO[interpreter-»pointers[0][0]]; break; 
case 1: return interpreter-»memory8[interpreter-»pointers[1][O break; 
case 2: return interpreter->memoryi6[interpreter ->pointers x break; 
case 3: return interpreter-»memory32[interpreter-»pointers[3][0]]; break; 
default: break; 

H 

return 0; 


void _CMN_interpreterGetXY(CMN_Interpreter *interpreter, uint8 t typeEnv, 
uint64 t *x, uint64 t *y 


t switch (typeEnv) 


#define _CASE(n,t,m) \ 
case n: {\ i ; 
t *p = interpreter->m + interpreter->pointers[n][0];\ 
*x = “py poc; *y = *p;\ 
break; 4 


— CASE(0, CMN. NATIVE UINT,memoryO) 
—CASE(1,uint8 t,memory8) 
.CASE(2,uinti6 t,memoryi6 

_CASE(3, uint32_t,memory32 


default: break; 
#undef _CASE 
H 


uint8 t _CMN_interpreterPopPush(CMN_Interpreter *interpreter, uint8 t typeEnv, 
int8 t pop, uint64 t r) 


interpreter->pointers[typeEnv][0] += -1 * pop + 1; 


if (interpreter->pointers[typeEnv][0] >= interpreter->memorySizes[typeEnv] ) 
return 0; 


pitch (typeEnv) 


case 0: interpreter->memoryO[interpreter->pointers[0][0]] = r; 
break; 
case 1: interpreter->memory8[interpreter->pointers[1][0]] = r % 256; 


break; 


ease Zi interpreter ->memoryi6[interpreter->pointers[2][0]] = r % 65536; 
reak; 


case 3: interpreter-»memory32[interpreter-»pointers[3][0]] 


r; 
break; 


default: break; 
return 1; 


void CMN_interpreterGoto(CMN_Interpreter *interpreter, uint32_t address) 


interpreter->currentInstruction = interpreter->bytecode + 
CMN_BYTECODE_HEADER_SIZE + 2 * address; 


uint32_t CMN_interpreterGetInstrAddress(const CMN Interpreter *interpreter) 


return Ante SER Roe Ins ERUCEJOR - interpreter->bytecode - 
} CMN_BYTECODE_HEADER_SIZE) / 2; 


void CMN interpreterCallFunction(CMN Interpreter *interpreter, 
uint32 t functionID) 


if Ginter preter:2callstacktop >= CMN_INTERPRETER_CALLSTACK_SIZE - 1) 
return; 


const uint8_t *instr = interpreter->bytecode + CMN_BYTECODE_HEADER_SIZE; 


while (*instr != CMN_OPCODE_END) 
Ü (instr[0] == CMN OPCODE DES && instr[1] == CMN DES FUNC) 
if (functionID == 0) 


interpreter->callstack[interpreter->callStackTop] = 
interpreter ->currentInstruction; 


interpreter->callStackTop++,; . 
interpreter-»currentInstruction = instr + 4; 


return; 


else ; 
functionID--; 


instr 4- 2; 
3 
H 
uint32 t _CMN_interpreterGetPtrAddr(CMN_Interpreter *interpreter, 
uint8 t typeEnv, uint32 t pointerIndex) 
return (pointerIndex «- CMN LAST SPECIAL PTR) ? 


interpreter->pointers[typeEnv][0] - pointerIndex 
: interpreter-»pointers[typeEnv]|pointerIndex - CMN LAST SPECIAL PTR]; 


uint32 t * CMN interpreterGetPtrForWrite(CMN Interpreter *interpreter, 
uint8 t typeEnv, uint32 t pointerIndex) 


uint8 t userPointer = pointerIndex > CMN LAST SPECIAL PTR; 


return (pointerIndex == 0 L userPointer) ? 
&(intérpreter-»pointers[ ypeEnv][pointerIndex - 
CMN LAST SPECIAL PTR userPointer]) : 0; 


uint8 t CMN interpreterPopN(CMN Interpreter *interpreter, uint8 t n, 
( const uint8 t *instr) 
uU (!(instr[1] & CMN MASK INSTR NOPOP)) 


uint8 t typeE - CMN instrTypeEnv(instr); 
uint32 t *ptrVal = &interpreter-»pointers[typeE][9]; 


*ptrVal -- n; 
if (*ptrVal >= interpreter->memorySizes[typeE] ) 
return 0; 


return 1; 


intak CMN interpreterStep(CMN Interpreter *interpreter, uint32_t steps) 


define INSTR interpreter-»currentInstruction 
#define _POP(n)\ 
if (!_CMN_inter reterPopn (interpreter t,—INSTR))\ 
return CMN_INTERPRETER_ERROR_STACK_OF; 


uint8_t infiniteSteps = steps == 0; 
uint8_t repeat = 0; // for skipping instructions that do nothing 


while (infiniteSteps || steps > © || repeat) 


repeat = 0; 
uint8 t opcode = _INSTR[0]; 


if (opcode > CMN_OPCODE_SPECIALS) 
T. ypical stack instructions 
uint8 t typeEnv - CMN instrTypeEnv( INSTR); 


uint8 t bitsX =  CMN typeEnvBits(typeEnv); 
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uint8 t bitsY - bitsX; 


uint8 t mode = - opcode & CMN MASK INSTR MODE; 
uinte. tx=0 y=0, r=0; 
uint8_ t opcodeGroup = opcode’ & CMN_MASK_INSTR_GROUP; 


int8_t pop = 
“INSTR 1] & CMN MASK INSTR NOPOP) ? © : 
(mode != CMN OPCODE 01) + (mode == CMN OPCODE 21)); 


if (mode !- CMN OPCODE 01) 
.CMN interpreterGetXY(interpreter,typeEnv, &x, &y) ; 


ii (mode == CMN OPCODE 1C1) 
y 
x 


y: 
CMN. instrGetConst( INSTR); 


if p ERREX T == 0) 


switch (opcodeGroup) 


case CMN_OPCODE_AD: 
case CMN_OPCODE_SU: 
case CMN OPCODE MU: 
case CMN OPCODE EQ: 
case CMN OPCODE NE: 
case CMN OPCODE BA: 
case CMN OPCODE BO: 
case CMN OPCODE BX: 
case CMN OPCODE LA: 
case CMN OPCODE LO: 
case CMN OPCODE LX: 


case CMN OPCODE GR: 
case CMN OPCODE GE: 
case CMN OPCODE SM: 
case CMN OPCODE SE: 
ig = E | compare(y,x, !(opcode & 0x08), (opcode & 0x04) != 0); 
reak; 


* x; break; 


in in in Bin Bin in in Bn in in i. 
Won n n ete 
PX< 

go 

x 

o 

Ri 

o 

m 

x 


y == 6) 1 (x == 0); break; 


case CMN_OPCODE_GS: 
case CMN_OPCODE_BS: 
case CMN_OPCODE_SS: 
case CMN_OPCODE_LS: 
r = CMN compar eSigned (CMN_ | unsignedToSigned32(y,bitsY), 
9) CMN unsignedToSigned32(x,bitsX), '(opcode & 0x08), (opcode & 0x04) 
; 
break; 


case CMN OPCODE DI: 
case CMN OPCODE DS: 
case CMN OPCODE MO: 
case CMN OPCODE MS: 
if (x == 6) 
réturn CMN INTERPRETER ERROR ZERODIV; 


if (opcodeGroup == CMN OPCODE DS || opcodeGroup == CMN OPCODE MS) 
re opcodecr onp == CMN OPCODE DS) ? 
LONN | unsignedToSi ned32(y, bitsY / 
CMN_unsignedToSigned32(x, bitsX 335 


(cm. hr der ned32(y, bitsY) 96 
CMN unsignedToSigned32(X,bitsX DA 


else // unsigned 
= (opcodeGroup == CMN OPCODE DI) ? (y / x) : (y % x); 


break; 


case (CMN OPCODE BNO & CMN MASK INSTR GROUP): 
r = ~x; 
break; 


case (CMN OPCODE ADR & CMN MASK INSTR GROUP): 
bos = interpreter- >pointers[typeEnv][0]; 
reak; 


case _(CMN_ OPCODE INU & CMN MASK INSTR GROUP): 
r = l!interpreter-»inputEndReached; 
break; 


case (CMN OPCODE INP & CMN MASK INSTR GROUP): 


inti6 t v = i i 
(interpreter - >inputEndReached | _interpreter->ioFunction == 0) 
0 : interpreter-»ioFunction ; 
if (v == -1) 
interpreter->inputEndReached = 1; 
r= 0; 
l 
else 
r=v; 
break; 


H 
default: break; 


if (! CMN interpreterPopPush(interpreter, typeEnv, pop, r)) 
return CMN INTERPRETER ERROR STACK OF; 


l 
else // non-typical instructions 
switch (opcode) 


case CMN OPCODE CAE: 
if (interpreter->externalCallFunction !- 0) 
interpreter ->externalCallFunction(CMN_instrGetConst(_INSTR), 
interpreter); 
else 
return CMN INTERPRETER ERROR BAD CALL; 


break; 


case CMN OPCODE POP: 
.POP(CMN instrGetConst( INSTR) + 1) 
break; 


case CMN OPCODE CON: 
if (! CMN _interpreterro Push(interpreter,CMN instrTypeEnv( INSTR), 
60,CMN instrGetConst( INSTR 
return CMN INTERPRETER ERROR STACK OF; 


_POP(1) 
break; 


case CMN_OPCODE_TRA: . 
if (! CMN interpreterPopPush(interpreter 
CMN instrGetConst( INSTR),i, 


_CMN_interpreterGetX(interpreter,CMN_instrTypeEnv(_INSTR) ))) 
return CMN_INTERPRETER_ERROR_STACK_OF; 


POP(1 
Br cake ) 


case CMN OPCODE CAL: 


if (interpreter->callStackTop >= CMN INTERPRETER CALLSTACK SIZE - 1) 


return CMN INTERPRETER ERROR CALLSTACK; 


interpreter- Sca tetack| intenpreter=>cattstackrop] = _INSTR; 
interpreter ->callStackTop++; 


CMN Interpretereoro (Inter preter, oHN-insEFGetCons b (- INSTR) - 1); 
reak; 


case CMN_OPCODE_RET: 
if (interpreter->callStackTop == 0) 
return CMN_INTERPRETER_ERROR_CALLSTACK; 


_INSTR = interpreter->callstack[interpreter->callStackTop - 1]; 
interpreter ->callStackTop--; 
break; 


case CMN_OPCODE_INI: 
for (uint8_t i = 0; i < interpreter->argc; ++i) 


const char *c = interpreter->argv[interpreter->argc - 1 - i]; 
const char *c2 = C; 


while (*c2 !- 0) 
c2t*; 


while (c2 >= c) 


interpreter- 2pointers[0][0]**: 
interpreter ->memoryO[interpreter->pointers[0][0]] = *c2; 
C2--; 
H 
} 


interpreter- zpointers[o alre] 
interpreter-»memoryO[in érpreter- »pointers[0][0]] = 
interpreter-»argc; 


break; 


} 


case CMN_OPCODE_JNA: 
case CMN_OPCODE_JIA: 


uint8 t typeEnv = CMN_instrTypeEnv(_INSTR) ; 


if (interpreter- »pointers[typeEnv] 8 = 
interpreter ->memorySizes ty eEnv 
return CMN INTERPRETER ERROR STA! ke OF; 


uint8 t stop = (! CMN interpreterGetX(interpreter 
typeEnv)) -- (opcode !- CMN OPCODE JNA); 


—POP(1); 
if (stop) 
break; 
// else'continue to JMA 


. attribute ((fallthrough)); 


E 


77 ^ gcc extension removing warning, can be removed in case of trouble 


case CMN OPCODE JMA: .. 
CMN interpreterGoto(interpreter,CMN instrGetConst( INSTR) - 1); 
break; 

case CMN OPCODE OUT: 
if (interpreter->ioFunction !- 0) 


inti16 t v = CMN interpreterGetX(interpreter 
CMN instrTypeEnv(. INSTR)); 


interpreter->ioFunction(v >= 0 ? v : 0); 


prortty: 
break; 


#define Geen oe 
if (typeEnv == 


ter; { CMN_NATIVE_| UNT t, = interpreter-»memoryO + interpreter-»pointers[0] 
(void)(t); cmd;}\ 
else if OY zt y\ 
{ uints_ *s = interpreter-»memory8 + interpreter->pointers[1][0];\ 


tvoray(t) cmd; EIN 
else if lO T gris zi 2)\ 
{ uint = SDCEEDEEEOR- >memoryi6 + interpreter->pointers[2][0];\ 
(oie tt); cmd; }\ 


Ü Dinta t t,*s- snterpretere >memory32 + interpreter->pointers[3][0];\ 
(void)(t); cmd;}\ 


case CMN OPCODE SWP: 


{ 
uint8 t typeEnv = CMN instrTypeEnv(. INSTR); 
int8 t shift = ( INSTR[1] & CMN MASK INSTR NOPOP) ? 2 : 6; 


.DOINST(t = *s; *(s + shift) = *(s - 2i ;*(s + shift - 1) = t;) 
pace preter >pointers[typeEnv] [0 += ift; 
reak; 


qase CMN_OPCODE_PCM: 
uint64_t c1, c2; 


uint8_t typeEnv = CMN_instrTypeEnv(_INSTR); 
CMN_instrGetConsts(_INSTR, &c1,&c2); 


ci = _CMN_interpreterGetPtrAddr(interpreter, typeEnv,c1 
c2 = _CMN_interpreterGetPtrAddr (interpreter, typeEnv, c2 
c1 = cl == c2? 0 : (1+ (C1 > c2)); 


interpreter ->pointers[typeEnv] [0]++; 
_DOINST(*s = c1;) 
break; 


} 
case CMN_OPCODE_CND: 
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uint8 t typeEnv - CMN instrTy ennyi INSTR) 
int8_t shift = 1 - ((Z INSTR] N | 


.DOINST(*(s + shift) = *(s - 2) ? *(s - 1) : *s) 
pocerpreters >pointers[typeEnv] 0] += shift; 
reak; 


} 


case CMN_OPCODE_PSC: 
ce CMN_OPCODE_PAC: 


uint64_t c1, c2; 


uint32_t *p 
CMN instrebtconsts(. INSTR, &c1, &c2) ; 


= _CMN_interpreterGetPtrForwrite(interpreter 
CMN_instrTypeEnv(_INSTR),c1); 


if mC) != 0) 
*p = (opcode == CMN OPCODE PSC) ? c2 : (*p + 
CMN unsignedToSigned32(c2,4) 


break; 


} 
çase CMN_OPCODE_PAX: 
uint32_t pointer = CMN_instrGetConst(_INSTR); 


uint32_t *p = _CMN_interpreterGetPtrForwrite(interpreter 


CMN instrTypeEnv(. INSTR), pointer); 
if (p != 0) 
uint8 t typeEnv - CMN instrTypeEnv( INSTR); 


*p += CMN unsignedToSigned32( CMN interpreterGetX(interpreter, 


typeEnv), CMN typeEnvBits(typeEnv)); 
nid ointer !- 0 
Eur 


break; 


} 
case CMN_OPCODE_PCO: 


uint64_t c1, c2; . 
uint8 t typeEnv' = CMN instrTypeEnv(. INSTR); 


CMN. instrGetConsts( INSTR, &c1,&c2); 


uint32 t *p = CMN interpreterGetPtrForWrite(interpreter,typeEnv,c1); 


if (p !- 


-0 
*p = CHI A terpFeteraetbckadar (interpreter typerny £377 


else 
return CMN INTERPRETER ERROR OPERATION; 


break; 


} 
case CMN. OPCODE MEX: 


uint8 t typeEnv = CMN instrTypeEnv(. INSTR 
Uinté4 t val, addr; YEGEN Gy L 


val = _CMN instrbettonet( INSTRVE eter typeEnv); 

addr = CMN_instrGetConst NSTR); 

addr = 

if (addr >= interpreter->memorySizes[typeEnv] ) 
return CMN_INTERPRETER_ERROR_MEMORY ; 


if (typeEnv == 0) 


interpreter->memoryO[addr] = val; 
else if (typeEnv == 1) 

interpreter->memory8[addr] = val; 
else if (typeEnv == 

Fa EGEDROEEN >memoryi16[addr] = val; 
else 

interpreter->memory32[addr] = val; 
_POP(1) 
break; 


} 


case CMN_OPCODE_MGE: 
ge CMN_OPCODE_PUX: 


uint8 t ,yBeEnv = CMN instrTypeEnv(. INSTR); 
uint32 t p; 


p = (opcode == CMN OPCODE MGE) ? 
CUN  interpreterGetPtrAddr( 
interpreter,typeEnv,CMN instrGetConst( INSTR)) 


(_CMN_interpreterGetPtrAddr (interpreter, typeEnv, 0) 
- _CMN_interpreterGetX(interpreter, typeEnv) ); 


if (opcode == CMN OPCODE MGE || (o STR] & CMN MASK INSTR NOPOP)) 


interpreter->pointers[typeEnv][0]++; 
if ut >= interpreter ->memor Sizes [typeEnv]) 
urn CMN_INTERPRETER_ERROR_STACK_OF; 


if (typeEnv == 0) 
interpreter ->memoryO[interpreter ->pointers[0][0]] 
interpreter-»memoryO[p]; 
else if (typeEnv -- 
interpre Pes >memory8[interpreter->pointers[1][0]] 
interpreters »memory8[p]; 
else if (typeEnv -- 2) 
interpreter-»memoryi6[interpreter-»pointers[2][0]] 
j interpreter-»memoryi6[p]; 
else 
interpreter ->memory32[interpreter->pointers[3][0]] 
interpreter ->memory32[p]; 


break; 


} 
#undef _DOINST 


case CMN OPCODE END: 
_INSTR 


-= 2; /* has to be here because even after end API can be used 
to call a function and that has to return here */ 


return CMN INTERPRETER END; break; 


Mask ÍNSTR |. NOPOP) ? O : 


_CMN. AREE REG CE CEEPEPATAK[ dntav preter: -CUBSERV adds 


} 


case CMN_OPCODE_ERR: return CMN_INTERPRETER_ERROR_THROW; break; 


case CMN_OPCODE_NOP: 
case CMN_OPCODE_DES: 
case CMN |_OPCODE_COC: 


presen S 
default: return CMN_INTERPRETER_ERROR_BC_OPCODE; break; 
} } 
_INSTR += 2; 


if (!repeat) 
{ 


steps--; 
interpreter- >steptt+; 


} 
} 
return CMN_INTERPRETER_OK; 


#undef POP 
#undef INSTR 


yona CMN instrGetConsts(const uint8 t *instr, uint64 t *c1, uint64_t *c2) 


} 


uint8_ t bits = CMN_instrGetConstBits(instr) / 2; 
*c1 = CMN | 'instráetConst(instr); 

*c2 = (*c1) >> bits; 

*c1 &- -(Oxffffffff' «« bits); 


fee CMN instrGetConst(const uint8_t *instr) 


} 


instr++; A 
uint64_t result = (*instr) & OxO0f; 
uint8_t shift = 0; 


while ((*instr) & CMN MASK INSTR CON) 
instr += 2; 


shift += 4; 
result |- ((uint64 t) ((*instr) & Ox0f)) << shift; 


return result; 


UP CMN instrGetConstBits(const uint8 t *instr) 


} 


instr++; 
uint8_t result = 4; 


while ((*instr) & CMN_MASK_INSTR_CON) 


instr += 2; 
result += 4; 


return result; 


uint8 t Dina ct Spies terInit(CMN Interpreter *interpreter 


const uint8 tecode, uint8 t *memory, uint32 t memorySize, 
uinti6 t mincell5, CMN IOFunction ioFunction, 

CMN | ExternalCallFunction externalCallFunction, 

uint8 t argc, const char **argv) 


interpreter->bytecode = bytecode; 

interpreter- >currentInstruction = bytecode + CMN_BYTECODE_HEADER_SIZE; 
interpreter->ioFunction = ioFunction; 

interpreter- >externalcallFunction = éxternalcallFunction; 
interpreter ->inputEndReached = 0; 

interpreter->callStackTop = 0; 

interpreter->step = 0; 

interpreter ->argc argc; 

interpreter->argv argv; 


uint8 t environments = 0x01; /* We make env 0 be always present, even if no 
instructions access i ecause it may be 
used by the programmer 'via API functions. */ 

uinti6 t maxPointers - 0; 

uint32 t ptrs[4]; . 

uinti6 t argLen = 1; // for pushing argc 


CMN. estimateMemory(bytecode,minCells,interpreter-»memorySizes,ptrs); 
if (argc > 0) // add space needed for arguments 
for (uint8 t i = 0; i < argc; ++i) 
const char *arg = argv[i]; 
argLent+; // terminating 0 
while (*arg != 0) 


argLent++; 
argt+; 


} } 


interpreter->memorySizes[0] += argLen; 
for (uint8_t i = 0; i < 4; ++i) 


if (interpreter->memorySizes[i] != 0 || ptrs[i] != 0) 
environments |= 0x01 << i; 


if (ptrs[i] > maxPointers) 
maxPointers ptrs[i]; 


uint8 t *pointerEnd - memory; 


interpreter ->memoryO 
interpreter ->memory8 
interpreter ->memory16 
interpreter ->memory32 


= 0; 
= 0; 
ô; 
0; 


for (uint8 t i = 0; i < 4; ++i) 
a (environments & (0x01 << 1)) 


interpreter->pointers[i] = (uint32_ t_*) pointerEnd; 
pointerEnd += sizeof(uint32_t) * maxPointers; 


#define _DO_SET(m,t)\ 


interpreter->m = (t *) pointerEnd;\ 
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ointerEnd += sizeof(t) * interpreter->memorySizes[i];\ prey = result; 
reak; iteralString++; 


switch (i) 


if (negative != 0) 
case 0: _DO_SET(memory0, CMN NATIVE UINT) * i zu i 
case 1: -DO SET(memory8, uint8 t) negative: =) isNegative; 
ase 2: DO SET(memo 16, nti6 t : 
ace a -DOLET memory32, uinti6- -H return !isNegative ? result : ((Oxffffffffffffffff - result) + 1) 
default: break; 
j eo CMN_identifyToken(const char *tokenString) 
#undef _DO_SET if (tokenstring[O] z-.'.' @@ tokenstring[1] == 0) 
else Sc if (fokenstr Edd && tokenString[1 o 
interpreter->pointers[i] = 0; e se ir onem End L aT == i okenString[1] == 0) 
: y Z else teknnti Ting [o == '?' && 
if ((pointerEnd - memory) » memorySize) teakenstrinart || tokenString[1] == '\'')) 
return 0; return CMN UN | BRANCH; 
else if (tokenString[0] == 'Q' && 
for (uint32_ t i = 0; i !- memorySize; ++i) (reokenstrieytay == I| 
memory[i] = 0; (tokenStrin == '\'' || tokenString[1] == 'Q') 
&& tokenString[2] == 0))) 
return 1; return CMN TOKEN LOOP; 
else if {tokenstring[e == '!' && tokenString[1] == '@' && 
tokenStrin 
turn CMN 9 Token BREAK; 
CMN_NATIVE_UINT CMN interpreterGetValue(CMN Interpreter *interpreter recurn Um 
uint8 t stackTopOffset) i H se if (tekenstring[g] ==!) 
return stackTopOffset <= interpreter->pointers[0][0] ? tokenString++; 
interpreter->memoryO[interpreter->pointers[O][0] - stackTopOffset] : 0; while (1) 
void CMN interpreterPush(CMN Interpreter *interpreter, CMN NATIVE UINT value) T OCCUR eM na LO ERROR: 
if (interpreter->pointers[0][0] >= interpreter-»memorySizes[0] - 1) else if (tokenString[0] == '"\) 


rotua, return (tokenString[1] == 0) ? CMN TOKEN STRING : CMN TOKEN ERROR; 
; 


interpreter ->pointers[0][0]++,; 
interpreter- smemory[ interpreter - >pointers[0][0]] = value; 


void CMN_interpreterPop(CMN_Interpreter *interpreter, uint8_t n) 


interpreter-»pointers[0][0] -= n <= interpreter->pointers[0][0] ? n : 0; 


void CMN_instrToStr(const uint8_t *instruction, char string[16]) 


static const char names[] = 
70 1 2 3 4 5 67 8 9 abede f 
/*0*/ "ENDNOPDESCOCERR CALCAERETJIAJNAJMA INI" 
/*1*/ "PSCPACPAXPCOMEXMGEPUXPCM CONCNDSWPTRAPOPOUT " 
/*2*/ "ADXADC SUXSUC MUXMUC DIXDICX 


/*3*/ "DSXDSC MOXMOC MSXMSC s 
/*4*/ "GRXGRC GEXGEC SMXSMC SEXSECX M 
/*5*/ "GSXGSC BSXBSC SSXSSC LSXLSCX » 
/*6*/ "EQXEQC NEXNEC BAXBAC BOXBOCX x 
/*T*/ "BXXBXC LAXLAC LOXLOC LXXLXCX " 
gy o" BNO " 
/*9 - e: empty */ 

VEU ADR INU INP"; 


uint16_t nameIndex = *instruction * 3 - (*instruction >= 0x90) * (6 * 3 * 
; 


string[0] - names[nameIndex]; 

string[1] - names[nameIndex +1 

string[2] = names[nameIndex + 2 

string[3] - JURE E & C Å RS a sae was 
string[4] = 


uint8_t env = instruction[1] >> 6; 


* 


env = env 8 + 8 * (env == 3); 
string[5 5] = '0' + env / 10; 
string[6] = '0' + env % 10; 
string eU 


for (uint8 t i - - 8i i < 4; ++i) 
string[8 + i] = '0' + ((instruction[1] & (0x08 >> i)) != 0); 


if (instruction[1] & CMN_MASK_INSTR_CON) 
string[12] = '.'; string[13] = '.'; string[14] = '.'; string[15] = 
else 

string[12] = 0; 
void CMN tokenizerInit(CMN Tokenizer *tokenizer) 


tokenizer->state =  CMN TOKENIZER BLANK; 
tokenizer->tokenStringPos = 0; 


uint64_t CMN literalValue(const char *literalString, uint8 t *negative, 
uint8_t *ok) 


uint64_t result = 0, prev = 0; 
uint8 t isNegative - = 0; 
uint8_t base = 10; 


if (ok != 0) 
*ok = 1; 


ral (*literalString == '+' || *literalString == '-') 


isNegative = *literalString == '-'; 
literalString++; 


H 
pum (*literalString) 


case 'x'; = 

ribota ((fektenrouah 9; // let fall through 
case 'd': litera Singer break 
case 'b': base = 2; li eralString++; break; 
default: break; 


, 


H 
while (*literalString !- 0) 
result *- base; 


if (ok F © && prev > result) // overflow? 
*ók = 0; 


result (* Heras rang >= '0' && *literalString <= '9') ? 
(* litera String - '0') (*literalString - 'a' + 10)); 
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tokenString-**; 
eut if Croker ened == '+' tokens T onto) == '-') && 
((tokenString[1] <= && tokMlstein [1] _>= ) 
( (tokenstring[1] <= ' && tokenstring[1] >= 'a') 
tokenStringt++; 


uint8_t base = 1; 

if (tokenstring[0] == 'd') 
tokenString**; 

lise if (tokenString[0] == 'x') 


base = 2; 
tokenString++; 


} 
else if (tokenstring[0] == 'b') 


base - 0; 
tokenString++; 


if (tokenString[O 
return CMN Tale d ER ERRO 
do 
uint8_t charClass = 0; 


if (ekeni angle >= 'a' && tokenString[0] <= 'f') 
charClass = 

else if (tokenstring[o] >= '0' && [o CTETUR] <= '9') 
charClass = tokenString[0] >= '2' 

else 
return CMN_TOKEN_ERROR; 


if (charClass > base) 
return CMN_TOKEN_ERROR; 


tokenString-**; 
} while (tokenString[0] != 0); 


return CMN_TOKEN_NUMBER; 
else if (tokenString[0] >= '0' && tokenString[0] <= '9') 


do 
if grokenstran 0] < 'O' || tokenstring[0] > '9') 
return CMN ireke '" ERROR; 
tokenString-**; 


} while (tokenstring[0] != 0); 
} return CMN_TOKEN_NUMBER; 
else if (tokenstring[0] == '-' && tokenString[1] == ':') 


return CMN_identifyToken(tokenString + 2) == CMN_TOKEN_NAME ? 
CMN_TOKEN_LABEL : CMN_TOKEN_ERROR; 


else 


uint8_t result = CMN_TOKEN_NAME; 


do 
{ 
if (tokenString[0] <= ' ' tokenstring[0] == '#' 
FAEUIR CMN Tale " ERROR; g[e] ) 
else if £ 
token tring[8 ORT tokenString[0] < '0') && 
tokenString zi EN tokenString[0] < 'a') && 
tokenstring MA. tokenstring[0] < 'A') && 
FokenSer ing $j 2 pick 
result = CE Ul dnstrino ] == ':' && tokenString[1] == 0) ? 
| T 


CMN. TOKEN. FUNC : CMN TOKEN COMMAND; 


tokenString**; 
} while (tokenstring[9] != 0); 


return result; 
return CMN TOKEN ERROR; 


uint8 t CMN tokenizerFeedChar(CMN Tokenizer *tokenizer, char character) 
uint8 t append - 0, token - 0; 


#define BLANK(x) Gu,zs ! ' || x, "Mn! [EN 
x == EN [px == CP Hox em CE Hx == 9) 


switch (tokenizer-»state) 


case |CMN TOKENIZER BLANK: 
if (character -- '"') 


tokenizer->state =  CMN TOKENIZER STR; 
append - 1; 


else if (character '#! 
tokenizer->state = _CMN_TOKENIZER_COMMENT; 
else if (! BLANK(character)) 


tokenizer->state =  CMN TOKENIZER NAME; 
append - 1; 


break; 


case | CMN TOKENIZER NAME: 
if ( BLANK(character)) 


tokenizer- >state 


_CMN_TOKENIZER_BLANK; 


token = 1; 
else if (character == '#') 
tokenizer->state = _CMN_TOKENIZER_COMMENT; 
token = 1; 
else 
append = 1; 
break; 


case _CMN_TOKENIZER_STR_END: 
if (character == '#' 
tokenizer- >state = _CMN_TOKENIZER_COMMENT; 
else if (_ BLANK(character D 
ie eendune >state = | CMN TOKENIZER BLANK; 
else 
tokenizer->state = CMN TOKENIZER ERROR; 


break; 
case |CMN TOKENIZER COMMENT: 


if (character == '#' || character == '\n' 
tokenizer->state = _CMN_TOKENIZER_BLANK; 


break; 
case _CMN_TOKENIZER_STR: 
append = 1; 
if (character == '"') 
tokenizer- >state = _CMN_TOKENIZER_STR_END; 
token = 1; 
break; 
default: 
break; 


if (append) 
if (tokenizer->tokenStringPos < CMN TOKEN MAX LENGTH - 1) 


tokenizer-»tokenString[tokenizer-»tokenStringPos] = character; 
tokenizer ->tokenStringPos++; 


else . 
tokenizer->state = CMN TOKENIZER ERROR; 


if (tokenizer->state == CMN TOKENIZER ERROR) 
return CMN TOKENIZER ERROR; 
else if (token) 


toco tokens inol tokenizer: >tokenStringPos] = 
tokenizer->tokenStringPos = 
return CMN_TOKENIZER_TOKEN; 


return CMN_TOKENIZER_NOTHING; 


n #undef | BLANK 


void CMN compilerInit(CMN | com iler *compiler, uint8_t *bytecode, 


uint32 t bytecodeMaxSize, ar *symbolTableMemory, uint32 t symbolTableSize, 


CMN FileIncludeFunction fne lüderuhction) 


CMN_tokenizerInit(&compiler ->tokenizer); 

compiler->bytecode = b tecode; 

compiler->bytecodeLimit = bytecode + bytecodeMaxSize; 
compiler->bytecodeEnd = bytecode + CMN BYTECODE | HEADÉR : SIZE; 
compiler->currentTypeEnv = 0; 

compiler- »implicitAddressSize = = 5; // reasonable magic constant 
compiler- >parseStackTop = 0; 

compiler->state = CMN í COMPILER_OK; 

compiler->symbolTable = symbolTab leMemory; 

compiler- >symbolTableSize = symbolTableSize / CMN STRING PSEUDOHASH SIZE; 
compiler-»s mbolCount = 0; 

compiler->flags = 0; 

compiler ->inc udeFunction = includeFunction; 


H 
uint8 t _CMN_constSegmentsNeeded(uint64_t c) 
uint8_t r = 1; 
while (1) 
c >>= 4; 


if (c == 0) 
break; 


DET? 


H 
return r; 

uint8 t * CMN compilerFillConsts(CMN Compiler *compiler, uint8 t *address, 
uint32 t c1, uint32 t c2) 


if (compiler !- © && compiler->state !- CMN COMPILER OK) 
return address; 


int8 t counti 
count2 


_CMN_constSegmentsNeeded(c1 
_CMN_constSegmentsNeeded(c2); 


if (count2 > count1) 
counti = count2; 


for (uint8_t i = 0; i < 2; ++i) 


count2 = count 
address[1 &- icum | MASK INSTR CON | OxOf); 


if (i != 0) 


if (address >= compiler->bytecodeLimit ) 


compiler->state = CMN COMPILER ERROR BYTECODE TOO BIG; 
return address; 


*address - CMN OPCODE COC; 
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*(address - 1) |= CMN MASK INSTR CON; 


while (1) 
{ 


H (compiler != © && address + 3 >= compiler->bytecodeLimit) 


compiler->state = CMN COMPILER ERROR BYTECODE TOO BIG; 
return address; 


} 


address++; 
*address {= c1 & 0x0000000f; 
address++; 
count2--; 


if (count2 <= 0) 
break; 


c1 >>= 4; 


*(address - 1) |= CMN_MASK_INSTR_CON; 
*address = CMN_OPCODE_COC; 
*(address + 1) = 0; 


return address; 


/** Fills constant to given bytecode address, potentially adding Coes depending 


on size of the constant, returns the address right after this. 


uint8 t * CMN compilerFillCconst(CMN Compiler *compiler, uint8 t *address, 


uint64 t con) 
if (compiler != © && compiler->state !- CMN COMPILER OK) 


hash[CMN STRING PSEUDOHASH SIZE - 3] - vlen; 
} 3 
int32_t CMN_compilerAddSymbol(CMN_Compiler *compiler 
char symbol[CMN STRING PSEUDOHASH SIZE]) 
int32 t index = CMN compilerFindSymbol(compiler, symbol); 


if (index »- 0) 
return index; 


if (compiler->symbolCount >= compiler->symbolTableSize) 


compiler->state = CMN_COMPILER_ERROR_SYMBOL_TABLE; 
return -1; 


index = 0; 
char *m = compiler->symbolTable; 
for (uint16_t i = 0; i < compiler->symbolCount; ++i) 


if (m[0] == symbol[0]) 
index++; 


m += CMN_STRING_PSEUDOHASH_SIZE; 

for (uint8 t i = 0; i < CMN STRING PSEUDOHASH SIZE; ++i) 
m[i] = symbol[i]; 

compiler->symbolCount++; 


return index; 


} 


return 0; 
á uint8 t CMN compilerGetSymbol(const CMN Compiler sitzen)" char typeChar 
address[1] &- -(CMN MASK INSTR CON | 0x6f); uint32 t id, char symbol[CMN STRING PSEUDOHASH SIZE]) 
int8 t count = | CMN constSegmentsNeeded(con); uint32 t index = 0: 
Li ; 
2e (1) while (index < compiler-»symbolCount) 
if (compiler !- © && address + 3 >= compiler->bytecodeLimit ) 


if (compiler->symbolTable[index * CMN STRING PSEUDOHASH SIZE] == typeChar) 
compiler->state = CMN COMPILER ERROR BYTECODE TOO BIG; 


return 0; if (id == 0) 
for boli]. i = 0; i < CMN STRING PSEUDOHASH SIZE; ++i) 
symbol[i] = 
S durs [s nah ph oeio: Sonne ler symbolTabte[index * CMN_STRING_PSEUDOHASH_SIZE + i]; 
= LÀ 
Ao eser, return 1; 
; 
if (count «- 0) 
break; } id--; 
con >>= 4; 
index++; 
*(address - i) bs CMN_MASK_INSTR_CON; 
*address = CMN_OPCODE_COC; 
*(address + 1) = 0; return 0; 
} H 
return address; int32 t CMN compilerFindFunction(const CMN Compiler *compiler 
( const char *funcName, uint8 t isExternal) 
void |CMN compilerParseStackPush(CMN Compiler *compiler, uint32 t addr) CHA needdohash (acExterhat’ > rer =. (el funcName;h}; 
if (compiler->parseStackTop >= CMN_PARSE_STACK_SIZE) } return CMN. compilerFindSymbol(compiler,h); 


ompiler->state = CMN COMPILER ERROR PARSE STACK; d : Z : 
return; F F T G = E ! int32 t CMN compilerFindSymbol(const CMN Compiler *compiler 
char symbol[CMN STRING PSEUDÓHASH SIZE]) 


compiler->parseStack[compiler->parseStackTop] = addr; const char *m =_compiler->symbolTable; 


compiler ->parseStackTop++; int32_t result = 0; 
for (uint32_t i = 0; i < compiler->symbolCount; ++i) 
if (symbol[0] == m[0]) 


uint8_t matches = 1; 


uint32_t _CMN_compilerPointerToAddr(const CMN Compiler *compiler, 
const uint8_t *ptr) 


return ((ptr - compiler->bytecode) - CMN_BYTECODE_HEADER_SIZE) / 2; 


for (uint8 t j_= 1; hi CMN STRING PSEUDOHASH SIZE; ++j) 

uint8 t * CMN compilerAddrToPointer(const CMN Compiler *compiler, if (symbol[3] != m[j]) 

uint32 t addr) matches = 0; 

return compiler->bytecode + CMN_BYTECODE_HEADER_SIZE + 2 * addr; } break; 

i if (matches) 
void CMN_pseudohash(char typeChar, const char *str x 

char NaSRECMN. STRING PSEUBOHASH’ STETS ' return result; 

hash[0] = typeChar; result++; 

uint8_t i = 0; H 


while (i « CMN STRING PSEUDOHASH SIZE - 1 && str[i] !- 0) m *- CMN STRING PSEUDOHASH SIZE; 


hash[i + 1] = str[i]; 
itt; return -1; 
H 
if (i « CMN STRING PSEUDOHASH SIZE - 1) 


while (i « CMN STRING PSEUDOHASH SIZE - 1) 


uint8 t * CMN compilerFindNthDes(CMN Compiler *compiler, uinti16 t n, uint8 t d) 
uint8 t *instr = compiler->bytecode + CMN BYTECODE HEADER SIZE; 


hash[i + 1] = 0; while (1) 
itt; 
} if (*instr == CMN OPCODE DES && ((*(instr + 1) & OxOf) == d)) 
else if (n == 0) 
i break; 
uint8 t vlen - 0; else 
uint8 t vsum - 0; ne 
uint8 t vmul - 0; H ! 
wi e (*str != 0) instr += 2; 
vlen++; 


vsum += *str; 

vmul *= (vmut erate Ep bes 
stre; 

H ý if (d == CMN_DES_FUNC) // with functions also skip the initial jump 


instr += 2; // skip the DES 


$ instr += 2; 
i 
; 


vsum = _CMN_numPseudohash(vsum 


vlen -EMN num ssudohasn [vsum 


vmu CMN_numPseudohash( vmul) ; while ((*instr == CMN OPCODE COC) || (*instr == CMN OPCODE NOP)) 
eua v instr += 2; 

hash[CMN STRING PSEUDOHASH SIZE - 1] - vmul; 

hash[CMN STRING PSEUDOHASH SIZE - 2] - vsum; 
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return instr; 


void |CMN decodePtrSizesFromSymbol(uint8 t STEPE uint32_t rptrindex, 
uint32_t *ptrSize, const char symbol[CMN ST NG PSEUDOHASH SI E]) 


t *typeEnv = symbol[1] - '0'; 


*ptrIndex = 

symbol[2] - '!' + (symbol[3] - '!') * 64 + (symbol[4] - '!') * 64 * 64; 
*ptrSize = 

symbol[5] - '!' + (symbol[6] - '!') * 64 + (symbol[7] - '!') * 64 * 64; 


void  CMN encodePtrSizeAsSymbol(uint8 t typeEnv, uint32 t ptrIndex, 
uint32 t ptrSize, char symbol|CMN STRING PSEUDOHASH SIZE]) 


char *c - symbol; 


'S'; Ctt; 

'Q' + typeEnv; c++; 

for (uint8_t i = 0; i < 3; ++i) 
*c = 'I' + ptrIndex % 64; 
*(c + 3) = '!' + ptrSize % 64; 
ptrlIndex /= 64; 
ptrSize /- 64; 
Ctt; 


} 

c += 3; 

while (c < symbol + CMN_STRING_PSEUDOHASH_SIZE) 
*c = 0; 


#define _TOK_STR (compiler->tokenizer.tokenString) 
#define BC END (compiler ->bytecodeEnd) 


void |CMN compilerAppendInstr(CMN Compiler *compiler, uint8 t opcode, 
uint8 t params) 


if ( BC END >= compiler->bytecodeLimit - 1) 
;Gompilerssstate = CMN COMPILER ERROR BYTÉECODE TOO BIG; 
eise 
* BC END - opcode; 
_BC_END++; 
* BC END = params; 
n _BC_END++; 
H 
#define |APPEND I(opcode,params) \ 
_CMN_compilerAppendinstr (compiler, opcode, params); 


#define TYPE ENV (compiler->currentTypeEnv) 


void  |CMN compilerHandleJump(CMN Compiler *compiler, 
char *token, uint8 t opcode, uint8 t des, char typeChari, char typeChar2) 


1 
char symbol[CMN STRING PSEUDOHASH SIZE]; 
CMN. pseudohash(typeChar1, token, symbol); 
int32 t index = CMN compilerFindSymbol(compiler, symbol); 
if (index >= 0) // destination (func. or label) already declared 
_APPEND_I(opcode, 0); 
_BC_END = | CMN, compilerFillConst(compiler, BC END - 2, 
_CMN_compilerPointerToAddr (compiler, 
} _CMN_compilerFindNthDes(compiler, index,des))); 
else // destination not declared yet, leave address resolution for later 
/* hack: we use the CMN MASK INSTR NOPOP bit to indicate the address 
has not yet been resolved so that we know it later * 
_APPEND_I(opcode, CMN_IPARAMS(0,1,0,0)); 
uint8_t *tmp = _BC_END - 2; 


symbol[0] = typeChar2; 
index = CMN_compilerAddSymbol(compiler, symbol); 


for (uints.t i = 0; i < compiler->implicitAddressSize - 1; ++i) 
_APPEND_I(CMN_OPCODE_NOP, 0) 


_CMN_compilerFillConst(compiler,tmp,index); // store the index 
H 
uint8 t CMN compilerFeedChar(CMN Compiler *compiler, char character) 


define  XCMN COMPILER FLAG INIT FUNC NEEDED 1 
#define |CMN COMPILER FLAG COMMANDS STARTED 2 


char symbol[CMN STRING PSEUDOHASH SIZE]; 


if (Compiler->state != CMN COMPILER OK) 
return compiler->state; 


switch (CMN_tokenizerFeedChar (&compiler->tokenizer, character) ) 
oe CMN_TOKENIZER_TOKEN: 
uint8 t token = CMN identifyToken(  TOK STR); 


if (!(compiler->flags & .CMN COMPILER FLAG COMMANDS STARTED) && 
compiler->parseStackTop == 0 && token != CMN TOKEN FUNC) 


// first top-level command found, reserve space for calling init func. 


for (uint8 t i = 0; i « compiler->implicitAddressSize; ++i) 
k —APPEND I(CMN OPCODE NOP,i == 0) // hack: use 1 in first NOP as a 
mar 


compiler->flags |= . CMN COMPILER FLAG COMMANDS STARTED; 


switch (token) 


case CMN TOKEN COMMAND: 
case CMN TOKEN BREAK: 
case CMN TOKEN. BRANCH: 


case CMN TOKEN LOOP: 


uint8 t noPop - 0; 
unsigned int len =  CMN strLen( TOK STR); 


i (_TOK_STR[len - 1] == '\'') 
len--; 
noPop = 1; 


_TOK_STR[ ten] = 0; 


#define _STR_ID(a,b,c)\ 
((((uint32_t) (6)) << 24) | (((uint32 t) (b)) << 16) | (a)) 


uint32 t SID = len > 3 ? 0 : STR ID( 
.TOK STR[9], 
len > 1 ? _TOK_STR[1] : 0 
len > 2 ? TOK STR[2] : 0); 


switch (sID) 


#define _SIMPLE_OP(c1,c2,c3,opcode,con) case _STR_ID(c1,c2,c3):\ 
—APPEND I(opcode,CMN IPARAMS( TYPE ENV,noPop,0,con)); break; 


SIMPLE OP('-*' 0, CMN_OPCODE_ADX, 0 


TSIMPLE_OP('-',0,0, CMN_OPCODE_SUX, 0 
"SIMPLE_OP('+'/'4+''@, CMN OPCODE ADC, 1 
LSIMPLE OP('-','-',0, CMN OPCODE SUC, 1 
SIMPLE OP('*", 0,0, CMN_OPCODE_MUX, 0 
LSIMPLE 0P 0,0 CMN_OPCODE_DIX, 0 
"SIMPLE_OP('%'; 0,0, CMN_OPCODE_MOX;, © 
“SIMPLE_OP('/','/',0, CMN_OPCODE_DSX, 0 
TSIMPLE_OP('%', '%'/ 0, | CMN OPCODE MSX, 0 
-EIMPLE-OP('2'/0,0/ "  CHN-OPCODE- POP, 6 
-SIMPLE OP('?','?',0, €CMN OPCODE CND, O 
CSIMPLE OP( '&', 0,0, CMN_OPCODE_BAX, 0 
“SIMPLE_OP('|', 0,0, CMN_OPCODE_BOX, 0 
CSIMPLE OP('|', '1',0, CMN_OPCODE_BXx, 0 
LSIMPLE OP('&','&',0, CMN OPCODE LAX, 0 
CSIMPLE OP('|','|',0, CMN OPCODE LOX, 0 
CSIMPLE OP( ' |; ' 1 '; ' 1 ' , CMN-OPCODE LXX, 0 
SIMPLE OP('1';'1',0, 'CMN OPCODE EQC, O 
CSIMPLE 0P( '!',0,0 CMN_OPCODE_BNO, 0 
-SIMPLE OP('«','5',0, CMN OPCODE INU, 0 
-EIMPLE-OP('-1/ 21/0.  CMN-OPCODE-QUT,6 
-SIMPLE OP('$','$',0, CMN_OPCODE_ADR, 0 

SIMPLE OP('-',0,0 CMN_OPCODE_EQX, 0 

SIMPLE OP('!','2',0, CMN OPCODE NEX, 0 

SIMPLE 0P('«',0,0 CMN-OPCODE SMX, 0 


- ,9,9, 
- PIEST Kl 

-SIMPLE OP('«','-',0, CMN OPCODE SEX,O 
LSIMPLE 0P('»',0,0, CMN OPCODE GRX, 0 
“SIMPLE_OP('>', '=',@, CMN_OPCODE_GEX,0 
- i a 
z 1 a 
- f E 
- ' M 


SIMPLE OP('«','«',0 CMN_OPCODE_SSX, 0 


SEWPLe-Bpt'S!"'S!9, EAM BoeBbe ES 0 
va > > M 
SIMPLE_OP('>', '>', '£', CMN_OPCODE_BSX, 0 
#undef SIMPLE OP 

case STR ID('-','0',0): TYPE ENV = 0; break; 

case STR ID('-','8',0): TYPE ENV = 1; break; 

case STR ID('-','1','6'): _TYPE_ENV = 2; break; 

case STR ID('-','3','2'): _TYPE_ENV = 3; break; 

case STR ID('»','0',0): 

case STR ID('»','8',0): 

case STR ID('»','1','6!): 

d —STR_ID('>', '3','2'): 
uint8 t env = ( TOK STR[1] > '1') + 2 * ( TOK STR[2] != 0); 
if (!noPop || env !- TYPE ENV) // otherwise has no effect 

-ÀPPEND I(CMN OPCODE TRA, CMN IPARAMS( TYPE, ENV, noPop, 0, env) ) 

break; 


case SP TR ID( 95, A is 
_CMN_compilerParseStackPush(compiler 
poen; compa ter pointer roaddr (compi ler, -BC ENDO) i 
—APPEND I(CMN OPCODE DES, CMN IPARAMS(0,0,0, CMN DES LOOP)) 
_APPEND_I(CMN_OPCODE_NOP, 0) 
break; 


case STR ID('!','.',0): 


LAPPEND 1(CMN. OPCODE' DES, CMN. IPARAMS(0, 0, 0, CMN. DES EXIT)) 
TAPPEND_I(CMN_OPCODE_JMA, 8) 


for (uint8 t i = 0; i « compiler->implicitAddressSize - 1; ++i) 
_APPEND_I(CMN_OPCODE_NOP, 0) 


break; 
case _STR_ID('-','-','>'): // --» 
if (noPop) 
compiler->state = CMN_COMPILER_ERROR_BAD_TOKEN; 


return compiler->state; 


const char *cmd =" Q' -> . A"; 
while (*cmd != 0) 


Ir XCHN- compl ter Feedchar, (compa ter; cmd) != CMN_COMPILER_OK) 
reak; 


cmd++; 


break; 


} 


case _STR_ID('@',0,0): 
case STR ID('?',0,0): 
case STR ID T : 
_CMN_compilerParseStackPush(compiler 
_CMN_compilerPointerToAddr (compiler, BC END)); 


Hyg 


-APPEND I(CMN OPCODE DES CMN_IPARAMS(0, 0,0, 
.TOK STR[0] == 'Q' ? CMN DES LOOP : 
(LTOK STR[O] == '?' ? CMN DES IF : CMN DES LOOP BREAK))) 
if (pT STRON I= Cat) 
2s PPEND. I(CMN OPCODE'JNA, CMN IPARAMS(. TYPE ENV, noPop, 0,0) ) 
eise 
~APPEND_I(CMN_OPCODE_JMA, 0) 
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for (uint8 t i = 0; i « compiler->implicitAddressSize - 1; ++i) 
_APPEND_I(CMN_OPCODE_NOP, 0) 


break; 


default: 
a (_TOK_STR[0] == '$') 


if (_TOK_STR[1] == 0) 
zAPPEND. I(CMN OPCODE. PUX, CMN. IPARAMS(. TYPE. ENV, noPop, ©, 0) ); 
reak; 


uint8 t opc - CMN OPCODE MGE; 
TOK ST| A 


char *s1 = _ Rok; 

char *s2 = 0; 

it (_TOK_STR[1] == '>' || _TOK_STR[1] == '<') 
opc = CMN_OPCODE_PAC; 

} sitt; 

else if ( TOK STR[1] == ':') 
opc - CMN OPCODE MEX; 

n sitt; 

else if ( TOK STR[1] == '+') 
opc = CMN OPCODE PAX; 

} sitt; 

else 


char *s3 = TOK STR + 2; 
while (*s3 !- 0) 


if (*s3 == '»' || *s3 == '=') 
== '>' ? CMN OPCODE PCO : CMN OPCODE PCM; 
is 
STR + 1; 


H 
H 
int32 t pointeri, pointer2; 
int32 t *p = &pointer1; 
for (uint8 t i = 0; i < 2; ++i) 


CMN pseudohash('O' + TYPE ENV, s1, symbol); 


i si[1] == © && s1[0] >= 'O' && s1[0] <= '9' 
af BR 1-0 [0] [0] ) 
else 


*p = CMN compilerFindSymbol(compiler, symbol); 


if (*p >= 0) 
} *p += CMN_LAST_SPECIAL_PTR + 1; 


if (*p < 0) 


compiler->state = CMN_COMPILER_ERROR_UNKNOWN_NAME; 
break; 


if (s2 == 0) 
break; 


sl = s2; 
} p = &pointer2; 


_APPEND_I(opc, CMN_IPARAMS(_TYPE_ENV, noPop, 0, 0)); 


if (opc == CMN_OPCODE_PAC) 
_BC_END = -CMN compà LerFillconsts (compiler, .BC_END - 2, 
pointeri, _TOK_STR[1] == '>' ? 0x01 : OxOf); 
else if (opc == CMN_OPCODE_PCO opc == CMN_OPCODE_PCM 
BC END = CMN compilerFillConsts(compiler, BC END - 2, 
pointeri,pointer2); 
else 
.BC END = |.CMN compilerFillConst(compiler, BC END - 2, 
pointer1); 


due if ( TOK STR[0] == '~') 
if ( TOK STR[1] == '"') 
.TOK STR[len - 1] = 0; // remove the final '"' 


if (comp Lene ane UG EEUnCEiOn E 2) 
LE er-»includeFunction( TOK STR + 2); 
eise 


.TOK STR[len - 1] = '"'; 
compiler->state = CMN_COMPILER_ERROR_UNSUPPORTED; 
return compiler->state; 


else 

{ // pointer. 
uint32 t size - 1; 
char *separator =  TOK STR; 


while (*separator != 0 && *separator !- ':') 
separatort+t+; 
if (*separator == ':') 


*separator = 0; 

if (CMN_identifyToken(separator + 1) != CMN_TOKEN_NUMBER) 
compiler->state = CMN COMPILER ERROR BAD TOKEN; 
return compiler-»state; 


size = CMN_literalValue(separator + 1,0,0); 


if (CMN_identifyToken(_TOK_STR + 1) != CMN_TOKEN_NAME) 
compiler->state = CMN_COMPILER_ERROR_BAD_TOKEN; 


return compiler->state; 
CMN pseudohash('0' + compiler->currentTypeEnv, 

_TOK_STR + 1,symbol); 
uint32_t id = CMN_compilerAddSymbol(compiler, symbol); 
if (size != 0) 

/* © sized pointers don't need initialization, they aren't 
Supposed to point to allocated memory */ 
compiler->flags |= _CMN_COMPILER_FLAG_INIT_FUNC_NEEDED; 


_CMN_encodePtrSizeAsSymbol(_TYPE_ENV, id, size, symbol); 
CMN_compilerAddSymbol(compiler, symbol); 


l 
élse if ( TOK STR[9] == '>') 
{ // goto | f 
7 (GMN. identifyToken(. TOK STR + 1) == CMN TOKEN NAME) 
-APPEND I(CMN OPCODE. DES, CMN, DES. GOTO) 


.CMN compilerHandleJump(compiler, TOK STR + 1,CMN OPCODE JMA, 
CMN DES LABEL, 'l','j'); 


else 
compiler->state = CMN COMPILER ERROR BAD TOKEN; 
return compiler-»state; 


else 
compiler->state = CMN COMPILER ERROR BAD TOKEN; 


break; 


} 
#undef _STR_ID 


break; 
3 // case COMMAND, BREAK, BRANCH, LOOP 


ad CMN. TOKEN. NAME : 


_CMN_compilerHandleJump(compiler, TOK STR,CMN OPCODE CAL,CMN DES FUNC, 
ftc); 
break; 


case CMN TOKEN LABEL: 
CMN  pseudohash('l', TOK STR + 2,symbol); 


if (CMN compilerFindSymbol(compiler,symbol) »- 0) 


compiler->state = CMN COMPILER ERROR REDEFINED; 
return compiler->state; 


} 


Chin compd Ler Addsymbol (compiler symbol) 
t ASPEND T(CHN OPCODE DES, CMN IPARAMS(Ó,0,0,CMN DES LABEL)) 
reak; 


case CMN TOKEN FUNC: 
uint8 t p = 0; 
while (compiler->tokenizer.tokenString[p] != 0) 
if (compiler->tokenizer.tokenString[p] == ':') 
paap ere ere = 0; 
j ptt; 
CMN. pseudohash( 'f', compiler->tokenizer.tokenString, symbol); 
if (CMN compilerFindSymbol(compiler,symbol) »- 0) 
compiler->state = CMN COMPILER ERROR REDEFINED; 
break; 


CMN. compilerAddSymbol(compiler,symbol); 
if (compiler->parseStackTop !- 0) 
// function def. must appear always on top level 


gompiiskcastate = CMN COMPILER ERROR UNEXPECTED TOKEN; 
reak; 


_CMN_compilerParseStackPush(compiler 
_CMN_compilerPointerToAddr (compiler, BC END)); 


_APPEND_I(CMN_OPCODE_DES, CMN. IPARAMS(0, 0, 0, CMN_DES_FUNC) ) 
TAPPEND_I(CMN_OPCODE_JMA, 8) 


for (uints-t i = 0; i < compiler->implicitAddressSize - 1; ++i) 
_APPEND_I(CMN_OPCODE_NOP, 0 


break; 
H 
case CMN TOKEN NUMBER: 
_APPEND_I(CMN_OPCODE_CON, CMN_IPARAMS(_TYPE_ENV,1,0,0)); 


uint8_t negative, ok; 
uint64 t v = CMN_literalValue(_TOK_STR, &negative, &ok); 


if (!ok) 
t [0] 


compiler->state = CMN_COMPILER_ERROR_UNSUPPORTED; 
return compiler->state; 


H 
if (compiler->currentTypeEnv == 1 
yee Oxtt; i ) 
else if (compiler->currentTypeEnv == 2) 
v &- Oxffff; 
if (compiler->currentTypeEnv == 0 && negative) 


/* In type env © we don't know the bit width so we push negative 
literals by pushing © and subtracting constant with SUC. * 


89 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Comun 


.BC END = CMN compilerFillConst(compiler, BC END - 2,0); 
V = Oxffffffffffffffff - v + 1; 

—APPEND I(CMN OPCODE. SUC, CMN. IPARAMS(O 9,0,9)i 
-BC END = CMN compilerFillConst(compiler, BC ÉND - 2,v); 


else 
.BC END = .CMN compilerFillConst(compiler, BC END - 2,v); 


break; 


oe CMN_TOKEN_STRING: 
const char *c = _TOK_STR + 1; 


while (*c f= 0 && *c != 11) 
Ctt; 


c--; 
while (c > _TOK_STR && compiler->state == CMN_COMPILER_OK) 


_APPEND_I(CMN_OPCODE_CON, CMN_IPARAMS(_TYPE_ENV,1,0,0)); 
.BC END = _CMN_compilerFillConst(compiler,_BC_END - 2,*c); 


c--; 
H 


break; 


} 


case CMN_TOKEN_ELSE: 
a CMN. TOKEN. END: 


uint32 t parseStackTopOld = compiler->parseStackTop; 
uint8_t *matchingInstr = 0; 
uint8_t instrType; 


// find matching instr., skip possible loop breaks on stack: 
while (1) 


if (compiler->parseStackTop == 0) 


compiler->state = CMN COMPILER ERROR UNEXPECTED TOKEN; 
matchingInstr - 0; 
break; 


compiler-»parseStackTop--; 


matchingInstr = _CMN_compilerAddrToPointer(compiler, 
compi ér-sparséStack compiler -»parseStackTop]); 


instrType = (*(matchingInstr + 1)) & OxOf; 


if (instrType !- CMN DES LOOP BREAK) 
break; 


F 


} 


if (matchingInstr == 0) 
break; 


switch (instrType) 
ae CMN_DES_LOOP: 
if (token != CMN_TOKEN_END) 


// "else" matched a loop start: error 
compiler->state = CMN_COMPILER_ERROR_UNEXPECTED_TOKEN; 
return compiler->state; 


_APPEND_I(CMN_OPCODE_DES, CMN_IPARAMS(@, 0, ©, CMN_DES_LOOP_END)); 
TAPPEND_I(CMN_OPCODE_JMA, 0) ; 


.BC END =  CMN compilerFillConst(compiler, BC END - 2, 
_CMN_compilerPointerToAddr(compiler,matchingInstr) + 1); 


uint32_t addrHere = 
_CMN_compilerPointerToAddr (compiler, BC END); 


// for non-infinite loop fill back the jump address: 
if (i (matchingInstr + 2) IB CH OPCODE NOP) 
.CMN compilerFillConst(compiler,matchinginstr + 2,addrHere); 
// also fill in addresses for all loop breaks: 
while (1) 


parseStackTopOld--; 


if (parseStackTopOld == compiler->parseStackTop) 
break; 


.CMN compilerFillConst(compiler 
_CMN_compilerAddrToPointer (compiler 
compiler ->parseStack[parseStackTopOld]) + 2, 
addrHere); 


break; 


case CMN_DES_ELSE: 
if (token == CMN_TOKEN_ELSE) 


// else matching another else: error 
compiler->state = CMN_COMPILER_ERROR_UNEXPECTED_TOKEN; 
return compiler->state; 


// else continue on 
. attribute ((fallthrough)); 


case CMN DES IF: 
a (token == CMN_TOKEN_ELSE) 


// here we just replace the if with else on stack: 

compiler ->parseStack[compiler->parseStackTop] = 
oun compi lerPointerToAddr (compiler, BC_END); 

compiler->parseStackTop = parseStackTopOld; 


—APPEND I(CMN OPCODE DES, CMN IPARAMS(0,0,0,CMN DES ELSE)); 
—APPEND I(CMN OPCODE JMA, 0); 


for (uint8 t i = 0; i « compiler->implicitAddressSize - 1; ++i) 


n _APPEND_I(CMN_OPCODE_NOP, ©) 
else 
_APPEND_I(CMN_OPCODE_DES, CMN_IPARAMS(0,0,0,CMN_DES_IF_END)); 


// now pop the if while keeping possible loop breaks above 


‘pee (compiler->parseStackTop < parseStackTopOld - 1) 
compiler barsestack[compi Ler sparsestarkTop] = 
compiler ->parseStack[compiler->parseStackTop + 1]; 
compiler ->parseStackTop++; 
3 


Cun compi lerrillconst (compiler, marchin Instr + 2 
_CMN_compilerPointerToAddr (compiler, BC END + 1)); 


break; 

case CMN_DES_FUNC: 
compiler- -parseStatkTop = 0; 
_APPEND_I(CMN_OPCODE_RET, 0); 


sUn pompi lerFillconst(compiter,matchin Instr + 2, 
.CMN compilerPointerToAddr(compiler, BC END)); 


break; 
default: // unknown description, shouldn't happen 
compiler->state = CMN COMPILER ERROR GENERIC; 


return compiler-»state; 
break; 


break; 


default: 
compiler->state = CMN COMPILER ERROR BAD TOKEN; break; 
return compiler-»state; 
break; 


break; 


case CMN TOKENIZER ERROR: 
compiler->state = CMN COMPILER ERROR BAD TOKEN; 
return compiler-»state; 
break; 
default: break; 
if (compiler->state != CMN COMPILER OK) 
return compiler-»state; 
if (character -- 0) // end of source code -» append epilogue code 
if (compiler->parseStackTop !- 0) 
compiler->state = CMN COMPILER ERROR UNEXPECTED END; 
return compiler-»state; 
uint8 t *initFunc - 0; 
if (compiler->flags &  CMN COMPILER FLAG INIT FUNC NEEDED) 
// create the init function to set the initial pointer addresses 
-APPEND I(CMN OPCODE DES,CMN IPARAMS(0,0,0,CMN DES FUNC)) 
initFunc - BC END; 
—APPEND I(CMN OPCODE JMA,0) 


for sainte t i = 0; i < compiler->implicitAddressSize - 1; ++i) 
_APPEND_I(CMN_OPCODE_NOP, 0) 


const char *symbolItem = compiler->symbolTable; 
uint32_t memoryEnds[4]; 


for (uint8 t i = 0; i < 4; ++i) 
memoryEnds[i] = 6; 


for (uint32_t i = 0; i < compiler->symbolCount; ++i) 
a (symbolItem[0] == 's') 


uint8_t env; i 
uint32_t ptrIndex, ptrSize; 


_CMN_decodePtrSizesFromSymbol(&env, &ptriIndex, &ptrSize, symbolItem); 
if (ptrSize != 0) 
ptrliIndex += CMN LAST SPECIAL PTR + 1; // user pointers start here 
_APPEND_I(CMN_OPCODE_PSC, CMN_IPARAMS(env, 0,0 


9) 
.BC END = CONN o Coni TerEiT d Ont e (come! vee’ Be END - 2, 
ptrindex,memoryEnds[env]); 


} memoryEnds[env] += ptrSize; 

symbolItem += CMN_STRING_PSEUDOHASH_SIZE; 
if (compiler->state != CMN_COMPILER_OK) 

return compiler->state; 


for (uint8_t i = 0; i < 4; ++i) // and potentially init stack tops 
if (memoryEnds[i] != 0) 


_APPEND_I(CMN_OPCODE_PSC, CMN_IPARAMS(i,0,0,0)) 
.BC END = | CMN, compilerFillConsts(compiler, BC END - 2,0, 
memoryEnds[i]); 


_APPEND_I(CMN_OPCODE_INI, 0 
_APPEND_I(CMN_OPCODE_RET, 0 


_CMN_compilerFillConst(compiler, initFunc, 
_CMN_compilerPointerToAddr (compiler, BC END)); 


if (compiler->state != CMN_COMPILER_OK) 
return compiler->state; 


uint8_t *instr = compiler->bytecode + CMN BYTECODE HEADER SIZE; 
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while (*instr !- CMN OPCODE END) // fill back the init function call 
if (*instr == CMN OPCODE NOP && *(instr + 1) == 1) 
*(instr + 1) = 
if (initFunc != 0) 
*instr = CMN_OPCODE_CAL; 
_CMN_compilerFillConst(compiler, instr, 
_CMN | compilerPointertoAddr (com iler, 
initFunc + 2 * compiler->imp icitAddressSize)); 


else 
*instr = CMN_OPCODE_INI; 


break; 


} 


instr += 2; 


_APPEND_I(CMN_OPCODE_END,@); // append the final end 
if (compiler->state == CMN_COMPILER_OK) 


// do a forward pass and fill the unknown fun. call/goto addresses: 


instr = compiler->bytecode + CMN_BYTECODE_HEADER_SIZE; 


while (*instr != CMN_OPCODE_END) 


if ( *instr == CMN OPCODE CAL || *instr == CMN OPCODE JMA) && 
instr + 1) & CMN MASK INSTR NOPOP)) 


uint8 t funcCall.- *instr -- CMN OPCODE CAL; 
int32 t c - CMN | instrGetConst(instr); 


*(instr + 1) &- -CMN MASK INSTR NOPOP; 
CMN compilerGetSymbol(compiler,funcCall ? 'c' : 'j',c,symbol); 
symbol[0] = funcCall ? 'f' : 'l'; 
c = CMN compilerFindSymbol(compiler,symbol); 
if (c >= 0) 
*(instr + 1) = 
for (uint8 t i = 1; i « compiler->implicitAddressSize; ++i) 
saner + 2 * i) = CMN_OPCODE_NOP; 


instr 4 2*i-*41)-7290; 


_CMN c ompilerrilteonst(compiler, ,instr, 
_CMN_compilerPointerToAddr (compiler 
_CMN_compilerFindNthDes(compiler,c 
funcCall ? CMN DES FUNC : CMN DES LABEL))); 
else 
if (funcCall) 
*instr - CMN OPCODE CAE; 
ce 
// undefined label 
compiler->state = CMN_COMPILER_ERROR_UNKNOWN_NAME; 
} return compiler->state; 
H 
H 


instr += 2; 
3 // while Tiesaive addresses) 


instr = compiler->bytecode + CMN BYTECODE HEADER SIZE; 
// now do a forward pass again and order external calls from 0: 
uinti16 t nextIndex = 0; 
while (*instr !- CMN OPCODE END) 
if (*instr -- CMN OPCODE CAE) 
uint32 t c - CMN instrGetConst(instr); 
if (c » nextIndex) 
uint8 t *instr2 - instr; 
while (*instr2 !- CMN OPCODE END) 
if (*instr2 -- CMN OPCODE CAE) 
uint32 t c2 - CMN instrGetConst(instr2); 


*(instr2 + 1) = 
for (uint8_t i 


*(instr2 + 2 * i) = CMN yas NOP; 
*(instr2 + 2 i-1)- 


* 


} _CMN_compilerFillConst(compiler, instr2,nextIndex); 
F 


instr2 4- 2; 


nextIndex++; 


else if (c == nextIndex) 
nextIndex = c + 1; 


instr += 2; 


if (compiler->state != CMN_COMPILER_OK) 
return compiler->state; 


// now do a backwards pass and fill in the exit comm. addresses: 


1; i < compiler->implicitAddressSize; ++i) 


uint32_t funcendaddr = 0; 
uint32_t endAddr = _CMN | CompilerPointerToAddr (compiler, BC | END) - 


prite (instr >= compiler->bytecode + CMN_BYTECODE_HEADER_SIZE) 


if (instr[0] == CMN_OPCODE_RET) 
funcEnd dr = CMN compilerPointerToAddr (compiler, instr); 
else if (instr[0] -- CMN OPCODE DES) 


if (instr[1] == CMN DES FUNC) 
funcEndAddr 0; 
else if (instr[1] == CMN_DES EXIT) 
_CMN_compilerFillConst(compiler,instr + 2, 
funcEndAddr != 6 ? füncEndAddr : endAddr ) ; 


} 


instr -= 2; 


} 


if (compiler->state != CMN_COMPILER_OK) 
return compiler->state; 


// now mark external calls also in the symbol table: 
for (uint32_t i = 0; i < compiler->symbolCount; ++i) 
char *s = compiler->symbolTable + i * CMN_STRING_PSEUDOHASH_SIZE; 
if (s[0] == 'c') 
char s2[CMN_STRING_PSEUDOHASH_SIZE]; 
s2[0] = 'f'; 


for fyinta t Y = 1; j < CMN_STRING_PSEUDOHASH_SIZE; ++j) 
s2[j] = s[j]; 


H CMN. |.compilerFindSymbol(compiler, s2) «0 
s[0] = 'e'; // no corresponding we Symbol -» external call 


H 
H 
// fill the header: 


"Ie 
; 


compiler-»bytecode[0 
compiler ->bytecode[1 


for (uint8_t i = 2; i < 8; ++i) 
compiler- Sbytecode[i] = 0; 


com N-bytecodechecksun( BYTECODE_CHECKSUM_BYTE] = 
CMN_bytecodeChecksum(compi ler ->bytecode) ; 
} // if (compiler ok) 
74 F (character == 0) 


return compiler->state; 


#undef _TYPE_ENV 
#undef _TOK_STR 
#undef |APPEND I 
#undef BC END 


#undef |CMN COMPILER FLAG INIT FUNC NEEDED 
oe _CMN_COMPILER_FLAG_COMMANDS_STARTED 


uint8_t CMN_instrTouchesMem(uint8_t opcode) 
return opcode > CMN_OPCODE_RET && opcode != CMN_OPCODE_PCO && 


opcode !- CMN OPCODE PAC && opcode != CMN OPCODE PSC && 
opcode !- CMN OPCODE JMA; 


uint8 t CMN instrTouchesPtr(uint8 t opcode) 
return (opcode »- CMN OPCODE PSC && opcode «- CMN OPCODE PUX); 


void CMN estimateMemor M uint8 t *bytecode, uint32 t minStackSize, 
uint32 t memoryce lis] uint32 t poin ers[4]) 


if (minStackSize < CMN_MINIMUM_STACK_SIZE) 
minStackSize = CMN MINIMUM STACK SIZE; 


uinti6 t stackTops[4]; 
bytecode += CMN BYTECODE HEADER SIZE; 
for (uint8 t i = 0; i < 4; ++i) 


memoryCe ts[i] = 
pointers[i] = 
stackTops[i] = rb: 


while (*bytecode != CMN_OPCODE_END) 


uint8 t typeEnv = CMN instrTypeEnv(bytecode); 
if (CMN instrTouchesMem(*bytecode)) 
memoryCells[typeEnv]-*-*; 


if (*bytecode == CMN OPCODE TRA) 
memoryCells[CMN instrGetConst(bytecode)]-*-*; 


else if (*bytecode -- CMN OPCODE PSC) 
uint64 t c1, c2; 
CMN instrGetConsts(bytecode, &c1, &c2) ; 
if (c2 » stackTops[typeEnv]) 
stackTops[typeEnv] = c2; 


int64_t pIndex = -1, pIndex2 = -1; 


if ( // pointer in C1 
*bytecode == CMN_OPCODE_PSC || *bytecode == CMN_OPCODE_PAC) 


CMN_instrGetConsts(bytecode, (uint64_t *) &pIndex,(uint64 t *) &pIndex2); 


else if ( // pointer in C 
*bytecode == CMN OPCODE PAX || *bytecode == CMN OPCODE MEX || 
*bytecode -- CMN OPCODE MGE) 


{ 
pIndex = CMN_instrGetConst (bytecode); 


else if ( // pointer in C1 and C2 
*bytecode -- CMN OPCODE PCO) 
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CMN instrGetConsts(bytecode,(uint64 t *) &pIndex,(uint64 t *) &pIndex2); } 
else if (instr [9] == CMN_OPCODE_PAC && (instr[1] & CMN_MASK_INSTR_CON) && 
if (pIndex2 > pIndex) ! (instr [3 N. MASK INSTR CON)) 


pindex = pIndex2; if ((instr[1] & OxOf) != 0) // "PAC 1 to 15" does nothing 


if (pIndex > CMN_LAST_SPECIAL_PTR) instr ST E GIN -OPCODEGNOP; 
] ; 
pIndex -- CMN LAST. SPECIAL PTR; instr S E GUN-OPCODECNOR, 
j $ 
if (pIndex > ((int32_t) he c ee else if ((instr[3] & OxOf) == OxOf) // "PAC © 1" -> "POP" 
pointers[typeEnv] = pInde { 
instr[0] = CMN_OPCODE_PoP; 
instr[1] &- -(CMN MASK INSTR CON | Ox0f); 
bytecode += 2; instr[2] = CMN OPCODE NOP; 
instr[3] = 0; 


H 
for (uint8 t i = 0; i < 4; ++i) } 
if (memoryCells[i] != © || pointers[i] != 0) 
/* now we simply collapse blocks of at most 16 pops into one pop of 


memorye l tapi] =_stackTo psi] + multiple values (it could be done much better, this is just KISS) */ 
(memoryCells[i] > minse kSize ? memoryCells[i] : minStackSize); int popsInRow - 0; 
pointers[i]++; // add stack top while (instr[2 * popsInRow] == CMN OPCODE POP && 
(instr[2 * popsInRow + 1] & O0xOf) == © && popsInRow < 16) 
} popsInRow++; 
void CMN bytecodeRemoveInstrs(uint8 t *bytecode, uint32 t startAddr, if (popsInRow » 1) 


uinti6 t instrCount) 
for (int i = 1; i « popsInRow; ++i) 


uint8 t *instr = bytecode + CMN BYTECODE HEADER SIZE + startAddr * 2; 
instr[2 * i] - CMN OPCODE NOP; 


di // shift } instr[2 * i+ 1] = 0; 
instr[0] = instr[instrCount * 2 r 
inseri] = inees pinsercount * 214 17; , instr[a] = (instr[1] & oxfo) | ((popsīnRow - 1) & 0x0f); 
instr += 2; š 

} while (*instr != CMN_OPCODE_END); " instr += 2; 

instr = bytecode + CMN_BYTECODE_HEADER_SIZE; l 


while (*instr != CMN OPCODE END) // recompute addresses if (types & CMN OPTIMIZE REMOVE NOPS) 


if (Finstr == GMN OPCODE CAL ||,// deals with addresses? HINEBEE iterations = -TFERATTONS; 
instr >= CMN OPCODE JÍA && *instr <= CMN OPCODE JMA)) uide deer sudore) 
i 


uint32 t jumpAddr = CMN instrGetConst(instr); uint& t stop = ET 


/* TODO: possibly change this to also handle the case someone jumps uint32 t addr - 6; 


heu SHOR En Ehe etare nr Ene UreRoced bISeKy m the, Tenover. Plock set while (bytecode[CMN BYTECODE HEADER SIZE + 2 * addr] !- CMN OPCODE END) 


stop - 0; 


Hr (jumpAddr >= startAddr + instrCount) uinti6 t'nopCount = 0; 
; 


Jünpacdr cee ins EPCOURE; while (bytecode[CMN BYTECODE HEADER SIZE + 2 * (addr + nopCount)] == 


uint8 t *tmp - instr * 2; CMN_OPCODE_NOP ) 


nopCount++; 
while (*tmp == CMN OPCODE COC) if (nopCount 
{ tmp e] = CMN OPCODE NOP: CMN bytecodeRemoveInstrs(bytecode, addr, nopCount ) ; 
X — —' E 
tnb H 2; addr++; 
} 
.CMN compilerFillConst(0, instr, jumpAddr); if (stop) 
break; 
! iterations--; 
instr += 2; } J 
bytecode[CMN BYTECODE CHECKSUM BYTE] - CMN bytecodeChecksum(bytecode); if (types & CMN OPTIMIZE INLINE) 


uint8 t *instr = bytecode + CMN BYTECODE HEADER SIZE; 
uint8 t CMN bytecodeChecksum(const uint8 t *bytecode) 


uint8 t r = 0; 


while (*instr !- CMN OPCODE END) 
if (*instr == CMN_OPCODE_CAL) 


uint8_t callLen = 0, funLen = 0; 


i const uint8 t *instr2 = bytecode + CMN_BYTECODE_HEADER_SIZE + 
while (*bytecode != CMN_OPCODE_END) CMN_instrGetConst(instr) * 2; 


r += B Eecode t | 


bytecode += CMN BYTECODE HEADER SIZE; 


r 42 Bytecode 1 while (instr[calllen * 2 + 1] & CMN MASK INSTR CON) 


bytecode += 2; callLen++; 
callLen++; 
return i; while (instr2[funLen * 2] != CMN_OPCODE_RET) 
funLen++; 
* 
MO MR CCP ar eonetleny MERC t *bytecode, uint32 t types, if (funLen <= calllen) // will it fit? 
define  ITERATIONS 3 // how many times repeat some kind of processing funLen - 0; 
if (types & CMN OPTIMIZE REPLACE OPS) MAR (instr2[2 * funLen] !- CMN OPCODE RET) 
i +4 - + : instr[2 * funLen] - instr2[2 * funLen] 
uint8 t *instr bytecode CMN BYTECODE HEADER SIZE; f instrpz * funLen + 1] = instr2[2 " Sub Len. cx il; 


while (*instr !- CMN OPCODE END) j funtenss; 


// replace "push X, ??X" with "??C, CON X" 
if (instr[0] == CMN OPCODE CON && !(instr[1] & CMN MASK INSTR CON) && while (funLen « callLen) 
mun & CMN MASK INSTR LNOPOP) && 


instr[2] » CMN OPCODE SPECIALS & instr[2 * funLen] = CMN OPCODE NOP; 
( (instr & exes) == CMN_OPCODE_21) && instr[2 * funLen + 1] = 0; 
instr & CMN_MASK_INSTR_NOPOP) ) } callLen--; 

/* note: if the constant continues with COCs, we can't do this because H 

the instructions won't fit, ALSO doing this with bigger constants } 

would lead to sign issues in type env. 0 (where we don't know the 

number bit width -- here we just suppose it's bigger than 4). */ instr += 2; 
instr[0] = (instr 0x03 CMN OPCODE 1C1; } 
instr te] &- -CMN | Me INSTA: HOPO; í 

if (types & CMN OPTIMIZE REMOVE DEAD) 

incerta, Sansertaye ME for (uints_t i - 0; i < ITERATIONS; ++i) 


P nt32 t addr - 0; 
if (ester d & OxO0f) == 0) && // operations that do nothing Mm Uint8 t "instr = bytecode + CMN BYTECODE. HEADER. SIZE; 


instr[O] == CMN OPCODE ÁDC || instr[@] == CMN OPCODE SUC | 

Mr ] == GMN DPCODE BOC i inett [oq == CMN_OPCODE_LOC)) r uintie t funcIndex = 0; 
instr[1] & 0x0 == && : 
instr[0] == CMN OPCODÉ MUC || instr[@] == CMN OPCODE DIC || while (*instr !- CMN OPCODE END) 
instr[6] == CMN OPCODE LAC || instr[Ó] == CMN OPCODE DSC)) 


// TODO: remove other unused code, e.g. if 0 etc. 
CMN OPCODE NOP; 


instr[o J . E 
0; i (instr[0] == CMN OPCODE DES && instr[1] == CMN DES FUNC) 


instr[i 
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uint32 t funcLen - 0; 


while (instr[2 * funcLen] !- CMN OPCODE RET) 
funcLen++; 


funcLen++; 
uint8_t isCalled = 0; 
const uint8_t *instr2 = bytecode + CMN_BYTECODE_HEADER_SIZE; 


while (*instr2 != CMN_OPCODE_END) 


// if something jumps into the function (with call or goto) 
if (instr2[0] == CMN_OPCODE_CAL || instr2[0] == CMN OPCODE JMA) 


uint32 t c = CMN instrGetConst(instr2); 
if (c >= addr + 2 && c « addr + funcLen) 


isCalled - 1; 
break; 


3 
3 


instr2 += 2; 


if (!isCalled) 
CMN_bytecodeRemoveInstrs(bytecode, addr, funcLen) ; 


instr -= 2; 
addr--; 


// remove the function from compiler's symbol table 
if (compiler !- 0) 
uinti6 t fi = 0; 
"Ole Ceonpi te i = oF i « compiler-»symbolCount; Hid 
mS ome ler »symbolTable[i CMN. STRING PSEUDOHASH SIZE] 
if (fi -- funcIndex) 
compiler->symbolTable[i * CMN STRING PSEUDOHASH SIZE] = 


break; 


fie; 
} 


else 
funcIndex++; 


instr += 2; 
addr++; 


} } 


gulder _ITERATIONS 


void CMN_preprocessorInit(CMN_Preprocessor *preprocessor, uint8_t minify, 
void (*outFunction) (char) ) 


preprocessor->state = _CMN_PREPPROCESSOR_IN; 
preprocessor->minify = minify; : 
preprocessor-»outFunction = outFunction; 
CMN. tokenizerInit(&preprocessor-»tokenizer); 


void _CMN_preprocessorOutputChar(void (*outFunc)(char), char c) 
if (c >= ' ' && c !- '"' && c != '[' && C !- ']' Bc !- '#') 
outFunc('"'); outFunc(c); outFunc('"'); 


else 
( // output chars that can't be inside str. lit. as num. lit. 
outFunc('O' + c / 100); 
outFunc('O' + (c / 10) % 10); 
} outFunc('O' + c% 10); 
H 


uint8 t CMN preprocessorFeedChar(CMN Preprocessor *preprocessor, char c) 
uint8 t separate - 0; // 0: no, 1: space, 2: newline 
define _PCH(c) preprocessor-»outFunction(c); 


if (preprocessor->state ==  CMN PREPPROCESSOR IN) 
LONE 

if (c == ']') 

1 


preprocessor->state =  CMN PREPPROCESSOR OUT; 
.PCH('An') _PCH('#') PCH(')') PCH('An') 
separate = 1; 


l 
else if (c == '[') 

1BEeDrOCessDrses tate = CMN PREPROCESSOR ERROR; 
else 

preprocessor-»outFunction(c); 


ee if (preprocessor->state ==  CMN PREPPROCESSOR OUT) 
if (ese 1D Meee 9) 
preprocessor estate = | CMN PREPPROCESSOR IN; 
.PCH('Nn') _PCH('#') PCH('(') PCH('*n') 
separate - 1; 
else if (c == ']' 


preprocessor->state = CMN PREPROCESSOR ERROR; 
else if (!preprocessor->minify) 


— CHIN prẹ rocessorOutputChar (preprocessor ->outFunction,c); 
PCH a _PCH('>') 
LPCH('An') 


else 
switch (CMN tokenizerFeedChar(&(preprocessor-»tokenizer),c)) 


case CMN TOKENIZER TOKEN: 
const char *tokenC = preprocessor->tokenizer.tokenString; 
—PCH(' ') 


while (*tokenC !- 0) 
-PCH(' ') , 
.CMN pre rocessorOutputChar ( reprocessor-»outFunction, *tokenC); 
.PCH(' rh .PCH('-') _PCH('> ? 
tokenC++; 


separate = 2; 
break; 


case CMN_TOKENIZER_ERROR: 
reprocessor-asrate = CMN PREPROCESSOR ERROR; 
reak; 


default: break; 


H 
if (separate) 
.PCH(' ') 
_PCH( separate == 1 ? '3' : '1' 
_PCH( separate == 1 ? '2' : 'Q' 
LPCH(' ') _PCH('-') _PCH('>') L PCH('\n') 
#undef _PCH 


return preprocessor ->state; 


int CMN_interpretStr(const char *source, uint8_t *memory, 
uint32_t memorySize, uint16_t minCells, uint32 t maxSymbols, 
uint32 t CEDE CMN IOFunction ioFunction, 
void (*statusCa lback)(uint8 t, uint32 t, CMN Interpreter *)) 


CMN Compiler compiler; 
CMN Interpreter interpreter; 


maxSymbols *- CMN STRING PSEUDOHASH SIZE; 


if (maxSymbols » memorySize) 


if (statusCallback) 
statusCallback(1,0,0); 


return 0; 


CMN compilerInit(&compiler,memory,memorySize - maxSymbols, 
(char *) (memory + memorySize - maxSymbols),maxSymbols,0); 


uint32 t strPos - 0; 
while (1) // compile 
if (CMN compilerFeedChar(&compiler,source[strPos]) !- CMN COMPILER OK) 


if (statusCallback) 
statusCallback(1,strPos,0); 


return 0; 
if (source[strPos] == 0) 
break; 


strPos++; 


CMN_bytecodeOptimize(memory, CMN_OPTIMIZE_ALL, 0); 
uint8_t *ramStart = memory + CMN_BYTECODE_HEADER_SIZE; 


while (*ramStart != CMN_OPCODE_END) 
ramStart += 2; 


ramStart += 2; 


Cun” interpreterInitt&interpreter;memory ramStart, — 
memory + memorySize - ramStart,minCe ts, ioFunction, 0, 0,0); 


// run: 
uint8 t status - CMN interpreterStep(&interpreter,maxSteps); 


if (status !- CMN INTERPRETER END) 


if (statusCallback !- 0 
statusCallback(2,0,&interpreter); 


return 0; 
if (statusCallback !- 0) 
statusCallback(0,0,&interpreter); 
return interpreter memorya != 0? t 
interpreter.memoryO[interpreter.pointers[0][9]] : 0; 


} 
uint8_t CMN_bytecodeCheckSanity(const uint8_t *bytecode, uint32_t maxSize) 


if (maxSize <= CNN BY TECODE. HEADER SIZE) 
return CMN BYTECODE SANITY ERROR; // too small, no space for END 
if (bytecode[0] !- 'C' bytecode[1] !- 'B') 


return CMN BYTECODE SANITY ERROR HEADER; 


const uint8 t *stopper = bytecode + maxSize; 


const uint8 t *bytecodeOld - bytecode; 
bytecode += CMN BYTECODE HEADER SIZE; 


char instrStr[16]; 


while (*bytecode !- CMN OPCODE END) 
CMN instrToStr(bytecode,instrStr); 


if (instrStr[0] -- ' ') // no name -» unknown opcode 
return CMN BYTECODE SANITY ERROR INSTR; 


bytecode += 2; 


if (bytecode >= stopper } 
return CMN_BYTECODE_SANITY_ERROR_NO_END; 
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} 


if (bytecodeOld[CMN_BYTECODE_CHECKSUM_BYTE] != 
CUN by tecodechecksum( bytecode ld) ) 
return CMN_BYTECODE_SANITY_ERROR_CHECKSUM; 


src_c/minicomun.h 


/** Minicomun, a small programming Language. This is a single-header C99 
implementation of minicomun, a small version of the comun language. This is a 
small, KISS implementation that interprets the source text directly and isn't 
very fast. This file can also be compiled as a standalone interpreter 

n (#define MCM STANDALONE 1). Compared to comun this minicomun only has one 

ype 


environment (set with MCM TYPE), doesn't support file includes, 
preprocessing, 

goto and only supports user pointers in a limited way (only predefined number 

of one letter pointers of size 1 which can only be used as variable). Due to 

simp laity some non-comun programs may actually be accepted by this minicomun 

implementation (pointers don't have to be defined). 


by drummyfish, 2022, released under CCO 1.0, public domain 
(https://creativecommons.org/publicdomain/zero/1.0/) */ 


#ifndef _MINICOMUN_H 
#define _MINICOMUN_H 


#ifndef MCM_STANDALONE 
" eccrine MCM_STANDALONE 1 ///< includes implementation of standalone interpr. 
endi 


#ifndef MCM TYPE . i oo 
#detine MCM_TYPE unsigned int ///< minicomum data type, has to be unsigned 
#endi 


#ifndef MCM_CELLS 
#detine MCM_CELLS 512 ///< number of memory cells 
#endi 


#ifndef MCM_PARSE_STACK_SIZE . ; 
eden ine MCM_PARSE_STACK_SIZE 128 ///< parse stack size, says maximum nesting 
#endi 


#ifndef MCM_CALL_STACK_SIZE 
A define MCM CALL STACK SIZE 64 ///« call stack size, max. func. call nesting 
endi 


#ifndef MCM STANDALONE MAX SOURCE SIZE 
» Pdetine MCM STANDALONE MAX SOURCE SIZE 4096 ///« buffer size for source code 
endi 


#ifndef MCM POINTERS 
r ederine MCM_POINTERS 8 ///< number of usable pointers (e.g. 3: a, b and c) 
endi 


#define MCM OK 0x00 ///« all OK 

#define MCM ERROR 0x01 ///« generic error 

#define MCM ERROR BAD TOKEN 0x02 ///« error: syntactically wrong token 
#define MCM ERROR BAD OPERATION 0x03 ///« error: invalid op. (0 div etc.) 


#define MCM ERROR UNEXPECTED TOKEN 0x04 ///« error: unexpected token found 
#define MCM ERROR UNEXPECTED END 0x05 ///« error: unexpected end of source 
#define MCM ERROR MEMORY BOUND LEFT 0x06 ///« error: memory over/underf low 
#define MCM ERROR CALL STACK 0x07 ///« error: call stack overflow 
#define MCM ERROR NESTING TOO DEEP 0x08 ///< error: parse stack overflow 


MCM TYPE MCM memory [MCM. CELLS] ; 
unsigned int MCM_stackTop; 
unsigned int MCM sourcePos; 
MCM TYPE MCM_pointers[MCM_POINTERS]; 


/** Interprets given minicomum source code. Any of the function parameters may 
be © in which case they're not used. */ 

char MCM interpret(const char *code, int (*inputFunction 
void (*outputFunction)(int), void (*stepFunction)(void 
void *externalCallFunction) (const char *,unsigned int 


(void), 


) 


// privates: 


// Moves MCM sourcePos to next token start, returns its length (0 if end). 
unsigned int _MCM_nextToken(const char *code) 

9; 

9; 


unsigned char state 
unsigned int length 


white (1) 
char c = code[MCM_sourcePos + length]; 


if (c -- 0) 
return length; 


switch (state) 


case 0: // skipping starting whitespaces 
if (c == PO 


state - 1; 
MCM_sourcePos++; 


lise if (c» ') 


state = 2 + (c == '"'); 
length++,; 

else 
MCM_sourcePos++; 

break; 

case 1: // inside comment 

if (c == '#' || c == '\n') 

state = 0; 


MCM_sourcePos++; 
break; 


case 2: // reading non-string token 
if ((c <= ' ') [| c == '#' 
return Length; 


length++; 
break; 


case 3: // reading string token 
if (c == "m 
return length + 1; 


length++,; 


return CMN_BYTECODE_SANITY_OK; 


#endif // guard 


break; 
} default: break; 
H 


return 0; 


ce _MCM_findFunc(const char *code, const char *funcName, 


unsigned char state = 0; 
int pos = 0; 


while (1) // read chars 


if (*code == 0) 
break; 


switch (state) 
ce 0: // skipping blanks 
if (*code == '#') 
state = 1; 
else if (*code > ' ') 


unsigned int matched - 0; 


while (matched « len && 


*(code + matched) == *(funcName + matched)) 


matched++; 


if (matched == len && *(code 5519 == ';! 


&& (*(code + len + 1) <= ' 
return pos; 


break; 
H 
case 1: // in comment 
if (*code == '#' || *code == '\n') 
state = 0; 
break; 
case 2: // token 
if (*code <= ' ') 
state = 0; 
else if (*code == '#') 


state = '#'; 
break; 


default: break; 


code++; 
pos++; 


return -1; 


// Checks if token is identifier, returns © (no), 1 (yes), 2 
unsigned char _MCM_checkIdentifier(const char *string, i 


if (*string >= '0' && *string <= '9') 
return 0; 


unsigned char ret = 1; 
a (string[len - 1] == ':') 


len--; 
ret++; 


H 
while (len > 0) 


if (*string IZ GO! && 
string < '0' *string > '9') && 
*string < 'a' *string » 'z') && 
*string « 'A' *string » 'Z'J) 
return 0; 


stringt+; 
len--; 


return ret; 


} 


//_Checks if num. literal is valid (returns © or 1) and possibly gets its 


value. 


unsigned char _MCM_checkNumericLiteral(const char *literal 


( MCM TYPE *value) 


unsigned char positive - 1; 
unsigned char base - 10; 


if (*literal == '+' || *literal == '-') 
positive = *literal == '+'; 
iteral++; 
en--; 

3 

"d (*literal -- 'd') 
iteral++; 
en--; 

oo if (*literal == 'x') 
base = 16; 
iterale*; 

} en--; 

oo if (*literal == 'b') 
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le 


unsigned int len) 


int len, 


gyes: func. def.). 
n 


base - 2; t 
literal-*; if (externalCallFunction !- 0) 
len--; externalCallFunction(code + MCM_sourcePos, tokenLen); 
d 
ittm) parseStack[parseStackTop] - MCM sourcePos; 
x: parseStackTop++; 


*value = 0; 
“aie ; if (parseStackTop >= MCM PARSE STACK SIZE) 


while (len > 0) urn MCM ERROR NESTING TOO DEEP; 


unsigned char digit = callStack[callStackTop] - nextPos; 
iteral >= '0' && *literal <= '9') ? callStackTop**; 
*literal - '0' . 
((literal >= ‘a! && "literal <= 'f' Jr? if (callStackTop >= MCM_CALL_STACK_SIZE) 
(*literal - 'a' + 10) : 200); return MCM_ERROR_CALL_STACK; 
if (digit >= base) nextPos = funcPos + tokenLen + 1; 
réturn 0; H 
*value = *value * base + digit; normalOperation = 0; 
literal++; [t if (identifier -- 2) // func. def? 
len--; 
H enr parseStack[parseStackTop] - MCM sourcePos; 
oe ee 
if «x ositive) Dracketcount = 9; 
alue = 0 - *value; A normalOperation + 0; 
return 1; else if (C(0) == '"') // string 
if (C(tokenLen - 1) !- '"' 
109 int  MCM toSigned(MCM TYPE x) return MCM ERROR BAD TOKEN; 
long int result - x; for (int i = tokenLen - 2; i > 0; --i) 
MCM TYPE typeMax = 0 - 1; char c = code[MCM sourcePos + i]; 
if (result » typeMax / 2) if (c == '"') 


réturn MCM ERROR BAD TOKEN; 
result -- typeMax; 


result--; MCM_stackTop++,; 


if (MCM_stackTop >= MCM_CELLS) 
; return result; réturn MCM ERROR MEMORY BOUND LEFT; 


" : M(0) = 
MCM TYPE _MCM_fromSigned(long int x) (9) 


return (unsigned long) x; normalOperation = 0; 


i else if ( MCM checkNumericLiteral(code + MCM sourcePos, tokenLen, &result)) 
MCM TYPE | MCM compare(MCM TYPE a, MCM TYPE b, unsigned char greater 


unsigned char equal, unsigned Char isSigned) popN - 
i (isSigned) else if (tokenLen <= 2) 
MCM TYPE add = 0 - 1; #define CHARS(a,b) ((a << 8) | b) 
add = add / 2 + 1; unsigned int chars = CHARS(C(@),(tokenLen == 2 ? C(1) : 0)) 
a += add; 
ate addi switch (chars) 
} case CHARS('$',0): 
return equal ? (greater ? (a »- b) : (a «- b)) : unsigned int n - M(0); 


(greater ? (a > b) : (a < b)); 
if (n » MCM stackTop) 
return MCM ERROR MEMORY BOUND LEFT; 


char MCM interpret(const char *code, int (*inputFunction)(void), 


void outputFunction)(int) void' (*stepFunction)(void result = M 
void B *externalCallFunction) (const char *,unsigned int j break; (m; 
unsigned int parseStack[MCM | PARSE_ STACK_SIZE]; 3 
Uneiened inr PA TStaek [MEM C. CALL. STACK | SIZE]; case CHARS('Q', 
unsigned int ca ac = 
unsigned int callStackfop = 0; d j parsestack{ par sestackTop] = MCM_sourcePos; 
unsigned char state = 0; /* 9: : 99 1: skip ae . Or ;, 2: skip to ., P p 
oop break, func break */ " 
int bracketCount - 0; if (!M(90)) 
MCM stackTop = MCM CELLS - 1; pete Coline SKI. the: Loop 
; 
while (MCM stackTop » 0) 
eds if (doPop) 
MCM memory[MCM stackTop] = 0 5 
MCM-Stacklop--7 i MCM stackTop--; 
1 normalOperation - 0; 
MCM_stackTop++; // this pushes 0, meaning © program arguments received break; 
int i=0: i 44d case CHARS('2',0): 
for (int i = eh] < MCM POINTERS; ++i) parseStack[parseStackTop] = MCM sourcePos; 
MCM pointers[i] - 0; parseStackTop++; 
MCM memory[0] = 0; 
MCM-SOUTCO 08 = 0; a (1M(®)) 
. state = 1; 
unsigned char eof = 0; bracketCount = 0; // skip the branch 
while (1) // for each token 
if (doPo 
unsigned int tokenLen = _MCM_nextToken(code); MoM ce eokTop- - 
if (tokenLen == 0) normalOperation = 0; 
break, break; 
#define C(i) code[MCM_sourcePos + (i)] case CHARS( ' ; ' ,0): 
#define M(i) MCM memory[MCM stackTop - i] state - 1; 
bracketCount - 0; // skip the branch 
MCM TYPE result - 0; normalOperation - 0; 
unsigned char BopN 21; break; 
unsigned char d ob. T 
unsigned char norma Operation = = 1; ca CHARS 
unsigned int nextPos = MCM : sourcePos * tokenLen; SF (oar eestabeton == 0) 
unsigned char identifier; return MCM ERROR UNEXPECTED TOKEN; 
if (C(tokenLen - 1) == '\'') parseStackTop--; 
Ene aum char c = code[parseStack[parseStackTop]]; 
if (c == 'Q') 
A PE nextPos = parseStack[parseStackTop]; 
if (state == 0) // not skipping? else if (c != '?') // function return? 
identifier = _MCM_checkIdentifier(code + MCM sourcePos, tokenLen); callstackTop-- 


if (identifier == 1) // func. call? nextPos - eRllétack[callstackTop]; 


int funcPos = _MCM_findFunc(code,code + MCM sourcePos, tokenLen); normalOperation - 0; 


break; E 
if (funcPos « 0) 
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case CHARS('^',0): 
if (!doPop) 
return MCM ERROR BAD TOKEN; // not allowed with pop 


mcM_stackTop: =i 
normalOpera ion = 
break; 


case CHARS ( | $','$'): 
result = MCM. | stackTop; 


OpN = 0; 
break; 
case CHARS( 11s Lys 
result - 1M(0); 
popn = = 1; 
reak; 


case CHARS('!',0): 
result - -M(0); 
pop = 1; 
reak; 


case CHARS('/',0): 
case CHARS('%',0): 
case CHARS('/','/'): 
case CHARS('%', '%'): 
if (M(8) == 0) 
return MCM_ERROR_BAD_OPERATION; 


if (MCM_ Sa EPOR uà 
return MCM ERROR MEMORY BOUND LEFT; 


result - 


e = == '/' ? 
CM | fromSigned( | MCM toSigned(M(1)) / X MCM toSigned(M(0))) 


C(1) == '%' ? 
MC " fromsi ne MCM toSigned(M(1)) % MCM toSigned(M(0))) 
,(c(8) == "7" ema) 7 “N(O)) : { {i} % M(0))) 
N = 2; 
break; 


#define OP2(c1,c2,0p) case CHARS(c1, ca N 
if (MCM. stackTop « 1) return MCM E ROR MEMORY BOUND LEFT;* 


esult - M(1 M ; N - 2; break; 
resu op? (1) FM 8); pop ; br 


OP2 
0OP2 
OP2 
0OP2 
0OP2 


#undef OP2 


case CHARS : 
if (MCM_stackTop < 1) 
return MCM_ERROR_MEMORY_BOUND_LEFT; 


Et ntt ten 208) == rue) = = 


r 


case CHARS('?','?'): 
if (MCM_stackTop < 2) 
return MCM_ERROR_MEMORY_BOUND_LEFT; 


opN = 
Paeit = 


d" 2) ? M(1 
break; (2) (2) 


M(9); 


case CHARS('Q', 'Q' 
parsestack{ par seStackTop] = MCM_sourcePos; 
parseStackTop++; 
norma Operation = 0; 
break; 


case CHARS('!', 'Q'): 
state 3; 
bracketCount = 0; 
normalOperation = 0; 
break; 


case CHARS('!','.'): 
if (callStackrop > 0) 
state = 4; 
else 
return MCM_OK; 


1 


normalOperation = 0; 
break; 
case CHARS('>', '<'): 


if (MCM_ an ropas uà 
return MCM ERROR MEMORY BOUND LEFT; 


MCM TYPE a - M(8), b - M(1); 
MCM stackTop += 2 * (!doPop); 


if (MCM stackTop »- MCM IECUR 
return MCM ERROR MEMORY BOUND LEFT; 


MJ 


normalOperation = 0; 
break; 


b; 
al 


F 
case CHARS('<','-'): 

int v = (eof || inputFunction == 0) ? © : inputFunction(); 
if (v < 0) 

eof = 1; 


1 


} 


popN = 9; 
result = v; 
break; 


} 


case CHARS (' etu tera 
result - leof; 
popn =: = 0; 
reak; 


case CHARS('-', '>! 
if (outp utFunction != 0) 
oütputFunction(M(9)); 


normalOperation - 0; 
MCM stackTop -= doPop; 


break; 
case CHARS('+','+'): result = M(0) + 1; break; 
case CHARS('- -' result = M(0) - 1; break; 
defaul 
d ttio) = == '$') // $N 
popN = 0; 


if (C(1) >= '0' && C(1) <= '9') 
unsigned char n = C(1) - '0'; 


if (n » MCM stackTop) 
return MCM ERROR MEMORY BOUND LEFT; 


result - M(n); 
else 
unsigned char n - C(1) - 'a'; 


if (n » MCM POINTERS) 
return MCM ERROR BÁD TOKEN; 


result - MCM pointers[n]; 


lise if (C(0) == '-' && C(1) >= 'a' && C(1) < 'a' 
normalOperation = 0; 
else 
return MCM_ERROR_BAD_TOKEN; 
break; 
// switch 


#undef_CHARS 
else if (tokenLen == 3) 
if (C(O) == '$') 
if (C(1) == ':' && (C(2) >= 'a' && C(2) < 'a' 


normalOperation - 0; 


MCM pointers[C(2) - 'a'] = M(8); 
if (doPop) 
MCM stackTop--; 
l 
else 
{ 


unsigned int n = C(2) - '0'; 


if (n > 9) 
réturn MCM ERROR BAD TOKEN; 


switch (C(1)) 
t // $:N 


if (n > MCM_stackTop) 
return MCM_ERROR_MEMORY_BOUND_LEFT; 


case ':': 


M(n) - M(0); 
if (doPop) 
MCM stackTop--; 

break; 
case '>': if (n ©) MCM_stackTop++; break; // 
case '<': if (n 0) MCM stackTop--; break; // 
case '*': n 0) MCM stackTop 4i 

; 


if 
default: break; 


H 
H 
normalOperation - 0; 
else if (C(0] == '-' && C(1) == '-' && C(2) == '>') 


if (i dorop) // not allowed with this operation 
return M_ERROR_BAD_TOKEN; 


while (1) 


if (MCM_stackTop == 0) 
return MCM_ERROR_MEMORY_BOUND_LEFT; 


MCM stackTop--; 


if (MCM memory[MCM stackTop + 1] == 0) 
break; 

else if' (outputFunction != 0) 
outputFunction(MCM_memory[MCM_stackTop + 1]); 


normalOperation = 0; 


élse if (C(2) == '=' && C(O) == C(1) && (C(0) == '«' 


if (MCM_stackTop < 1) 
return MCM_ERROR_MEMORY_BOUND_LEFT; 


result = MCM compare(M(1),M(0),C(0) == '>',1,1); 
popN = 2; 
else if (C(O) == '|' && C(1) == '!' && C(2) == '!") 


if (MCM stackTop « 1) 
return MCM ERROR MEMORY BOUND LEFT; 


result = (M(0) == 0) !- (M(1) == 0); 
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* MCM | 


* MCM POINTERS) 


POINTERS)) 


$>N 


$<N 
_MCM_toSigned(M(0)); break; 


|] c(1) == '>")) 


popN - 2; 


else 
return MCM ERROR BAD TOKEN; 


else if (tokenLen -- 4) 


normalOperation - 0; 


if (c(0) == '$ == '»! && C(3) == '0' && 
(9 >= a? P ter <= '9')) (3) 
st _-gtackTop -= '0'); 


_(¢(1 
else if NEUCOR M && C(1)'»- 'a' && C(1) < 'a' + MCM POINTERS && 
&(2) -E 


rétürn MCM ERROR B. D TOKEN: 


l 
else 
return MCM ERROR BAD TOKEN; 


if (normalOperation) 
MCM stackTop = MCM stackTop + 1 - (doPop ? popN : 0); 
if (MCM stackTop « MCM CELLS) 
M(O) = result; 
H 
if (MCM stackTop »- MCM CELLS) 
return MCM ERROR MEMORY BOUND LEFT; 


if (stepFunction !- 0) 
stepFunction(); 


else if (state -- 1 || state -- 2) // skipping to next . or ; 


if ((tokenLen == 1 && C(0) == '?') || ((tokenLen < 3) && C(8) == '@')) 


bracketCount++,; 
else if (tokenLen == 1 && (C(0) == '.' || C(O) == ';")) 


if (bracketCount == 0 && !(state == 2 && C(0) == ';')) 
state = 0; 


if (C( 9) yet 
parse tacktóp?-; 


lise if (C(O) != ';'") 
bracketCount--; 


else // state -- 3 (loop break) or state -- 4 (func break) 


1 
if ((tokenLen == 1 && C(0) == '?') || ((tokenLen « 3) && C(0) == 'Q')) 
parseStack[parseStackTop] - MCM sourcePos; 
Brackeeconneee. 
racketCount++,; 


if (parseStackTop >= MCM PARSE STACK SIZE) 
réturn MCM ERROR NESTING TOO DEEP; 


l 
else if (tokenLen == 1 && C(0) == '.') 
if papare rack Top == 0) 
urn MCM_ERROR_UNEXPECTED_TOKEN; 


parseStackTop--; 
char c - code[parseStack[parseStackTop]]; 


if (state == 3 && bracketCount <= 0 && c == 'Q') 
state - 0; 

else if (state == 4 && c !- '?' && C !- 'Q') 
state - 


ea tistacktoas<? 
nextPos = call$tack[callStackTop]; 


else 
} bracketCount--; 


} 


#undef M 
#undef C 


MCM_sourcePos = nextPos; 
} // for each token 


return parseStackTop == 0 ? MCM_OK : MCM ERROR UNEXPECTED END; 


src_c/comun.c 


J** 
Comun interpreter/compiler/transpiler/CLI tool. 


«PY drummyfish, released under CCO 1.0, public domain 


#ifndef BYTECODEDMEM SIZE 
#define BYTECODEDMEM SIZE 131072 
#endif 


#ifndef SYMBOLMEM_SIZE 
#define SYMBOLMEM_SIZE 16384 
#endif 


#ifndef INTERPRETERMEM_SIZE 
" pdetine INTERPRETERMEM SIZE 131072 
endi 


#ifndef MIN CELLS 
#define MIN CELLS 128 
#endif 
#define CMN_STRING_PSEUDOHASH_SIZE 16 


#include <stdio.h> 
#include "comun.h" 


#define INCLUDE_STACK_SIZE 32 


#define MAX_ARGS 32 

#define MODE_RUN 0 // interpret 

#define MODE BC 1 // compile to bytecode 
#define MODE BC TEXT 2 // compile to text bytecode 
#define MODE C 3 // compile to C 

#define MODE COMUN 4 // compile to comun 


define MODE ESTIMATE 5 // estimate resources 
#define MODE_PREPROC1 6 // output first stage of preprocessing 


#if MCM_STANDALONE 
#include <stdio.h> 


char code[MCM STANDALONE MAX SOURCE SIZE]; 


void output(int c) 


putchar(c); 


ee externalCall(const char *fn, unsigned int len) 


} 


char s[16]; 
unsigned int i; 


for (i = 0; i « len && i < 15; ++i) 
s[1] = fn[i]; 
s[i] - 6; 


fprintf(stderr, WARNING: unknown function \"%s\", ignoring.",s); 


int main(int argc, char **argv) 


zd 


#u 


#e 
#e 


#d 
#d 
#d 
#d 


if (argc < 2) 


fputs("ERROR: expected input file.\n",stderr); 
return 1; 


FILE *f - fopen(argv[1], "r"); 
if (!f) 


fprintt(stderr; "ERROR: could not open the source file \"%s\"",argv[1]); 
return 1; 


fseek(f,OL,SEEK END); 
unsigned int charcount = ftell(f); 
fseek(f,0L,SEEK SET); 


if (charCount » MCM STANDALONE MAX SOURCE SIZE) 


fputs("ERROR: source code too long",stderr); 
return 1; 


H 
fread(code, 1, charCount, f) ; 


fclose(f); 
unsigned char r = MCM interpret(code,getchar,output,0, externalCall); 
switch (r) 


efine E(t,s) case t: fputs(s "\n",stderr); break; 

E(MCM ERROR, "ERROR" ) 
MCM ERROR BAD TOKÉN, "ERROR: bad token") 
MCM | ERROR. UNEXPECTED - TOKEN, "ERROR: unexpected token") 
MCM ERROR BAD OPERATION "ERROR: bad operation") 
MCM ERROR UNEXPECTED | END, "ERROR: unexpected end") 
MCM ERROR MEMORY BOUND . LEFT, "ERROR: memory bound left") 
MCM_ERROR_CALL_STACK, "ERROR: call stack overflow") 

d MEM | ERROR NESTING : TOO | DEEP,"ERROR: nesting too deep") 
nde 


default: break; 


TTI [TV ITI [T1 ITI mm 


if (r !- MCM OK) 
unsigned int line - 1; 


for (unsigned int i = 0; i <= MCM sourcePos; ++i) 
if (code[i] == '\n') 
linet++; 


fprintf(stderr,"at position %d (line %d, stack position: %d):\n%.10s\n", 
MCM_sourcePos, Line, MCM_stackTop, code + MCM sourcePos); 


return 0; 


ndif // if MCM STANDALONE 
ndif // guard 


efine MODE PREPROC2 7 // outputs second stage of preprocessing 
efine MODE MEASURE 8 // run and measure code 

efine MODE MINIFY 9 // minimize code 

efine MODE BEAUTIFY 10 // beautify code 


#define O1 CMN OPTIMIZE REMOVE NOPS 
define oe o aE UALS REPLACES URS) 


define 0 


TIMIZE ALL 


#define INCLUDE FILENAME MAX LEN 16 
define INCLUDE LIST LEN 128 


// 
FI 


unsigned int includeStackLines[INCLUDE STA 


include stack 


LE *includeStackFiles[INCLUDE STACK SIZE 


char ínciludeStackNames [INCLUDE . STACK RSLS oes FILENAME_MAX_LEN]; 


K SIZE]; 


int8 t includeStackTop - -1; 


// 


ist of already included files, to prevent repeated inclusions: 


char inc ludeListNameHashes [INCLUDE LIST LEN][CMN STRING PSEUDOHASH SIZE]; 
int includeListLast = -1; 


uint8 t includeOK - 1; 
uint8 t fileJustOpened 0; 


const char *sourceFile - 0 
uint8 t mode = MODE RUN; 
uint8 preprocess - 0; 
uint8 t preprocessorMinify - 


uint8 t bytecodeMem[BYTECODEDMEM SIZE]; 


uint8 
uint8 


t preprocB tecodeMem[BYTECODE DME |_SIZE]; 
interpreterMem[INTERPRETERMEM SIZE]; 


char symbolMem[SYMBOLMEM SIZE di 
char . tmpName[CMN. STRING PSEUDÓHASH SIZE + 1]; 


int lastPreprocChar - -1; 
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CMN Compiler compiler; 
CMN Preprocessor preprocessor; 
CMN Interpreter interpreter; 


#define ERROR PREFIX "ERROR: " 
define WARNING PREFIX "WARNING: " 
#define DEBUG PREFIX "DEBUG: " 


void printError(const char *str) 


fprintf(stderr,ERROR PREFIX "%s\n",str); 


void printDebug(const char *str) 
fprintf(stderr,DEBUG PREFIX "%s\n",str); 


// Interpreter I/O function for normal interpreting. 
inti6 t ioFunc(inti6 t x) 


if (x <0 
return getchar(); 


se 
putchar(x); 
return 0; 
// Interpreter I/O function for preprocessing. 
inti6 t preprocIoFunc(inti6 t x) 


if (x >= 0) 
lastPreprocChar = x; 


return 0; 
// Preprocessor function that feeds output to compiler (1st pass). 
void preprocessorToCompiler(char c) 

CMN_compilerFeedChar (&compiler,c); 

// Preprocessor function that prints its output out (2nd pass). 
void preprocessorToOut(char c) 
putchar(c); 


void interpreterDebugPrint (void) 
char instrStr[16]; 


CMN instrToStr(interpreter.currentInstruction,instrStr); 


fprintf(stderr,DEBUG PREFIX "%u; %04x 96s call st.: %02u, ",interpreter.step, 
(unsigned i anterpreter. currencinseruction - interpreter pytecoge - 
CMN BYTECODÉ HEADER SIZE) / 2,instrStr,interpreter.callStackTop); 


#define _MEM(m,mm,n)\ 
((int32 t) interpreter pointers[m][9]) >=n?\ 
interpreter.memory ## mm [interpreter.pointers[m][0] - n] : 0 


if (interpreter.memoryO != 0) 
fprintf(stderr,"mem0: %04x %04x axe a) ie, A 
_MEM(0,0,2),_MEM(0,0,1),_MEM(0,0,0),interpreter.pointers[0][0]); 


if (interpreter memar ye != 0) 
fprintf(stderr, "mem8: %02x %02x %02x<(%u) ", 
_MEM(1,8,2),_MEM(1,8,1),_MEM(1,8,0),interpreter.pointers[1][0]); 


if (interpreter.memory16 != 0) 
fprintf(stderr, "mem16: %04x %04x %04x<(%U) ", 
.MEM(2, 16, 2), MEM(2, 16,1), MEM(2, 16,0), interpreter.pointers[2][0]); 


if (interpreter.memory32 !- 0) 
fprintf(stderr,"mem32: %08x 9608x %O8x<(%U) ", 
.MEM(3, 32, 2), MEM(3, 32, 1), MEM(3, 32, 0), interpreter .pointers[3][0]); 


fputc('\n',stderr); 


/* Opens source code file. Passing 0 takes the interpreter (with preprocessor 
bytecode) output as a source "file" (for preprocessing). */ 
void openIncludeFile(const char *filename) 


includeStackTop++, 
inc ludeListLast++; 


if (includeStackTop >= INCLUDE STACK SIZE || 
includeListLast >= INCLUDE LIST LEN) 


printError("too many file includes"); 
includeOK - 0; 


else 
if (filename != 0) 
includeStackNames[includeStackTop][INCLUDE FILENAME MAX LEN - 1] = 0; 
for (int i = 0; i < INCLUDE FILENAME MAX LEN - 1; ++i) 
includeStackNames[includeStackTop][i] = filename[i]; 


if (filename[i] -- 9) 
} break; 


CMN_pseudohash('i', filename, inc ludeListNameHashes[includeListLast]); 


for (uint8_t i = 0; i < includeListLast; ++i) // check for repeated incl. 


uint8_t equals Alls 
for (uint8 t j = 0; j < CMN STRING PSEUDOHASH SIZE; ++j) 
if (includeListNameHashes[includeListLast][j] != 
inc ludeListNameHashes[i][j]) 


equals = 0; 
break; ' 


if (equals) 
( // ignore repeated includes 
inclüdeStackTop--; 
a fprintf(stderr,WARNING PREFIX "ignoring repeated include of \"%s\"\ 
n, 
filename); 
return; 


} 


else 
CMN. pseudohash( 'p', "preproc", includeListNameHashes[includeListLast]); 


if (filename !- 0) 
includeStackFiles[includeStackTop] - fopen(filename,"r"); 
if (!includeStackFiles[includeStackTop]) 


fprintf(stderr,ERROR PREFIX "could not open source file \"%s\"\n", 
filename); 


includeOK - 0; 


else 
( // open preprocessor output as a pseudofile 
includeStac FiiesincludeStackTop] = 0; 


if (!CMN interpreterInit(&interpreter,preprocBytecodeMem, interpreterMem, 
INTERPRETERMEM SIZE, MIN CELLS, preprocIoFunc,0,0,0)) 


printError("not enough memory for preproc. interpreter"); 
includeOK - 0; 


} } 


fileJustOpened = 1; 
} includeStackLines[includeStackTop] = 1; 


if (!includeOK) // if error, close all alredy opened files 


includeStackTop--; 


while (includeStackTop »- 0) 


fclose(includeStackFiles[includeStackTop]); 
includeStackTop--; 


J 
} 


/* Helper function, returns © if instruction at given address is outside any 
„function, otherwise it returns the sequence number of the function plus 1. */ 
ied bytecodeGetBlock(const uint8_t *bytecode, uint32_t n) 


bytecode += CMN BYTECODE HEADER SIZE; 


uinti6 t functionNum - 0; 
uint8 t inFunc - 0; 


while (*bytecode !- CMN OPCODE END) 
ir (bytecode[0] == CMN OPCODE DES && bytecode[1] == CMN DES FUNC) 
Snc Ton Nan; 
tear 
if (bytecode[0] == CMN OPCODE RET) 


inFunc - 0; 
bytecode += 2; 


n--; 


} 


return inFunc ? functionNum : 0; 
// Gets one character from the source code, handles includes etc. 
char getSourceChar() 
if (fileJustOpened) 
fileJustOpened - 0; 
return ']'; 
int c = 0; 
if (includeStackFiles[includeStackTop] != 0) // normal file? 
c= fgete (inc ludestackFiles[ine LudestackTop1) i. 
[eR // interpreter output is taken instead o fite 
int status - CMN INTERPRETER OK; 
// TODO: some limit preventing infinite loops in interp here 


while (lastPreprocChar < 0 && status == CMN INTERPRETER OK) 
status - CMN interpreterStep(&interpreter,1); 


c = status == CMN INTERPRETER END ? EOF : lastPreprocChar; 


lastPreprocChar = -1; 


if (c == EOF || c == 0) 


if (includeStackFiles[includeStackTop != 0 
fclose(includeStackFiles[includeStackTop]); 


if (includeStackTop -- 0) 
return 0; 
else 


includeStackTop--; 
return '['; 


H 
H 
if (!preprocess && (c -- T. [| c == yy) 
fputs(WARNING PREFIX "delimiter [/] found without preproc. on\n", stderr); 


if (c es 'An' 
includeStackLines[includeStackTop]--; 


return C; 


} 


void printSymbolTable(const CMN Compiler *compiler) 
puts("SYMBOL TABLE:"); 


for (uinti16 t i = 0; i < compiler->symbolCount; ++i) 
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putchar(' '); putchar(' '); 


for (uint8 t j = 0; j < CMN STRING PSEUDOHASH SIZE; ++j) 
putchar(compiler->symbolTable[i * CMN STRING PSEUDOHASH SIZE + j]); 


putchar('\n'); 
H 


void printBytecodeComment(const uint8 t *instruction, FILE *f, const char 
*comment ) 


1 
if (!(*(instruction + 1) & CMN MASK INSTR CON)) 
fprintf(f," oD 


fprintf(f," # %s",comment); 


yoid printBytecodeAsText(const uint8_t *bytecode, FILE *f, uint8_t comments) 
bytecode += CMN_BYTECODE_HEADER_SIZE; 


uint32_t addr = 0; 
while (1) 
char str[16]; 


CMN instrToStr(bytecode, str); 
fprintf(f,"%06x: %s",addr,str); 


if (comments) 
switch (*bytecode) 


case CMN_OPCODE_DES: 
DU (*(bytecode + 1)) 


break; case CMN_DES_IF: printBytecodeComment (bytecode, f,"if"); 
break: case CMN DES ELSE: printBytecodeComment (bytecode,f,"else"); 
break; case CMN DES LOOP: printBytecodeComment (bytecode, f," loop"); 
break; case CMN DES IF END: printBytecodeComment (bytecode, f, "end if"); 


case CMN DES LOOP END: printBytecodeComment (bytecode, f, "end 
loop"); break; 
case CMN DES LOOP BREAK: printBytecodeComment(bytecode, f, break"); 


break; 
b v: case CMN DES FUNC: printBytecodeComment (bytecode, f, func"); 
reak; 
b D case CMN DES EXIT: printBytecodeComment (bytecode,f,"exit"); 
reak; 
b hs case CMN DES LABEL: printBytecodeComment (bytecode, f," label") 
reak; 
b i case CMN DES GOTO: printBytecodeComment (bytecode,f,"goto"); 
reak; 
d default: break; 
Break: 
default: 
if (*bytecode != CMN_OPCODE_COC) 
uint32_t c = CMN_instrGetConst (bytecode); 
if (*bytecode == CMN OPCODE CON || c != 0) 
printBytecodeComment (bytecode,f,""); 
fprintf(f,"%u (49 x)",c,c); 
break? 
J 
H 


fputc('\n',f); 


if (bytecode == CMN_OPCODE_END) 
break; 


bytecode += 2; 
} addr++; 
H 


void printInterpreterError(CMN Interpreter *interpreter, uint8 t status) 
const char *errStr - "unknown"; 
switch (status) 


case CMN INTERPRETER ERROR OPERATION: 
errStr - "illegal operation"; break; 


case CMN INTERPRETER ERROR CALLSTACK: 
errStr - "call stack overflow"; break; 


case CMN INTERPRETER ERROR ZERODIV: 
errStr - "division by zero"; break; 


case CMN INTERPRETER ERROR BAD CALL: 
errStr - "unknown function call"; break; 


case CMN INTERPRETER ERROR MEMORY: 
errStr - "accessing our of bounds memory"; break; 


case CMN INTERPRETER ERROR STACK OF: 
errStr - "stack overflow"; break; 


char instrStr[16]; R . 
CMN_instrToStr(interpreter->currentInstruction, instrStr); 


fprintf(stderr,ERROR PREFIX "runtime, (step %u, instr. Ox?96lx: %S): 9esNn", 
interpreter->step, (interpreter->currentInstruction - interpreter->bytecode 


CMN_BYTECODE_HEADER_SIZE) / 2,instrStr,errStr); 


void printCompilerError(uint8_t error) 
const char *errStr = "unknown"; 
switch (error) 


case CMN_COMPILER_ERROR_BAD_TOKEN: 
errStr = "bad token"; break; 


case CMN_COMPILER_ERROR_UNEXPECTED_TOKEN: 
errStr = "unexpected token"; break; 


case CMN_COMPILER_ERROR_UNEXPECTED_END: 
errStr = "unexpected end"; break; 


case CMN COMPILER ERROR BYTECODE TOO BIG: 
errStr - "not enough space for bytecode"; break; 


case CMN COMPILER ERROR UNKNOWN NAME: 
errStr - "unknown name"; break; 


case CMN COMPILER ERROR REDEFINED: i 
errStr = "name redefined (or name hash collision)"; break; 


case CMN_COMPILER_ERROR_UNSUPPORTED: 
errStr = "not supported"; break; 


case CMN_COMPILER_ERROR_PARSE_STACK: 
errStr = "parse stack overflow"; break; 


case CMN_COMPILER_ERROR_SYMBOL_TABLE: 
errStr = "symbol table overflow"; break; 


default: break; 


fprintf(stderr, ERROR_PREFIX "compiling (%s, line %u, \"%s\"): %s\n", 
includeStackNames[includeStackTop 
includeStackLines[includeStackTop 
compiler.tokenizer.tokenString, 
errstr); 


' 


En printHelp(void) 


puts("comun programming language (language v | pe [^4 
He i g l g l g " CMN_LANG_VERSION_STRING 
", library v" CMN LIB VERSION STRING ")"); 
puts(" by drummyfish, released under CCO 1.0 (public domain) di 
puts(" Input file with extension .cmb is considered binary bytecode."); 
puts(" possible options:"); i 
puts -h print help and exit"); 
puts(" -aS ass argument S to input program"); 
puts(" -C ranspile to C"); 
puts(" -M transpite to comun"); 
puts(" -B compile to bytecode binary "ys 
puts(" -T compile to bytecode (text)" 
puts(" -p enable preprocessor" 
puts(" -pi output first preprocessing stage"); 
puts(" -p2 output second preprocessing stage" 
puts(" -P2 output second preprocessing stage (non-minified)"); 
puts(" -e estimate required memory"); 
puts(" -S run and measure") 
puts(" -n preserve similar transpiled names"); 
puts(" -b eautify"); 
puts(" -m minify"); 
puts(" -ON set optimization level N (0 - 3), default is 1"); 
} puts(" -d debug mode"); 


uint32_t bytecodeSize(const uint8_t *bc) 
uint32_t result = 0; 
bc += CMN BYTECODE HEADER SIZE; 
while (*bc !- CMN OPCODE END) 
bc += 2; 


; 
result++; 


return result; 


} 


const char *pointerIndexToName(const CMN Compiler *compiler, uint32_t index, 
uint8_t typeEnv) 


if (index < 16) 
Em Naneta] 


. tmpName[1 
return  tmpNam 


index -- 16; 
.tmpName[CMN STRING PSEUDOHASH SIZE] = 0; 
if (compiler != 0 && 

oh 


N_compilerGetSymbol(compiler,'@' + typeEnv, index,_tmpName) ) 
return _tmpName + 1; 


.tmpName[0] = 'p'; 

_tmpName[1] = 'O' + (index / 100) % 10; 
_tmpName[2] = 'O' + (index / 10) % 10; 
_tmpName[3] = '0' + index % 10; 
_tmpName[4] = 0; 


return _tmpName; 


} 


const char *functionIndexToName(const CMN_Compiler *compiler, uint32_t index, 
uint8_t isExternal) 


_tmpName[CMN_STRING_PSEUDOHASH_SIZE] = 0; 


if (compiler != © && CMN compilerGetSymbol(compiler,isExternal ? 'e' : 'f', 
index, tmpName)) 
return  tmpName; 


tmpName[0] = 'f'; 


if (!isExternal) 


_tmpName[1] = 'u'; _tmpName[2] = 'n'; _tmpName[3] = 'c'; 
else 

_tmpName[1] = 'e'; _tmpName[2] = 'x'; _tmpName[3] = 't'; 
_tmpName[4] = 'O' + (index / 100) % 10; 
_tmpName[5] = 'O' + (index / 10) % 10; 
_tmpName[6] = '0' + index % 10; 
_tmpName[7] = 0; 


return _tmpName; 


} 


/* Guesses if a Sequence of instructions represents a push of a string literal. 
„Returns length of this literal (0 means no string literal detected). */ 
uinti6 t instructionsAreStringLit(const uint8 t *instr, uint8 t minLen) 
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uinti6 t result 
uint8 t typeEnv 


0: 
CMN. instrTypeEnv(instr); 


while (instr[0] == CMN OPCODE CON && (instr[1] & CMN MASK INSTR NOPOP) && 
CMN instrTypeEnv(instr) -- typeEnv) 


1 
uint8 t v - CMN instrGetConst(instr); 


if(v«' ' |] v» 1326 || ves" Jp v s= '[* HE v == ']') 
break; 


resulte; 
instr += 4; 


} 


return result >= minLen ? result : 0; 


H 
d format(FILE *f, uint8 t indent, uint8 t keepComments) 


CMN Tokenizer t; 
CMN | tokenizerInit(&t); 


int c = 'a'; 

uint8_ t spaces = 0; 

uint8 t previousToken = CMN_TOKEN_ERROR; // use error as "no value" 
uint8_t inComment = 0; 


while (c != EOF) 


c = fgetc(f); 
uint8 t val - CMN tokenizerFeedChar(&t,c !- EOF ? C : 0); 


if (keepComments) 
if (inComment) 
if (t.state !=  CMN TOKENIZER COMMENT) // end of comm. 


inComment - 0; 
putchar('\n'); 


else 
putchar(c); 


else if (t.state == _CMN_TOKENIZER_COMMENT) // start of comm. 


inComment = 1; 
putchar('#'); 


H 
if (val == CMN TOKENIZER TOKEN) 
if (indent) 
val - CMN identifyToken(t.tokenString); 
if (val == CMN TOKEN END || val == CMN TOKEN ELSE) 
if (spaces « indent) 
return 0; 


else i 
spaces -= indent; 


if Pre auoe == CMN_TOKEN_END && // separating newline 
'= CMN TOKEN END && val != CMN TOKEN ELSE) 
val -- CMN TOKEN FUNC && previousToken !- CMN TOKEN ERROR) IB 
(val == CMN TOKEN BRANCH || val == CMN TOKEN LOOP) & 


previousToken !- CMN TOKEN FUNC && previousToken != CHIN | TOKEN ELSE && 


previousToken !- CMN TOKEN BRANCH && previousToken Iz 
CMN_TOKEN_LOOP) ) 


putchar('\n'); 


for (uint8_t i = 0; i < spaces; ++i) 
putchar(' '); 


r 


else 


if (previousToken != CMN_TOKEN_ERROR) 
putchar (' '); 


printf("%s",t.tokenString) ; 
if (indent) 
if (val == CMN TOKEN BRANCH || val == CMN TOKEN LOOP | | 


val == CMN_TOKEN_FUNC || val == CMN_TOKEN_ELSE) 
spaces += indent; 


putchar (indent ? '\n' : '£'); 


previousToken - val; 


l 
else if (val == CMN TOKENIZER ERROR) 
return 0; 


return 1; 


// include backends here so they have access to previous functions 
#include "backend c.h" 
#include "backend comun.h" 


int main(int argc, char **argv) 


uinti6 t measureSymbolCount - 0, measureCallStackMax - 0; 
uint32 t measureBCSize = 0 meaSureStackTopsMax[4] ; 

const char *pargv[MAX . ARGS|; 

uint8 t pargc - 0; 

uint8 t preserveNames = 0; 

uint32_t optimizations = 01; 

uint8_t debug = 0; 


for (uint8_t i = 0; i < 4; ++i) 
measureStackTopsMax[i] = = 0; 


for (uint8_t i = 1; i < argc; ++i) // load CLI arguments 


const char *arg = argv[i]; 


if (arg[0] == '-') 
if (arg[1] == 'h' && arg[2] == 0) 
printHelp(); 
return 0; 
lise if (arg[1] == 'C' && arg[2] == 0) 


mode = MODE_C; 


e SEMI (arial eov. && arg[2] == 9) 
mode = t 
e Eis if (are[1 == !d' && arg[2] == 0) 
e se iF ( (arara == 'B' && arg[2] == 0) 
mode = " 
e Se LR Graft fst && arg[2] == 0) 
mode = 
else if E == "e! ga arg[2] == 0) 
mode = MO ESTIMATE; 
else if (arg[1 " 'p' && arg[2] -- 9) 
preprocess = 
e Papas E ERE && arg[2] == 0) 
mode = t 
e se if arg E & arg[2] == 0) 
mode = H 
else if targi == 'D' && arg[2] == 0) 
mode = MO _BEAUTIFY; 
else if caroli al && arg[2] == 0) 
preserveNames t 
: se if (arg[1] == '0' && arg[2] !- 0 && arg[3] == 0) 
a (arg[2]) 
case optimizations = 0; break; 
case optimizations - 01; break; 
case optimizations - 02; break; 
case : optimizations = 03; break; 
default: break; 
} H 
è se if (arg[1] == 'a') 
pargv[pargc] = arg + 2; 
} pargc++; 
else if (arg[1] == 'p' && arg[2] == '1' && arg[3] == 0 
{ 


preprocess = 1; 
mode = MODE | PREPROC1; 


9) i se if ((arg[1] == 'p' || arg[1] == 'P') && arg[2] == '2' && arg[3] == 
reprocess - 
pode = MODE | PRÉPROC2; 
} preprocessorMinify = 'arg[1] == 'p'; 
fo 
printError("bad CLI option"); 
return 1; 
H 
else 
if (sourceFile == 0) 
sourceFile - arg; 
else 
printError("multiple source files"); 
return 1; 
} 
H 
if (sourceFile == 0) 


printError("no source file"); 
return 1; 
a (mode == MODE_MINIFY || mode == MODE_BEAUTIFY) 
FILE *file = fopen(sourceFile,"r"); 
if (!file) 
printError("couldn't open input file"); 
return 1; 
uint8_t state = 
format(file,mode == MODE BEAUTIFY ? 2 : 0,mode == MODE BEAUTIFY); 
fclose (fite); 
return !state; 


} 


int sourceNameLen = 0; 


while (sourceFile[sourceNameLen] !- 0) 
sourceNameLen++; 


if (sourceNameLen >= 4 && sourceFile[sourceNameLen - 4] == '.' && 
sourceFile[sourceNameLen - 3] == 'c' && sourceFile[sourceNameLen - 2] = 


&& sourceFile[sourceNameLen - 1] == 'b') 
// binary bytecode passed as input file 
preserveNames = 0; 
FILE *bcFile = fopen(sourceFile, "rb"); 
if (!bcFile) 
fprantt(stderr, ERROR_PREFIX "couldn't open bytecode \"%s\"\ 


n", sourceFil 
return 1; 


uint32_t bcSize = fread(bytecodeMem, 1, BYTECODEDMEM_SIZE, bcFile) ; 
if (bcSize == BYTECODEDMEM_SIZE) 
char tmpChar; 
if (fread(&tmpChar,1,1,bcFile) ) 
fclose(bcFile); 
printError("input bytecode too large"); 
return 1; 
} J 
uint8 t sanity = CMN bytecodeCheckSanity(bytecodeMem, bcSize); 


* 


it (fread(bytecodeMem, 1,BYTECODEDMEM SIZE,bcFile) == BYTECODEDMEM SIZE) 
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char tmpChar; 
if (fread(&tmpChar,1,1,bcFile)) 
fclose(bcFile); 


printError("input bytecode too large"); 
return 1; 


H 
H 
fclose(bcFile); 


zy uint8 t sanity - CMN bytecodeCheckSanity(bytecodeMem, BYTECODEDMEM SIZE); 


if (sanity !- CMN BYTECODE SANITY OK) 
const char *errStr - ""; 


switch (sanity) 


case CMN BYTECODE SANITY ERROR HEADER: errStr - " (bad header)"; break; 
case CMN BYTECODE SANITY ERROR CHECKSUM: errStr - " (checksum)"; break; 
case CMN BYTECODE SANITY ERROR INSTR: errStr - " (bad instr.)"; break; 
case CMN BYTECODE SANITY ERROR NO END: errStr - " (no END)"; break; 
default: break; 

H 

fprintf(stderr," ERROR: malformed bytecode%s\n",errStr); 

n return 1; 


else // normal text source code file as input 
openIncludeFile(sourceFile); 
if (preprocess) 
if (debug 
printDebug("preprocessing"); 
CMN. compilerInit(&compiler,preprocBytecodeMem, BYTECODEDMEM SIZE, symbolMem, 
SYMBOLMEM SIZE, openInc LudeFile) ; 


CMN_preprocessorInit (&preprocessor, preprocessorMinify, , 
mode == MODE_PREPROC1 ? preprocessorToOut : preprocessorToCompiler); 


while (1) 


if (!includeOK) 
return 1; 


char sourceChar - getSourceChar(); 


if (CMN ppeproces sor Peedthar (&ápreprocessor,sourcechar) 
== CMN_PREPROCESSOR_ERROR) 


printError("preproc.: bad token in underlying code"); 
return 1; 
if (compiler.state != CMN_COMPILER_OK) 


printError("preproc.: compiler error"); 
printCompilerError(compiler.state); 


return 1; 
if (sourceChar == 0) 
} break; 
3 
if (mode == MODE_PREPROC1) 
return 0; 


if (preprocess 
openIncludeFile(0); // open the interpreter output as a source file 


if (mode == MODE PREPROC2) 
while (1) 
í char c = getSourceChar(); 
if (c) 
putchar(c); 


else 
break; 


return 0; 


CMN compa ter Init(&com iler DytecodeMem, BYTECODEDMEM. SIZE, symbo lMem, 
SYMBOLMEM SIZE, openIncludeFile); 


if (debug) d 
printDebug("compiling"); 


while (compiler.state == CMN_COMPILER_OK) 


if (!includeOK) 
return 1; 


char sourceChar = getSourceChar(); 
CMN_compilerFeedChar (&compiler, sourceChar ) ; 


if (mode == MODE_MEASURE) 
if (compiler.symbolCount > measuresmbo Lcount) 


measureSymbolCount - compiler.symbolCount; 
if (sourceChar == 0) 
break; 


if (compiler.state !- CMN COMPILER OK) 


printCompilerError(compiler.state); 
return 1; 


} // if (normal text source code) 


programs/minilib.cmn 


if (mode == MODE_MEASURE) 
measureBCSize = bytecodeSize(bytecodeMem) ; 


if (debug && optimizations != 0) 
printDebug("optimizing"); 


CMN_bytecodeOptimize(bytecodeMem, optimizations, &compiler ) ; 


switch (mode) 


case MODE_RUN: 
case MODE_MEASURE: 


t if (debug 
printDebug("running"); 


if (!CMN inter roter init (ainterprecer, bytecodeMem interpreterMem, 
INTERPRETERMEM SIZE, MIN CELLS, ioFunc, 0, pargc, pargv) ) 


printError("not enough memory for interpreter"); 
return 1; 


while (1) 
t int status = CMN_interpreterStep(&interpreter,1); 
if (status != CMN_INTERPRETER_OK) 
if (status != CMN_INTERPRETER_END) 


printInterpreterError(&interpreter, status); 
return 1; 


break; 


if (debug) 
interpreterDebugPrint(); 


if (mode == MODE_MEASURE) 


if (interpreter.callStackTop > measureCallStackMax) 
measureCallStackMax = interpreter.callStackTop; 


for (uint8_t i = 0; i < 4; tti) 
if (interpreter.pointers[i] !- O && 
interpreter.pointers[i[[0] > measureStackTopsMax[i]) 
} measureStackTopsMax[i] = interpreter.pointers[i][0]; 
H 
ir (mode == MODE_MEASURE) 
puts("\n\nmeasured metrics:"); 
printf(" bytecode instructions (orig., optim.): %u, %u\n", 
measureBCSize bytecodeSize(bytécodeMem]); 
printf(" symbols: %d\n",measureSymbolCount) ; 
printf(" executed steps: au Mn an EET Precer.s ten) 
printf(" max call stack depth: %d\n",measureCallStackMax) ; 
printf(" max stack top (0, 8, 16, 32): %d, %d, %d, %d\n", 


measureStackTopsMax[0 measureStackfopsMax[1], measureStackTopsMax[2] 
measureStackTopsMax[3 j 


i 
break; 
H 
case MODE BC: 
1 uint32_t i = 0; 
while (i < CMN_BYTECODE_HEADER_SIZE || bytecodeMem[i] != CMN_OPCODE_END) 


utchar(bytecodeMem[i]); 
Echar bytecodeMen 131/41); 


i += 2; 


putchar(0); 
reparto) 
reak; 


; 
H 
case MODE BC TEXT: 
prantByteeodeASText (bytecodemem, stdout 2); 
reak; 


case MODE_C: 
if (!printBytecodeAsC(bytecodeMem, stdout, preserveNames ? &compiler : 0)) 


printError("can't transpile this code"); 
return 1; 


break; 


case MODE_COMUN: 
if (!printBytecodeAsComun(bytecodeMem, stdout, preserveNames ? 
&compiler : 0)) 


printError("can't transpile this code"); 
return 1; 


reak; 
case MODE ESTIMATE: 
uint32 t mems[4], ptrs[4]; 
CMN estimateMemory(bytecodeMem, MIN CELLS, mems, ptrs); 


for (uint8 t i = 0; i < 4; ++i) 
printf("env 96d: %d cells, %d pointers\n",i,mems[i],ptrs[i]); 


break; 
default: break; 
if (debug 
pe bdDug("end"); 


return 0; 
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# small comun library of generally useful functions 

# by drummyfish, released under CCO 1.0, public domain 
# 

# 


TODO: exp? strfind 


internal library pointers 
~_mLibPtrA:0 # tmp pointer 
~_mLibPtrB:0 # tmp pointer 


~_mLibTmpMem:3 # tiny tmp memory 
~_mLibVarA:0 # tmp variable, 2nd cell of tmp memory 
~_mLibVarB:0 # tmp variable, 3rd cell of tmp memory 


$_mLibTmpMem>_mLibVarA 
$>_mLibVarA 
$_mLibVarA>_mLibVarB 
$>_mLibVarB 


GENERAL 


abs: $0 -1 << ? -1 
min: >! 2? ><. ^. 
max: <' 2? >< . ^ , 
minS: >>' ? ><. ^ 
maxS: <<' ? >< . ^ 
min3: min min 
max3: max max . 


Absolute value. 

Minimum of two values. 
Maximum of two vlaues. 
Minimum of two signed values. 
Maximum of two signed values. 
Minimum of three values. 
Maximum of three values. 


HEHEHEHEHE 


i Interpolates from $3 to $2 by a factor of $1/$0. 
erp: 
$5 $3 > ? # if going from higher to lower, swap 
$3 $3 $:5 $:3 
$0 $2 - $:2 


>< $2 $4 - * >< / >< A+ 


# Hashes input number to a 16 bit value, can also be used as a pseudorandom 
ig generator: 
ash: 


$0 +b010000000 * + +xffff % 
$0 +b100000000 / |! +xffff % 
$0 +b000001000 * + +xffff % 
$0 +b000000100 / |! +xffff % 
$0 +b000010000 * + +xffff % 
$0 +b100000000 / |! +xffff % 


# 
# String is a sequence of ASCII character codes, considered starting stack top 
# and continuing downwards, ending with value 0. 
# Reads newline-terminated string from input, pushes it as a zero terminated 
# string in reversed order, without the newline. 
strRead: 
0 
@@ 
<- 
$0 10 - ? 
^d 
strReverse 


# Prints values from memory stack up to stack top. 
stackPrint: . 
$$ arrayPrint 


# Computes string length. 
strlen: 

$0» mLibPtrA 

ic} 


@@ : 
Sem ibPtrA 9-22? 


++ 
$<_mLibPtrA 


# Expects two strings which won't be popped, pushes 1 if they're equal, else 0. 
strEq: 

$03 mLibPtrA 

$0» mLibPtrB 


@@ : 
en ibPerg o=? 
! 


<_mLibPtrB 
$<_mLibPtrB 


@@ 
mLibPtra $ mLibPtrB !- ? 


| mLibPtrA 0 = ? 
1 !. 


« mLibPtrA 
« mLibPtrB 


# Left-pads a string to length $1 with character $0. 


strPad: 
$: mLibVarA 
$: mLibVarB 


strLen $ mLibVarB >< - 


COo 9 <<= ? 
^ 1Q 


$ mLibVarA »« 


# Reverses a zero-terminated string. 
strReverse: 
strLen arrayReverse ^ 


A >< ^ 


# Square roots a number using binary search. 


sqrt: 
© $1 2 / # stack: x lower upper 
@@ 
$0 $2 - 1 <= ? 
!Q 


$1 $1 + 2 / 
$0 $0 * 


$4 > ? 


$:1 
$:2 


# stack: x lower upper middle middle^2 


$0 $0 * $3 «- ? 
>< 


A >< A 


# Computes integer logarithm of $0 with base $1. 


log: 
8 # result 
1 # exponentiated value 
1 # previous exponentiated value 


@@ 
E 1 $4 = ? # equality has to be checked, considering overflow may happen 
nex 

!Q 

2 ++ $:3 # compute next power 

1 $5 * $:2 

1 $4 > $2 $2 <= || ? # new power > x or new <= previous (overflow)? 
2 -- $:3 

t 

1 $:1 # current -> previous 


NN >< AN ><A 


# Computes 8bit sine function approximation with quadratic curve, value 256 on 
geanput represents the whole period (2 * pi), output value is between 0 and 


sin8: 
$0 256 % 64 / # quadrant 
>< 64 % 


$129 1- ? 
63 »« - 


63 - $0 * 32 / 


>< 1 <= ? 
255 »« - 


# Computes 8bit cosine function approximation. 
cos8: 
64 + sin8 


# Computes factorial recursively. 
fact: 
? 
$0 -- fact * 
c. 4. 


r 


# Checkes if number is a prime. 
isPrime: 
$0 1 <= 
? 
^ 0 # 0 and 1 are not primes 


$0 2 / 


COo de 
? 


^^414 lt. 


È 


$1 $1 % 0 = 
? 


AAO!. 
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NUMBER PRINTING AND CONVERSION TO/FROM STRINGS 


# Internal function, converts number to base passed in variable A. 
_numToStrBase: 
0 >< 
@@ ; 
$0 $ mLibVarA % 


$0 10 « ? "O" ; "A" 10 - 
d ann 
$ mLibVarA / 


$0 0 =? 
!Q 


numToStrBin: 2 $: mLibVarA  numToStrBase . 
numToStrHex: 16 $: mLibVarA  numToStrBase . 
numToStr: 10 $: mLibVarA  numToStrBase . 


# Converts a signed number to zero-terminated string. 
numToStrs: 
$0 0 << 


-1 >< - 1+ 
numToStr 


numToStr 


numPrint: numToStr --» . 
numPrintS: numToStrS --> . 
numPrintHex: numToStrHex --> . 
numPrintBin: numToStrBin --> . 


stack), S number from decimal string (zero terminated reverse pushed on 
stac 
# negative numbers are also supported, validity is not checked. 
numFromStr: 
$9 "-" =? 
^ numFromStr -1 * 


ü array. here means N valus on the stack and the value N pushed afterwards. 
# Functions working with arrays normally leave this unchanged without popping, 
# e.g. sorting an array will just change orders of the items in the array. 


# Prints out given array (from lowest memory address towards stack top). 
arrayPrint: 

$0» mLibPtrA 

$: mLibVarA' 


QQ # move pointer A to bottom of array 
$ mLibVarA 


? 
-- $: mLibVarA 


programs/test.cmn 


# general testing program for comun, tests most of its features 
© 10 "testing:" --> 


SXTEEUDC: 4 tests the exit command 


H 
me) 


unusedFunc: # function that won't be called, basic test of optimization 
123 
? 


++ 
myFunc: # just some function 
12-3 
? 
0 "abc" --» 
; ! 
fact: # recursive factorial 
? 
$0 -- fact * 
E 
##0 # push 0 
? 
~abc # sneakily declare pointer. in non-executed branch, shouldn't matter 
# this might crash the program (if stack top is near 0 now) 


$4 
0 10 "ERROR (a)" --5 


$« mLibPtrA 
PATO 


@@ # now go up and print 
$i 2 iig [ 


$ mLibPtrA numPrint " " -> 
$>_mLibPtrA 


# Reverses items in given array. 
arrayReverse: 

$0» mLibPtrA 

$: mLibVarA' 


@@ ; 
$ mLibVarA 


? 
-- $: mLibVarA 
$« mLibPtrA 

u^ 


$0» mLibPtrB 
$« mLibPtrB 


@@ 
$_mLibPtrA=_mLibPtrB 2 != ? 
L 


$_mLibPtrA $_mLibPtrB 
$:_mLibPtrA $:_mLibPtrB 


$>_mLibPtrA 
$<_mLibPtrB 


# Sorts an array in ascending order (towards stack top) with bubble sort. 
arraysort: 


@' 
$0>_mLibPtrA 


$<_mLibPtrA 
$« mLibPtrA 


$0 


1 
$ mLibPtrA $« mLibPtrA $ mLibPtrA 
<' ? 

>< 

$:_mLibPtrA $>_mLibPtrA $:_mLibPtrA $<_mLibPtrA 


AN 


# Sorts an array in descending order. 
arraySortDesc: 
arraySort arrayReverse 


$$ 2 $+0 $$ $4 - # stack top now: 4 
$' $$ >< - + 


A8. che i 
0 10 "ERROR (b)" -- 


lateFunc # call a function that will be defined later, pushes 10 
"gg # comment in string, should be pushed 

# "abc" # # string in comment, shouldn't be pushed 

+ 


# stack now: 45 

# let's now try out most operations: 

+xf +b011 - * 11 / -d02 // 50 + -10 4 %% + 1000 >< / -b100 +x3 != + $0 -1 << + 
-*bii1 |! 1+012 ?? + 

4 48 is here #1 2 3 4 $ # push the 48 


48 12 ? 
0 10 "ERROR (c)" -- 


# let's try some complicated control structures: 
1 


? 
# here 
12= 
? 
# not here 
@ 


@ 
9 10 "ERROR (d)" --> 
ig 


1@ 
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20 $abc $:varO 


# here 
1 >var20 
30 $:var20 
CO 
var20>0 
1 
@ 1@ + + 
stBackup>0 
!Q 
stBackup=0 + 
se varo 
1-0 # should push 2 
0-2?! * 
3-4 


45 12 ? 
0 10 "ERROR (g)" --> 
I" 


' & not here 


TE 5 fact 120 !- ? # test recursion 
0 10 "ERROR (h)" --> 
@ I 
? 
++ 
5 i 
f # test simple goto: 
? >skipLabel 
++ 
0 10 "ERROR (i)" --> 
Q b ~:skipLabel 
++ # test type environments: 
55 
>8 
4 122 -8 
9 10 "ERROR (e)" --> O 2 * ++ 3 * # should be 77 
hes >16 
~16 
: 0 10 / # should be 7 
exitFunc 232 
-32 
2 0 $0 * # should be 49 
0 10 "ERROR (f)" --» E 
l. = 
O + # these operations do nothing (test optimizations) 
# test pointers now: i 7 
~var0:0 1 // 
~var20:20 o 
~stBackup | 
a0 err ^90 19 "ERROR (j)" --> 
-var20 # same name but in different type env. i G) 
$0>stBackup © 10 "ALL SEEMS OK" --> 
13 $:abc # abc is declared above lateFunc: 
$var20>var0 19 


programs/test_minicomun.h 


# These are some general functions and tests runnable with minicomum. 
@@ # test divisors 
$0 1 <= 


printNum: 

$0 2 # no divisors greater than 1 found? 
0 >< AA 1 !Q 
@@ 

$0 10 % "QO" + >< 

10 / $1 $1% 0 = | er 

? # is divisible? 
$0 0 = ? ^ ^ Q !Q 
!@ $ 

n PX 
--> 


printNumS: # prints number as signed, doesn't pop 12345 
$0 -12 / > 
7 # Negative? © "stack top: " --> $$ printNum ^ 10 -> 
-1 >< - 1+ x 
. © "stack top (should be the same): " --> $$ printNum ^ 10 -> 
printNum 
© "factorial of 6 (recursive and iterative): " --> 
factR: # computes factorial recursively 6 factR printNum ^ " " -> 
2 6 factI printNum ^ 10 -> 
$0 -- factR * 
i A © 10 "primes up to 100: " --> 
© # tested number 
COo 100 = ? 
ee # computes factorial iteratively T. o 
Q' $0 isPrime ? 
>< $0 printNum ^ 10 -> 
$1 
* 
>< ++ 
© "pointer manipulation: " --> 


$$ 2 $+0 $$ $4 - # stack top now: 4 
: " : " A $' $$ >< - + 
isPrime: # checks if a number is prime 


ae 10 =? 
"A 0 #0 and 1 are not primes , 9 10 "OK" --> 
! $02 / ' @ 10 "ERROR" --> 
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programs/imglib.cmn 


imglib, a small library for working with RGB raster images 
by drummyfish, realeased under CCO 1.0, public domain 


Before including this library define the following: 


- IMG mem: image memory, pointer to a block of memory in type env. 8 
- IMG out: library output function, pops one value and outputs it 


You are responsible for not creating images that wouldn't fit in the reserved 
memory (image size is: width * height * 3). This library is simple! Drawing 


iste ib Sie A Sb SR AE AR UE 


primitive and done with naive algorithms. 


# TODO: 
# - functions: IMG_fillRect, IMG_drawRect, IMG_flip, IMG_rotate 


~_IMG_size:2 
~_IMG_ptr:0 


IMG BLACK: 000. 

IMG WHITE: 255 255 255 . 
IMG GRAY: 128 128 128 . 
IMG RED: 25500. 

IMG GREEN: 0 255 0 . 

IMG BLUE: 0 0 255 . 

IMG YELLOW: 255 255 0 . 
IMG PINK: 255 0 255 . 


# Pops 2, creates new image with size $1 x $0. 
IMG new: 
$» IMG size $: IMG size $« IMG size $: IMG size 


# Pushes current image width. 
IMG width: 
$ IMG size 


# Pushes current image height. 
IMG height: 
$2 IMG size $ IMG size $« IMG size 


# Outputs image as ASCII art. 
IMG toASCII: 


8 
$IMG mem» IMG ptr 
ic} 


[ue height 
IMG width 


"#0Vaxsflc/!;,.- " 
0 -8 $ IMG ptr »0 $» IMG ptr ~0 
0 -8 $ IMG ptr »0 $» IMG ptr ~0 


0 -8 $_IMG_ptr »0 $>_IMG_ptr -0 
++3/16 % ++ $ -> 
-17 $+0 

^ 

10 IMG out 


# Outputs raw binary image RGB data. 
IMG toRAW: i 
IMG_width IMG_height * 3 * 


~8 $IMG mem» IMG ptr -0 


Q' 
0 


-8 
$ IMG ptr $» IMG ptr >0 
-0 


IMG out 


# Outputs image in ppm format. 
IMG toPPM: 
"P" IMG out "6" IMG out " " IMG out 
IMG width | IMG outNum 
" " TMG out 
IMG height IMG outNum 
" " IMG out "2" IMG out "5" IMG out "5" IMG out 
10 IMG out 
IMG toRAW 


# Pops 5, sets a pixel at $4 $3 to RGB($2,$1,$0). 
IMG setPixel: 
$4 $4 IMG coordsOK ? 
$4 $4 IMG seekPixel 


-8 0 -0 

$2 >8 -8 $: IMG ptr $» IMG ptr 
$1 >8 -8 $: IMG ptr $» IMG ptr 
>8 ^ ^ -8 $: IMG ptr -0 


OO 
OO 


NNNANAAN 


# Pops 2, pushes 3 values (RGB) of a pixel at $1 $0. 
IMG getPixel: 
$1 $1 IMG coordsOK ? 
$1 $1 IMG seekPixel 


© -8 $ IMG ptr »0 $» IMG ptr ~0 
© -8 $ IMG ptr »0 $» IMG ptr -6 
0 -8 $ IMG ptr »0 ~0 


0090 


# Pops 3, fills an image with RGB($2,$1,$0). 
IMG fill: 
IMG width IMG height * 


-8 $IMG mem» IMG ptr -0 


Q' 
-8 0 -0 
$1 »8 -8 0 -0 
$2 >8 -8 0 -0 
$3 »8 


-8 
$: IMG ptr $» IMG ptr 
$: IMG ptr $» IMG ptr 
$: IMG ptr $» IMG ptr 


# Pops 7, draws a line from $6 $5 to $4 $3 with color RGB($2,$1,$0). 
IMG drawLine: 

$4 $7 - $:5 # dx 

$3 $6 - $:4 # dy 


$4 $0 * $4 $0 * > # abs(dx) > abs(dy) 


$0 $6 $6 ?? O << ? 
# swap coordinates 


$7 $6 - $:8 4 xO += dx 
$5 -1 * $:6 # dx *= -1 
$6 $5 + $:7 # yO += dy 
$4 -1 * $:5 # dy *= -1 


x += dx <0? -1:1 


# stack now: x0 yO dx dy R G B abs(dx)>abs(dy) i 


e 5 $7 # dy dx 


37? 
>< 


2 * >< // 


$c i * dy dx / dx dy 
9 $9 8x 


x< Il 


4? 
$2 + >< $3 + >< #x += i; yt=c 


' $3 + >< $2 + >< #x+c;y+i 


7 $7 $7 IMG_setPixel ^ 


++ 
g $8 $8 ?? >= ? 


ANA ANA AAA 


# Pops 7, draws circle at $6 $5 with radius $4, width $3, color RGB($2,$1,$0). 
IMS uraacirele: 


@@ # for dx 
$5 -- 
@@ # for dy 
# if dx^2 + dyA2 < r^2 && dx^2 + dy^2 > (r - w)^2 
$1 ++ $O ++ * $1 ++ $0 ++ * + $0 $8 $0 * < >< $8 $8 - $0 * >> && ? 
$8 $2 + $8 $2 + $6 $6 $6 IMG setPixel 
$6 $6 $6 IMG setPixel 


€ 
b 
€ 
N 

' 

€ 
00 
€ 
N 

batt 


$8 $2 + $8 $2 - $6 $6 $6 IMG_setPixel 
$8 $2 - $8 $2 - $6 $6 $6 IMG_setPixel 
$0 0 =? 
!Q 
^ 
$0 0 =? 
!Q 


AAA ANAARA 


# Pops 6, fills a circle at $5 $4 with radius $3 with color RGB($2,$1,$0). 
IMG fillCircle: 
$0 ^ ^ $0 ^ ^ $0 ^ ^ $0 $50 $20 $20 IMG drawCircle 


# Outputs a number <= 100000 with the user defined function. 
TMG outNum: 


$1 $1 / 0 !—-$11- |? 
!Q 


10 / 


$1 $1 / "O" + IMG out 
$1 $1 % $:2 
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10 / 


# Checks if coords are within image. 


IMG coordsOK: 


IMG height « »« IMG width « & 


# Seeks to pixel at given coords. 


programs/mandelbrot.cmn 


f. program that computes and draws Mandelbrot set, fixed point with 10 frac. 
1ts 


mandelbrot: 


# x y result iteration cx cy tmp 
40 $3 $ 


1 


O02 gt 


$1 $0 * $1 $0 * 


€ 
om. BQ 
N 
€ 
N 
* 


& (cx * cx) 


€ 
H 
€ 
e 

* 


programs/life.cmn 


plementation, wrapping space 


# simple game of life im 
# TODO: use ~8 for cells 


- 1024 // $6 + 
512 // $6 + $:2 


// 1024 * 
a 1024 // $1 $0 


# tmp = (cx * cx - cy 


(cx * cy) / 512 + y 
tmp 


y * cy) // 1024 > 1000000000 
1024 // * 1000000000 » ? 


-currentState:2000 # increase sizes if board size increases 


-nextState:2000 


-stBackup:0 
~cell:0 


WIDTH: 50. 
HEIGHT: 20 . 


draw: 
$currentState»cell 


WIDTH HEIGHT * 


$0 WIDTH % 0 = ? 
10 -> 


$cell ? "#" ; "on 
$»cell 


getCell: # get Nth cell with wrapping 


$0 0 << ? 
WIDTH HEIGHT * >< + 


' WIDTH HEIGHT * % 
$currentState>tmp 


$+tm 
$tmp^ 


evolveCell: # in: 9 bin digits (neighbourhood), 


+ + + >< 


? 
++++ 


$0 2< >< 3> ||? 
(0) 


1 


© eI 


step: 


# step from current to new: 


$currentState>cell 
$nextState>cell2 


WIDTH HEIGHT * O # limit, 


# create neighbourhood 


$0 WIDTH - 1 - getCell 


$1 WIDTH - getCell 
$2 WIDTH - 1 + getCell 
$3 1 - getCell 
$cell 

$5 1+ getCell 


out: 


* cy) / 1024 + x 


new cell state 


. IMG seekPixel: 

-8 
$IMG mem» IMG ptr 
ic} 


IMG_width * + 3 * 


-8 $» IMG ptr ~0 


-1023 
QQ # for y 


-2047 
@@ # for x 


$0 $2 mandelbrot # mandelbrot(x 
# print the po 


"og" 22 -> 

$0 32 + 

$0 512 >>= ? 
^ 10 

; 


$:1 


10 -> # newline 


$1 64 + 
$0 1024 >>= ? 
^ 10 
' $:i 
^ 
$6 WIDTH + 1 - getCell 
$7 WIDTH + getCell 


$8 WIDTH + 1 + getCell 


evolveCell $:cell2 


$»cell 
$>cell2 


++ 


$1 $1 <= ? 
!Q 


AO 

# copy new to current: 
$currentState»cell 
$nextState»cell2 
quis HEIGHT * 


$cell2 $:cell 


$»cell 
$>cell2 


$0>stBackup 
$currentState>0 


H 
H 
© 
© 

eo 


OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OF 
OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO Ol 
OO OO OO OO OO OO OO OO OO OO OO OO OH OF OO OO OO OO OO Ol 
OO OO OO OO OO OO OO OO OO OO OO OO OH OF OO OO OO OO OO O 
OO OO OO OO FO OO OO OO OO OO OO OO OO OO OO OO OO OO OO Ot! 
OO OO OO FO OO KO OO OO OO KO OO OO OO OO OO OO OO OO OO OO 
OO OO OO OO FO OO OO OO OO KO OO BO OO OO OO OO OO QOO OO 
HO OO OO OO OO OO OO OO OO BO FO OO OO OO OO OO OO OO OO OO 
HO OO OF OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO 
HO OO OF OO OH OO OO OO OO OO OO OO OO OO OO OO OO OO OO OO 
oS oOo Fr p G OO GO © © oO GO € GG O0 GO 8 © oO G 8 
oo OOo o0 000000000000 o 
oo ooo o0 000000000000 o 
GR 2 oO» o4 00 OS. © So po xy (OR ©. Oe & oO. 
oo OOo Q H D OO 0a O00000 TO O O 0O 
D o G OOo Oo FDO DG a Ge GF Fe FT GF 98 FF 8 0o 
oo OOo o0 000000000000 o 
oo OOo o0 000000000000 o 
oo OOo o0 o0 0o000000000 o 
oo OOo ooo 00000000000 o 
oo OOo o0 0oc00000000000 o 
UR y & 4y © Quy 0) D oo 2 © y UR D. o. © 0b 2: (0 4 
oo OOo o0 000000000000 o 
oo OOo o0 0oc00000000000 o 
oo OOo o0 000000000000 o 
oo OOo o0 000000000000 o 
oo OOo o0 000000000000 o 
oo OOo o0 000000000000 o 
oo OOo 0000000000000 0 o 
oo OOo o0 000000000000 o 
oo OOo o0 000000000000 o 
oo OOo o0 000000000000 o 
oo OOo 0000000000000 0 o 
oo OOo o0 o0 0000000000 o 
oo OOo o0 000000000000 o 
> © © 4 © 2 © 4D © ©: © ©: D. oO © UU € O a 
oo oo co = ES o SE < E > E o E > E OC = E = E o S -o a o S E O E 
So. & 2 OO ©. © 2 oo 2 © Gy © ©. OR (e EK a (O49 
oo oo oo FOO oO oO oe oe eo 8 8G FO KF H O Oo 
oo O O O E O aO a G G GG a L O a O a 


$stBackup>0 


$>currentState # due to push 


draw 10 -> 
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we need 


att 


to shift one right 


© 10 "press key to step (q to quit)" --> 
<- 


step 
"gq" =? : 


Tinyphysicsengine 
Readme 


tinyphysicsengine 

This Is tinyphysicsengine (TPE), a small, completely public domain KISS/suckless, fixed point physically inaccurate pure C header enn 3D 
physics engine (or rather a library) mostly for entertainment purposes that's supposed to run even on tiny computers such as embedded 
even bare metal. It's written in the same style/philosophy as small3dlib, raycastlib etc. 

Keep in mind the library is not version 1.0 yet, but it's already completely usable. Basically just more polishing and testing should be done. 

TPE is NOT a "robust framework" and it is NOT physically accurate; basic things follow e equations but a lot of other things are 
empirical approximations, the main goal is to achieve SIMPLE behavior that LOOKS LIKE real world pon TPE can be used to fake many 
things (even such as e.g. car physics) just as in computer graphics we fake things such as reflections because in games we simply don't really 
notice they're inaccurate. This approach has been chosen on purpose after trying and failing to create a traditional physically accurate engine 
which is archived in the old folder; | already had physically correct collision detections and responses of rigid bodies programmed but 
eventually failed on dealing with the complexity of handling Imprecisions of fixed point in very low/high energy cases. At that point | started 
over with a completely new approach: just use soft bodies made of spheres connected with springs and fake what is possible to fake. 

The basic principles in short: TPE uses soft body physics, bodies are modelled as spheres connected by springs but the springs can be 
made stiff so that the bodies behave almost like rigid bodies, so you can simulate (fake) both soft and rigid physics. Environment in which 
bodies are placed is modelled by distance functions, i.e. you can in theory create any environment as long as you can create a function that 
for any point in space returns the closest point to the environment (functions for basic and some more complex shapes are included in TPE). 
Why does this exist? Because all other engines suck, they are either trivial or bloated, have licensing conditions, dependencies, require 
floating point unit, complex build systems, bad languages, PhD level math etcetc. TPE is a keep it simple engine for people who just want to 
add simple physics to their tiny game without being bothered by bullshit. 


features 
* KISS, suckless, pure C99, header only 
* compatible with small3dlib, easy integration (same data types, conventions, ...) 
e no dependencies, not even standard library (except for stdint header) 
* no build system 
* no dynamic allocation (malloc), not using files etc. 
* completely public domain free software, no legal worries and burdens, do whatever you want 
* no floating point, only 32 bit integer (fixed point) math 
* nice performance for smaller simulations, runs even on embedded devices such as Pokitto (32 kB RAM, 48 MHz CPU) 
* discrete collision detection with simple acceleration by bounding volumes that use no precomputation 
e soft/stiff body physics that can be used to also fake rigid body physics, built-in functions for constructing bodies 
* bodies are spheres connected by springs with simple attributes (mass, stiffness, elasticity, friction, ...), can be soft or stiff 
* environments are distance functions (can possibly be animated, i.e. dynamic, no precomputation is needed), support for any mathematically definable 
environment (even e.g. 3D fractals), predefined functions for: 
* Sphere, plane, line segment, ... 
e box (axis-aligned and arbitrary rotation) 
* cylinder and cone (arbitrary rotation) 
* heightmap 
* trivial unions of shapes 
e axis-aligned triangular prism (ramp) 
* simple bounding sphere/box acceleration 
* functions for rotations, mostly in Euler angles (no quaternions) 
* deterministic behavior 
e ray casting support (both against bodies and environments) 
* simple deactivation of bodies that don't move much for a while 
* debug render, a function that renders the 3D view of the world with a provided pixel drawing function (independent of any rendering system) 
* optional non-rotating bodies, e.g. for representing the player 
e faking ball rotation (to make single joint bodies look as if they rotate even though internally they don't) 
e built-in vector math, trigonometric functions, gravity etc. 
* compile time options to tune in specific parameters (such as body deactivation time or use distance approximation for better performance) 
* world hash 
e may in theory also be used for 2D physics in a limited way 


* simple, well commented code and examples, just a simple math, you can easily make any changes if you want 
You can probably use this to: 


* make simple to mid-complex games and entertainment visualizations such as: 
e a first person game such as a shooter or adventure 
* maybe a simple racing game 
* marble racing? 
e probably even a simple 2D game 
* camera collisions in 3D visualizations 
* etc. 
e spark your game with effects like flying objects after explosions, waving water surface, maybe even a super simple cloth and ragdoll physics 
* impress girls by showing them 3D physics running on embedded devices 
* etc. 
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limitations 

* generally NOT physically correct, for God's sake do not use this for computation of your space rocket's trajectory! 

* even though performance is good for simple simulations, it is not best possible and won't scale very much because the soft body model requires to 
make more computations and also takes more RAM (however the code is still a reasonably optimized C that should run alright) 

e yes, bodies sometimes vibrate and do weird things 

* fixed point is not extremely precise of course 

* NOT a robust framework that solves everything for you, more of a library with a set of tools that will help you easily create simple physics, you may 
need to handle many things yourself 

* the library does NOT really consider correct energies as bodies don't store information about their angular velocity etc., usually some approximation 
such as a sum of speed/velocities of all joints is used to e.g. determine if a body should be deactivated 

e do NOT create extreme situations such as extremely big or extremely small bodies or extreme velocities (probably also positions far away from the 
origin), fixed point will overflow or lose precision, this is not handled at all 

* body joint and connection count should be kept low, do not create bodies with dozens or even hundreds of joints, that will be very slow 

* made for a time tick length corresponding to about 30 FPS, hugely different ticks (like 200 or 2) lengths may behave weird or be unusable, half and 
double should probably be workable, you can try to apply interpolation etc. 

* there is no neat UBER integration method, only a "dirty" empirical algorithm that may fail in weird situations but is tested to behave nicely and 
stably in most common situations (only current joint positions are considered, connections of joints create basically just a constant acceleration after a 
threshold of their tension is passed, some basic friction and cancelling of forces is applied). Tricks are used to help stability, such as force-reshaping 
stiff bodies when their shape diverges too much from their ideal shape. 

* quantities such as energy and momentum are generally NOT conserved, they shouldn't go up but will probably go down, however you can force 
conservation of a quantity if you want (see the examples) 

* bodies are only approximated with spheres (so your 3D models won't collide EXACTLY at their bounds), other shapes (boxes, cylinders, ...) are 
usable only for the environment 

e deactivation of bodies is imperfect and may sometimes lead to e.g. a body freezing mid air, you need to handle this yourself in case it shows to be a 
problem for you 

* things such as stable contacts are not handled at all, you may encounter issues with stacking object etc., again handle this yourself (there are functions 
provided for smoothing our movement etc., these are usually enough to mostly eliminate shaking) 

* body parameters, mostly elasticity, may sometimes not work as expected because they only define the parameters of joints, however added 
connections also add elasticity etc., keep this in mind 

* the environment distance functions are not signed (no SDFs) so as to make them easier to build, i.e. inside the solid environment they don't provide 
any information about where to escape -- this is mostly okay but can sometimes cause trouble (a body stuck deep in environment won't get out by itself, 
rays casted from within a solid environment won't work accurately etc.) 

* the library doesn't try to be too smart, it is up to you to decide if you e.g. need smoothing of movement and apply it yourself (however helper 
functions for this are provided) 

e just simple discrete collision detection and resolution 

how to 


For a basic use see the hello.c example program and hello2.c as the next, then take a look at the more complex ones. Also see the library 
file itself, it is highly commented and is supposed to serve as its own documentation. 


Very basic sum up: TODO, coming soon :) 
usage rights 
tl;dr: CCO public domain, | hate intellectual property, do whatever you want 


| (drummyfish) have made this project completely myself from scratch. Everything in this repository is available under CCO 1.0 (public 
domain, https://creativecommons.org/publicdomain/zero/1.0/) + a waiver of all other IP rights (including patents and trademarks). 


This project is made out of love and to be truly helpful to everyone, not for any self interest. | want it to forever stay completely in the public 
domain, not owned by anyone. 


This is not mandatory but please consider supporting free software and free culture by using free licenses and/or waivers. 
If you'd like to support me or just read something about me and my projects, visit my site: www.tastyfish.cz. 


You can also choose to use this under the following waiver which is here to just ensure more legal safety and waiving of additional IP such as 
patents: 


The intent of this waiver is to ensure that this work will never be encumbered by any exclusive intellectual property rights and will always be in 
the public domain world-wide, i.e. not putting any restrictions on its use. 


Each contributor to this work agrees that they waive any exclusive rights, including but not limited to copyright, patents, trademark, trade 
dress, industrial design, plant varieties and trade secrets, to any and all ideas, concepts, processes, discoveries, improvements and inventions 
conceived, discovered, made, designed, researched or developed by the contributor either solely or jointly with others, which relate to this 
work or result from this work. Should any waiver of such right be judged legally invalid or ineffective under applicable law, the contributor 
hereby grants to each affected person a royalty-free, non transferable, non sublicensable, non exclusive, irrevocable and unconditional license 
(0) 


this right. 
tinyphysicsengine.h 
#ifndef _TINYPHYSICSENGINE_H specified in the "about axis" format: here the object is rotated CW by given 
#define _TINYPHYSICSENGINE_H axis by an angle that's specified by the magnitude of the vector. 
f 3m Where it matters (e.g. rotations about axes) we consider a left-handed coord. 
tinyphysicsengine (TPE) system (x right, y up, z forward). 


Simple/suckless header-only hybrid 3D physics engine with no floating point, 
only ‘32: bit int arithmetic, similar to esg."small3dlip. ^ ^." 7". ORS ES Sn SS Reem See ress gee re Steps ers Scns ser S S cc eres sn seer Se sieec eres lesser se = 


Conventions and formats are the same or similar to those of small3dlib so as 

to make them easily integrate with each other. by- drummyrish,. 2022 
The library works with bodies made of spheres connected by elastic springs, Vers lon; Orud 

i.e. soft bodies which however behave as "stiff" bodies by default and can 


be used to fake rigid body physics as well. Bodies are placed in environemnts This work's goal is to never be encumbered by any exclusive pte bte tust 


property rig . The work is therefore provided under CCO 1 


peci tied by a distance function that allows to implement any mathematical htt Acc cEentivecommons org hub tiedomain zero; 1:8) * additional WAIVER OF 
pes LL INTELLECTUAL PROPERTY RIGHTS that waives the rest of intellectual 
property 


Orientations/rotations are in extrinsic Euler angles in the ZXY order (by Z, rights not already waived by CCO 1.0. The WAIVER OF ALL INTELLECTUAL PROPERTY 
then by X, then by Y), if not mentioned otherwise. Angles are in TPE Units RGHTS is as follows: 
TPE FRACTIONS PER UNÍT is full angle (2 PI). Sometimes rotations can also be 
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Each contributor to this work agrees that they waive any exclusive rights, 
including but not limited to copyright, patents, trademark, trade dress, 
industrial design, plant varieties and trade secrets, to any and all ideas, 
concepts, processes, discoveries, improvements and inventions conceived, 
discovered, made, designed, researched or deve Lopes by the contributor either 
solely or jointly with others, which relate to this work or result from this 
work. Should any waiver of such right be judged legally invalid or 
ineffective under applicable law, the contributor hereby grants to each 
affected person a royalty Free, non transferable, non sublicensable, non 


exclusive, irrevocable and unconditional license to this right. 
*/ 


#include <stdint.h> 


typedef int32_t TPE_Unit; ///< Basic fixed point unit type. 
typedef inti6 t TPE UnitReduced; ///« Like TPE Unit but saving space 
#define TPE FRACTIONS PER UNIT 512 ///« one fixed point unit, don't change 
#define TPE F TPE FRACTIONS PER UNIT ///« short for TPE FRACTIONS PER UNIT 


#define TPE JOINT SIZE MULTIPLIER 32 ///« joint size is scaled (size saving) 
#define TPE INFINITY 2147483647 
#define TPE JOINT SIZE(joint) ((joint).sizeDivided * TPE JOINT SIZE MULTIPLIER) 


#ifndef TPE APPROXIMATE LENGTH 
#define TPE APPROXIMATE LENGTH 0 /**« whether or not use length/distance 
approximation rather than exact 
calculation (1 is faster but less 
accurate), beware of possible lower 
stability */ 

#endif 


#if !TPE APPROXIMATE LENGTH 
#define TPE DISTANCE TPE dist 
#define TPE LENGTH TPE vec3Len 
else 
#define TPE DISTANCE TPE distApprox 
" fderine TPE LENGTH TPE vec3LenApprox 
endi 


#ifndef TPE LOG i . 
ager ine TPE LOG(s) ; // redefine to some print function to show debug logs 
#endi 


#ifndef TPE_LOW_SPEED 

/** Speed, in TPE_Units per ticks, that is considered low (used e.g. for auto 
deactivation of bodies). uh 
#define TPE_LOW_SPEED 30 

#endif 


#ifndef TPE_RESHAPE_TENSION_LIMIT . 
/** Tension limit, in TPE Units, after which a non-soft body will be reshaped. 
,Smaller number will keep more stable shapes but will cost more performance. 


#define TPE RESHAPE TENSION LIMIT 20 
#endif 


#ifndef TPE_RESHAPE_ITERATIONS 

/** How many iterations of reshaping will be performed by the step function if 
the E AR Shape needs to be reshaped. Greater number will keep shapes more 
stable but will cost some performance. */ 

y paerane TPE_RESHAPE_ITERATIONS 3 
endi 


#ifndef TPE DEACTIVATE AFTER 

/** After how many ticks of low speed should a body be disabled. This mustn't 
be greater than 255. */ 
#define TPE DEACTIVATE AFTER 128 

#endif 


#ifndef TPE_LIGHT_DEACTIVATION 
/** When a body is activated by a collision, its deactivation counter will be 
set to this value, i.e. after a collision the body will be prone to 
deactivate 
sooner than format Lys This is to handle situations with many bodies touching 
cach other that would normally keep activating each other, never coming to 
rest. 
#define TPE LIGHT DEACTIVATION \ 
a A IPE-DEACTIVATE. AFTER - TPE DEACTIVATE AFTER / 10) 
#end1 


#ifndef TPE TENSION ACCELERATION DIVIDER 
/** Number by which the base acceleration (TPE FRACTIONS PER UNIT per tick 
squared canen by the connection tension will be divided. This should be 
ower of 2. 
Edetine TPE TENSION ACCELERATION DIVIDER 32 
#endif 


#ifndef TPE TENSION ACCELERATION THRESHOLD . 
/** Limit within which acceleration caused by connection tension won't be 


applied. */ 
#define TPE TENSION ACCELERATION THRESHOLD 5 
#endif 


#ifndef TPE_TENSION_GREATER_ACCELERATION_THRESHOLD : 

/** Connection tension threshold after which twice as much acceleration will 
be applied. This helps prevent diverting joints that are "impaled" by 
environment.*/ 

#define TPE TENSION GREATER ACCELERATION THRESHOLD \ 
qi IPE-TENSTON-ACCELERATTONCTHRESHOED * 3) 
#end1 


#ifndef TPE COLLISION RESOLUTION ITERATIONS 

/** Maximum number of iterations to try to uncollide two colliding bodies. */ 
euerine TPE_COLLISION_RESOLUTION_ITERATIONS 16 

#endi 


#ifndef TPE COLLISION RESOLUTION MARGIN . 

/** Margin, in TPE Units, by which a body will be shifted back to get out of 
collision. */ 
dening TPE_COLLISION_RESOLUTION_MARGIN (TPE_F / 64) 

#endi 


#ifndef TPE_NONROTATING_COLLISION_RESOLVE_ATTEMPTS 

/** Number of times a collision of nonrotating bodies with environment will be 
attempted to resolve. This probably won't have great performance implications 
as complex collisions of this kind should be relatively rare. 

5 Pderine TPE NONROTATING COLLISION RESOLVE ATTEMPTS 8 
endi 


#ifndef TPE APPROXIMATE NET SPEED  _ . 

/** Whether to use a fast approximation for calculating net speed of bodies 
which increases performance a bit. */ 
pce rine: TPE_APPROXIMATE_NET_SPEED 1 

#endi 


#define TPE PRINTF VEC3(v) printf("[%d %d %d]",(v).x,(Vv).y,(V).Z); 
typedef struct 
TPE_Unit x; 


TPE_Unit y; 
TPE Unit z; 
} TPE Vec3; 


/** Keeps given point within specified axis-aligned box. This can be used e.g. 
to smooth rendered movement of pittering physics bodies. */ 

TPE Vec3 TPE vec3KeepWithinBox(TPE Vec3 point, TPE Vec3 boxCenter 
TPE Vec3 boxMaxVect); 


TPE Vec3 TPE vec3KeepWithinDistanceBand(TPE Vec3 point, TPE_Vec3 center 
TPE Unit minDistance, TPE Unit maxDistance); 


TPE Vec3 TPE vec3(TPE Unit x, TPE Unit y, TPE Unit z); 
TPE Vec3 TPE vec3Minus(TPE Vec3 vi, TPE Vec3 v2); 

TPE Vec3 TPE vec3Plus(TPE Vec3 v1, TPE Vec3 v2); 

TPE Vec3 TPE vec3Cross(TPE Vec3 v1, TPE Vec3 v 5 

TPE Vec3 TPE vec3Project(TPE Vec3 v, TPE Vec3 base); 

TPE Vec3 TPE vec3ProjectNormalized(TPE Vec3 v, TPE Vec3 baseNormalized); 
TPE Vec3 TPE vec3Times(TPE Vec3 v, TPE Unit units); 

TPE Vec3 TPE vec3Times OI TPE-Veca v, TPE Unit ay; 


TPE_Vec3 TPE_vec3Normalized(TPE_Vec3 v); 


TPE_Unit TPE_vec3Dot(TPE_Vec3 vi, TPE_Vec3 v2); 
TPE_Unit TPE_vec3Len(TPE_Vec3 v); 
TPE_Unit TPE_vec3LenApprox(TPE_Vec3 v); 


/** Returns an angle in TPE Units (see angle conventions) of a 2D vector with 
the X axis, CCW. */ 
TPE Unit TPE vec2Angle(TPE Unit x, TPE Unit y); 


Jk Keeps given value within specified range. This can be used e.g. for 
movemen 

smoothing. */ 
TPE Unit TPE keepInRange(TPE Unit x, TPE Unit xMin, TPE Unit xMax); 


static inline TPE Unit TPE max(TPE Unit a, TPE Unit b); 
static inline TPE Unit TPE min(TPE Unit a, TPE Unit b 
static inline TPE Unit TPE nonZero(TPE Unit x); 

static inline TPE Unit IPE dist(TPE Veca pi, TPE Vec3 p2); 
static inline TPE Unit TPE_distApprox(TPE_Vec3 pi, TPE Vec3 p2); 


TPE Unit TPE sqrt(TPE Unit x); 


r 


static inline TPE_Unit PE x); 


/** Compute sine, TPE FRACTIONS PER UNIT as argument corresponds to 2 * PI 
radians. Returns a number from -TPE FRACTIONS PER UNIT to 
TPE FRACTIONS PER UNIT. */ 
TPE Unit TPE sin(TPE Unit x); 
TPE Unit TPE cos(TPE Unit x 
TPE Unit TPE atan(TPE Unit x); 


typedef struct 


TPE Vec3 position; . 
TPE UnitReduced velocity[3]; ///« not TPE Vec3 to save size 
uint8 t sizeDivided; /**« size radius for saving space divided by 


TPE J TAT SIE MULTIPLIER *7 
} TPE_Joint; 


pypedef struct 


uint8_t joint1; 
uint8_t Joint2; 
uint16_t length; 


///« connection's preferred length, uint16_t saves space 
} TPE Connection; 


#define TPE BODY FLAG DEACTIVATED 1 
energy, 


/**« Not being updated due to low 


"sleeping", will be woken by 
collisions etc. */ 

#define TPE BODY FLAG NONROTATING 2 /**« When set, the body won't rotate 
will only move linearly. Here the 
velocity of the body's first joint 
is the, velocity of the whole 


body. 

#define TPE BODY FLAG DISABLED 4 /**« Disabled, not taking part in 
simulation. */ 

#define TPE BODY FLAG SOFT 8 /**« Soft connections, effort won't be 


made to keep the body's shape. */ 
#define TPE BODY FLAG SIMPLE CONN 16 /**« Simple connections, don't zero out 
antagonist forces or apply 
connection friction, can increase 
performance. */ 
#define TPE BODY FLAG ALWAYS ACTIVE 32 /**« Will never, deactivate due to low 
energy. 


/** Function used for defining static environment, working similarly to an SDF 
(signed distance function). The parameters are: 3D point P, max distance D. 
The function should behave like this: if P is inside the solid environment 

i volume, P will be returned; otherwise closest point (by Euclidean distance) 

o 
the solid environment volume from P will be returned, except for a case when 
this closest point would be further away than D, in which case any arbitrary 
point further away than D may be returned (this allows for optimizations). */ 
typedef TPE Vec3 (*TPE ClosestPointFunction)(TPE Vec3, TPE Unit); 


/** Function that can be used as a joint-joint or joint-environment collision 
callback, parameters are following: body1 index, jointi index, body2 index, 
joint2 index, collision world position. If body1 index is the same as body1 
index, then collision type is body-environment, otherwise it is body-body 
type. The function has to return either 1 if the collision is to be allowed 
or 0 if it is to be discarded. This can besides others be used to disable 
collisions between some bodies. */ i . 

typedef uint8 t (*TPE CollisionCallback)(uinti16 t, uinti16 t, uinti6 t, 

uinti6 t, 

TPE Vec3); 


/** Function used by the debug drawing functions to draw individual pixels to 
the screen. The parameters are following: pixel x, pixel y, pixel color. */ 
typedef void (*TPE DebugDrawFunction)(uinti6 t, uintié t, uint8 t); 


/** Physics body made of Spheres (each of same weight but possibly different 
radia) connected by elastic springs. */ 
pypedef struct 


TPE_Joint *joints; 
uint8 t jointCount; 
TPE Connection *connections; 
uint8 t connectionCount; 
TPE UnitReduced jointmess; 
TPE UnitReduced friction; 
TPE UnitReduced elasticity; 
uint8 t flags; 
uint8 t deactivateCount; 

} TPE Body; 


///< mass of a single joint 
///< friction of each joint 
///< elasticity of each joint 


eee struct 


TPE_Body *bodies; 
uint16_t bodyCount; 
TPE ClosestPointFunction environmentFunction; 
TPE CollisionCallback collisionCallback; 
} TPE World; 


/** Tests the mathematical validity of given closest point function (function 
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representing the physics environment), i.e. whether for example approaching 
some closest point in a straight line keeps approximately the same closest 
point. Note that this function may take a long time to complete, especially 
with higher gridResolution values and more complex environment functions. You 
should üse this function to test your environment function, especially if you 
create functions for your own shapes etc. The cornerFrom and cornerTo points 
are corners of an axis-a tioned box within which testing will take place, 
qridReso LUE Lon defines numbers of points (i.e. step length) along each . 
imension to test (recommended e.g. 64), allowedError sàys error within which 
points will be considered the same (recommended range approx. 10 to 200). If 
testing is successful, 1 is returned, otherwise 0 is returned and the point 
around which error was detected is returned in errorPoint (unless the pointer 
is 0 in which case it is ignored). */ 
uint8 t TPE testClosestPointFunction(TPE ClosestPointFunction f, 
TPE Vec3 cornerFrom, TPE Vec3 cornerTo, uint8 t gridResolution, 
TPE UnitReduced allowedError, TPE Vec3 *errorPoint); 


void THE DodyInit(TPE Body *body, 
TPE Joint *joints, uint8 t jointCount, 
TPE Connection *connections, uint8 t connectionCount, 
TPE Unit mass); 


void TPE worldInit(TPE World *world, 
TPE Body *bodies, uinti6 t bodyCount, 
TPE ClosestPointFunction environmentFunction); 


/** Gets orientation rotation) of a body from a position of three of its 
joints. The vector from jointi to joint2 is considered the body's forward 
direction, the vector from jointi to joints its right direction. The returned 
rotation is in Euler angles (see rotation conventions). 

TPE_Vec3 TPE-bodyGetRotation(const TPE Body *body, uinti6_t joint, 
uinti6 t joint2, uinti16 t joint3); 


void TPE vec3Normalize(TPE Vec3 *v); 


/** Rotates a 3D point by given Euler angle rotation (see rotation 
conventions). */ : 
TPE Vec3 TPE pointRotate(TPE Vec3 point, TPE Vec3 rotation); 


/** Returns an inverse rotation to given rotation, in Euler angles (see 

rotation 
conventions). */. y 

TPE Vec3 TPE rotationInverse(TPE Vec3 rotation); 


/** Returns a connection tension, i.e. a signed percentage difference against 
desired length (TPE FRACTIONS PER UNIT means 100%). */ 

static inline TPE Unit TPE connectionTension(TPE Unit length, 
TPE Unit desiredLength); 


/** Rotates a rotation specified in Euler angles by given axis * angle (see 
rotation conventions). Returns a rotation in Eurler angles. */ y 
TPE_Vec3 TPE_rotationRotateByAxis(TPE_Vec3 rotation, TPE_Vec3 rotationByAxis); 


/** Computes the formula of a 1D collision of rigid bodies. */ 
void TPE getVelocitiesAfterCollision(TPE Unit *v1, TPE Unit *v2, TPE Unit m1, 
TPE Unit m2, TPE Unit elasticity); 


/** Computes orientation/rotation (see docs for orientation format) from two 
vectors (which should be at least close to being perpendicular and do NOT 
need to be normalized). This can be used to determine orientation of a body 
from a relative position of its joints. Rf 

TPE_Vec3 TPE_rotationFromVecs(TPE_Vec3 forward, TPE_Vec3 right); 


TPE_Joint TPE_joint(TPE_Vec3 position, TPE_Unit size); 


/** Mostly for internal use, resolves a potential collision of two joints in a 
way that keeps the joints outside provided environment (if the function 
.pointer is not 90 Returns 1 if joints collided or © otherwise. */ 

uint8 t TPE joints ésolvecollision{ TPE. Joint *ji, TPE Joint *j2, 

TPE Unit massi, TPE Unit mass2, TPE Unit elasticity, TPE Unit friction, 
TPE ClosestPointFunction env); 


/** Mostly for internal use, tests and potentially resolves a collision between 
a joint and environment, returns 0 if no collision happened, 1 if it happened 
and was resolved normally and 2 if it couldn't be resolved normally. */ 

uint8 t TPE jointEnvironmentResolveCollision(TPE Joint *joint, TPE Unit 
elasticity, TPE Unit friction, TPE ClosestPointFunction env); 


/** Tests whether a body is currently colliding with the environment. */ 
uint8 t TPE bodyEnvironmentCollide(const TPE Body *body, 
TPE ClosestPointFunction env); 


/** Mostly for internal use, tests and potentially resolves a collision of a 
body with the environment, returns 1 if collision happened or © otherwise. */ 
uint8 t TPE bodyEnvironmentResolveCollision(TPE Body *body, 
TPE ClosestPointFunction env); 


TPE Vec3 TPE bodyGetLinearVelocity(const TPE Body *body); 


/** Computes the minimum bounding box of given body. */ 
void TPE bodyGetAABB(const TPE Body *body, TPE Vec3 *vMin, TPE_Vec3 *vMax); 


/** Computes a bounding sphere of a body which is not minimal but faster to 
compute than the minimum bounding sphere. 

void TPE bodyGetFastBSphere(const TPE Body *body, TPE Vec3 *center 
TPE Unit *radius); 


/** Computes the minimum bounding sphere of a body (there is another function 
for a faster approximate bounding sphere). */ 

void TPE bodyGetBSphere(const TPE Body *body, TPE Vec3 *center, 
TPE Unit SYadius); 


uint8_t TPE_checkOver LapAABB(TPE_Vec3 viMin, TPE_Vec3 viMax, TPE_Vec3 v2Min, 
TPE Vec3 v2Max); 


/** Mostly for internal use, checks and potentiall resolves collision of two 
bodies so as to keep them outside given environment. Returns 1 if collision 
happened or 0 otherwise. */ 

uint8 t TPE bodiesResolveCollision(TPE Body *bi, TPE Body *b2, 

TPE ClosestPointFunction env); 


/** Pins a joint of a body to specified location in space (sets its location 
and zeros its velocity). */ | i 
void TPE jointPin(TPE Joint *joint, TPE_Vec3 position); 


/** "Fakes" a rotation of a moving sphere by rotating it in the direction of 
its movement; this can create the illusion of the sphere actually rotating 
. quete friction even if the physics sphere object (a body with a single 
join 
isn't rotating at all. Returns a rotation in the "about axis" format (see 
library conventions). */ 
TPE Vec3 TPE fakeSphereRotation(TPE Vec3 positioni, TPE Vec3 position2, 
TPE Unit radius); 


te Casts a ray against environment and returns the closest hit of a surface. 


no surface was hit, a vector with all elements equal to TPE INFINITY will be 
returned. The function internally works differently for outside rays (rays 
cast from the outside of the environment) and inside rays. Outside rays can 
be traced with raymarching and will be processed very quickly and precisely; 
in this case if any intersection is found, the function will try to return a 
point outside (not guaranteed) the environment that's just in front of the 


hit 
surface. Inside rays are difficult and slow to trace because environment 
function won't provide distance, so the results aren't guaranteed to be 
precise (the ray may miss some intercectiong)] here rays will be traced by 
given step (insideStepSize) and eventually iterated a bit towards the 
intersection -- if any intersection is found, the function will try to return 
a point inside (not guaranteed) the environment just before the hi 
surface. */ . 

TPE Vec3 TPE castEnvironmentRay(TPE Vec3 rayPos, TPE Vec3 rayDir, 
TPE ClosestPointFunction environment, TPE Unit insideStepSize, 
TPE Unit rayMarchMaxStep, uint32 t maxSteps); 


/** Casts a ray against bodies in a world (ignoring the environment), returns 
the position of the closest hit as well as the hit body's index in bodyIndex 
(unless the bodyIndex pointer is © in which case it is ignored). Similarly 
with jointIndex. If no hit is found a vector with all elements equal to 

b TPE INFINITY will be returned and bodyIndex will be -1. A specific body can 

e 


excluded with excludeBody (negative value will just make this parameter 

ignored). 

TPE Vec3 dpe CastBodyRay(TPE. Veca rayPos, TPE_Vec3 rayDir, inti16 t excludeBody, 
const TPE World *world, inti6 t *bodyIndex, inti6 t *jointIndex); 


/** performs one step (tick, frame, ) of the physics world simulation 
jncluding updating positions and velocities of bodies, collision detection 

an 

resolution, possible reshaping or deactivation of inactive bodies etc. The 

. time length of the step is relative to all other units but it's ideal if it 

sS 


i 
1/30th of a second. */ 
void TPE worldStep(TPE World *world); 


void TEE wor tddeactivateall (TPE wor ld *wor ld); 
void TPE worldActivateAll(TPE World *world); 


TPE Unit TPE worldGetNetSpeed(const TPE World *world); 

TPE Unit TPE bodyGetNetSpeed(const TPE Body *body > 

TPE Unit TPE bodyGetAverageSpeed(const TPE Body ); 

void TBE-bodyMu Lt ip yNetSpeed TPE Body *body, TPE Unit factor )i 

void TPE_bodyLimitAverageSpeed(TPE_Body *body, TPE_Unit speedMin, 
TPE_Unit speedMax) ; 


Lae Deactivates a body (puts it to sleep until another collision or force wake 
up). 

void TPE bodyDeactivate(TPE Body *body); 

static inline uint8 t TPE bodyIsActive(const TPE Body *body); 


/** Attempts to shift the joints of a soft body so that the tension of all 
Sprin S becomes zero while keeping the joints near their current position. 
Thi unction performs one iteration of the equalizing algorithm and doesn't 
guarantee a perfect solution, it may help to run multiple iterations (call 

his function multiple times) WA 

void TPE bodyReshape(TPE Body 
environmentFunction); 


body, TPE ClosestPointFunction 


/** Mostly for internal use, performs some "magic" on body connections, mainly 
cancelling out of velocities going against each other and also applying 
connection friction in soft bodies. The strong parameter indicates if the 

pody is soft or not. */ J . 

void TPE bodyCancelOutVelocities(TPE Body *body, uint8 t strong); 


/** Moves a body by certain offset. */ 
void TPE bodyMoveBy(TPE Body *body, TPE Vec3 offset); 


/** Moves a body (its center of mass) to given position. */ 
void TPE bodyMoveTo(TPE Body *body, TPE Vec3 position); 


/** Zeros velocities of all soft body joints. */ 
void TPE bodyStop(TPE Body *body); 


void TPE bodyActivate(TPE Body *body); 


/** Adds velocity to a soft body. */ 
void TPE bodyAccelerate(TPE Body *body, TPE Vec3 velocity); 


void TPE bodyApplyGravity(TPE Body *body, TPE Unit downwardsAccel); 


/** Adds angular velocity to a soft body. The rotation vector specifies the 
axis 


of rotation by its direction and angular velocity by its magnitude (magnitude 
of TPE FRACTIOÓNS PER UNIT will add linear veloci of TPE FRACTIONS PER UNIT 
per tick to a point in the distance of TPE FRACTIOÓNS PER UNIT from the 
rotation axis). */ 

void TPE bodySpin(TPE Body *body, TPE Vec3 rotation); 


for pane: as IPE-bodySpin but additionally allows to specify the center of 

e spin. 

void TS E-bodyspinwithcenter (TPE-BOdY *body, TPE Vec3 rotation, TPE Vec3 
ente H 


/** Instantly rotates a body about an axis (see library conventions for 
the rotation Tormey rst 
void TPE bodyRotateByAxis(TPE Body *body, TPE Vec3 rotation); 


/** Computes the center of mass of a body. This averages the position of all 

T joints; note that if you need, you may estimate the center of the body 
aster 
e.g. by taking a position of a single "center joint", or averaging just 2 
extreme points. £7. 

TPE Vec3 TPE bodyGetCenterOfMass(const TPE Body *body); 


/** Draws a debug view of a 3D physics world using a provided pixel drawing 
function. This can be used to overlay a simple visualization of the physics 
objects to your main render, to spot exact borders of objects etc. The 
function draws simple dotted lines and circles with different "colors" for 
different types of objects (joints, connections, environemnt). camPos, camRot 
and camView should match the camera settings of your main renderer. CamView.x 
is horizontal resolution in pixels, camView.y is the vertical resolution, 
CamView.z says the camera focal length (-FOV) in TPE Units (0 means 
opthographic projection). envGridRes is the resolution of an environment 

probe 
grid (the function will probe points in space and draw borders of the physics 
environemnt), envGridSize is the size (int TPE Units) of the grid cell. Note 
the T. ton may be slow (reducing envGridRes can help, workable value can be 
e.g. 16). 

void TPE. WórldDebugDraw(TPE. World *world, TPE DebugDrawFunction drawFunc, 

TPE Vec3 camPos, TPE Vec3 camRot, TPE Vec3 camView, uinti6 t envGridRes, 
TPE Unit envGridSize); 


#define TPE DEBUG COLOR CONNECTION 0 
#define TPE DEBUG COLOR JOINT 1 
#define TPE DEBUG COLOR ENVIRONMENT 2 


#define TPE DEBUG COLOR INACTIVE 3 

uint32 t TPE jointHash(const TPE Joint *joint); 

uint32 t TPE connectionHash(const TPE Connection *connection); 
uint32 t TPE bodyHash(const TPE Body *body); 


/** Computes 32 bit hash of the world, useful for checking if two states of the 
world differ. The function takes into account most of the relevant state but 
possibly not all of it, for details check the code. */ 

uint32 t TPE worldHash(const TPE World *world); 
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// FUNCTIONS FOR GENERATING BODIES 


void TPE makeBox(TPE Joint dgints[8] TPE Connection gonnections[16] 
TPE Unit width, TPE Unit depth, T E Unit height, TPE Unit jointSize); 
void TPE makeCenterBox(TPE Joint joints[9], TPE Connection connections [18] 
TPE Unit width, TPE Unit depth, TPE Unit height, TPE Unit jointSize); 
void TPE makeRect(TPE Joint joints[2], TPE Connection connections[6] 
TPE Unit width, TPE Unit depth, TPÉ Unit jointSize); 
void TPE makeTriangle(TPE Joint joints[3] 
TPE Unit sideLength, TPE Unit jointSize) 
void TPE makeCenterRect(TPE Joint joints[5], TPE Connection connections[8] 
TPE Unit width, TPE Unit depth, TPE Unit jointSize); 
void TPE makeCenterRectFull(TPE Joint joints[5], TPE Connection 
connections[10], 
TPE_Unit width, TPE_Unit depth, TPE_Unit jointSize); 
void TPE_make2Line(TPE_Joint joints[2], TPE_Connection connections[1] 
TPE_Unit length, TPE_Unit jointSize 


TPE_Connection connections[3] 


—- 


f 


// FUNCTIONS FOR BUILDING ENVIRONMENT 


TPE_Vec3 TPE_envAABoxInside(TPE_Vec3 point, TPE_Vec3 center, TPE_Vec3 size); 

TPE_Vec3 TBE-envAABOX (TPE NECI point, TPE_Vec3 center, TPE_Vec3 maxCornerVec); 

TPE Vec3 TPE envBox(TPE Vec3 point, TPE Vec3 center, TPE Vec3 maxCornerVec, 
TPE Vec3 rotation); 

TPE Vec3 TPE envSphere(TPE Vec3 point, TPE Vec3 center, TPE Unit radius); 


TPE Vec3 TPE envsphereInside(TPE. Vec3 point TPE Vec3 center, TPE Unit radius); 
TPE Vec3 TPE envHalfPlane(TPE Vec3 point, TPE Vec3 center, TPE Vec3 normal); 
TPE Vec3 TPE envGround(TPE Vec3 point, TPE Unit height); 


TPE Vec3 TPE envInfiniteCylinder(TPE Vec3 point, TPE_Vec3 center, TPE Vec3 
direction, TPE Unit radius); 

TPE Vec3 TPÉ envC linder(TPE Vec3 point, TPE Vec3 center, TPE Vec3 direction, 
TPE Unit radius); 

TPE Vec3 TPE_envCone(TPE_Vec3 point, TPE Vec3 center, TPE_Vec3 direction, 
TPE Unit radius); 

TPE Vec3 TPE_envLineSegment(TPE_Vec3 point, TPE Vec3 a, TPE Vec3 b); 

TPE vecs TPE envHeightmap(TPE. veca oint, TPE_Vec3 center, TPE_Unit gridSize, 
TPE Unit (*heightFunction)(int32 t x, int32 t y), TPE Unit maxDist 9; 

/** Environment function for triagnular prism, e.g. for ramps. The sides array 
contains three 2D coordinates o points of the triangle in given plane with 

respect to the center. WARNING: the points must be specified in counter 

SLOWS Kwa se direction! The direction var specified axis direction (0, 1 or 


TPE_Vec3 TPE envAATriPrism(TPE Vec3 point, TPE_Vec3 center 
const TPE_Unit sides[6], TPE_Unit depth, uint8_t direction); 


/* The following are helper macros for creating a union of shapes inside an 
environment function and accelerating them with bounding volumes. * 


#define TPE_ENV_START(test, point) TPE_Vec3 _pBest = test 
TPE Unit _dBest = TPE_DISTANCE(_pBest,point), _dTest; 
(void)(_pBest); (void)( dBest); (void) (_dTest); (void)(_pTest); // supress 

war 


.pTest; \ 


#define TPE_ENV_NEXT(test,point) \ . 
{ if ( pBest.x == point.x && _pBest.y == point.y && _pBest.z == point.z) \ 
return _pBest; \ 
_pTest = test; _dTest = TPE_DISTANCE(_pTest,point); \ 
if (_dTest < _dBest) { _pBest = _pTest; _dBest = _dTest; } } 


#define TPE_ENV_END return _pBest; 


#define TPE ENV BCUBE TEST(bodyBCubeC, bodyBCubeR, envBCubeC, envBCubeR) ( \ 
TPE abs(envBCubeC.x - bodyBCubeC.x) «- bodyBCubeR) * (envBCubeR && N 
TPE abs(envBCubeC.y - bodyBCubeC.y) <= bodyBCubeR) + (envBCubeR && \ 
TPE_abs(envBCubeC.z - bodyBCubeC.z) <= bodyBCubeR) + (envBCubeR ) 


ine 
ENV BSPHERE TEST(bodyBSphereC, bodyBSphereR, envBSphereC, envBSphereR) \ 
PE DISTANCE(bodyBSphereC,envBSphereC) <= ((bodyBSphereR) + (envBSphereR) ) ) 


// privates: 


uint16_t TPE bodyiIndex,  TPE body2Index, _TPE_jointiIndex,  TPE joint2Index; 
TPE CollisionCallback _TPE_collisionCallback; 


static inline TPE Unit TPE nonZero(TPE Unit x) 


return x !20? x : 1; 


static inline TPE Unit TPE connectionTension(TPE Unit length, 
TPE Unit desiredLength) 


t return (length * TPE F) / desiredLength 


Fy 


RH TPE joint(TPE Vec3 position, TPE Unit size) 
TPE Joint result; 


result.velocity[0] = 0; 
result.velocity[1] = 0; 
result.velocity[2] = 0; 


result.position = position; 
size /- TPE JOINT SIZE MULTIPLIER; 
if (size » Oxff) 
TPE LOG("WARNING: joint size too big in TPE joint"); 


result.sizeDivided - size; 


return result; 


TPE Vec3 TPE vec3(TPE Unit x, TPE Unit y, TPE Unit z) 
TPE Vec3 r; 


zy 


3353 
N< x 


return r; 


Jee unit TPE_sqrt(TPE_Unit x) 
int8_t sign = 1; 
if (x < 0) 


sign = -1; 
X 2 -1; ý 


} 


uint32_t result = 0; 
uint32_t a = x; 
uint32 t b = 1u << 30; 


while (b > a) 
b >>= 2; 

while (b != 0) 
if (a >= result + b) 


a -= result + b; 


result = result + 2 * b; 


b >>= 2; 
result >>= 1; 


return result * sign; 


3 
TPE_Unit TPE_vec3Len(TPE_Vec3 v) 


define ANTI OVERFLOW 25000 

if (v.x « ANTI OVERFLOW && v.x > -1 
V.y < ANTI OVERFLOW && v.y > -1 
v.z < ANTI OVERFLOW && v.z > -1 


* ANTI OVERFLOW && 
ANTI OVERFLOW && 
ANTI OVERFLOW) 


TPE sqrt(v.x * v.x + v.y * v.y + V.z * v.z); 


+ 


return 


v.x /= 32; v.y /= 32; v.z /= 32; 
TPE_sqrt(v.x *vxtv.y * v.y + v.z * v.z) * 32; 


gulder ANTI OVERFLOW 


out TPE vec3LenApprox(TPE Vec3 v) 
// 48 sided polyhedron approximation 


if (v.x < 0) v.x *= -1; 
if (v.y < 0) v.y *= -1; 
if (v.z « 0) v.z *= -1; 


if (v.x « v.y) // order the coordinates 
re (v.x < v.z) 

if (v.y « v.z 

i ys y ) 


VX << V.y « v. 
int32 t t - v.x; 


<N 
x 
u 
< 
N 
< 
N 
u 
ft 


else 
{ // v.xX « v.z € v.y 


int32 t t = v.x; v.x =v.y; v.y =t; 
t-v.z; v.z =v.y; viy = t; 
else 
{ // v.z« yX < wy 
int32 t t = v.x; V.X =v.y; v.y =t; 


else 
if (v.y < v.z) 


if (v.x « v.z) 
// Ny « V.X € V.Z 
int32 t t- v.y; v.y =v.z; v.z = t; 
t-v.x;v.x-v.y; v.y = t; 


else 
{ // v.y « v.z < v.x 
int32 t t =v.y; v.y=v.z; v.z=t; 


} } 


return (893 * v.x + 446 * v.y + 223 * v.z) / 1024; 


TPE_Unit TPE_dist(TPE_Vec3 pi, TPE_Vec3 p2) 


{ 
pi = TPE_vec3Minus(p1,p2); 
return TPE_vec3Len(p1) 


, 


TPE Unit TPE distApprox(TPE Vec3 pi, TPE Vec3 p2) 


pi = TPE vec3Minus(p1, p2); 
return TPE vec3LenApprox(p1); 


void TPE bodyInit(TPE Body *body, 
TPE Joint *joints, uint8 t jointCount, . 
TPE Connection *connections, uint8 t connectionCount, 
TPE Unit mass) 
body->joints = joints: 
body->jointCount = jointCount; 
body->connections = connections; 
body->connectionCount = connectionCount; 
body->deactivateCount 0; 
body->friction = TPE F / 2; 
body->elasticity = TPE_F / 2; 
body->flags = 0; 
body->jointMass = TPE nonZero(mass / jointCount); 


for (uint32 t i = 0; i « connectionCount; ++i) 


TPE Unit d - TPE DISTANCE( 
joints[connections[i].jointi].position 
joints[connections[i].joint2 position); 


if (d » Oxffff) 
TPE LOG("WARNING: joint distance too long in TPE bodyInit"); 


} connections[i].length = d !=0? d 1; // prevent later division by zero 

H 

void TPE worldInit(TPE World *world, TPE Body *bodies, uinti6 t bodyCount, 
TPE ClosestPointFunction environmentFunction) 


1 
world->bodies = bodies; 
wor ld->bodyCount = bodyCount; 
wor ld->environmentFunction = environmentFunction; 
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world->collisionCallback = 0; 


#define C(n,a,b) connections[n].joint1 = a; connections[n].joint2 = b; 


void TPE_make2Line(TPE_Joint joints[2], TPE_Connection connections[1] 
TPE_Unit length, TPE_Unit jointSize 


í Jointspo 
Joints 1 
(0, 0,1 


TPE joint(TPE vec3(length / 2,0,0),jointSize); 
TPE joint(TPE vec3(length / -2,0,0); jointSize]; 


void TPE makeRect(TPE Joint jointsI2] TPE Connection connections[6] 
TPE Unit width, TPE Unit depth, T E Unit jointSize) 


width /= 2; 
depth /= 2; 


for (uint8_t i = 0; i < 4; ++i) 
joints[i] = JPE_jopnt (TPE _vec3( (i 96 2) ? -1 * width : width, 
0,(i / 2) ? - * depth : depth), jointSize); 


C(9, 0,1) C(1, 0,2) C (2, 3,1) C(3, 3,2) 
C(4, 0,3) C(5, 1,2 


void TPE makeCenterRect(TPE Joint joints[5], TPE Connection connections[8] 
TPE Unit width, TPE Unit depth, TPE Unit jointSize) 


TPE makeRect( joints, connections, width, depth, jointSize); 
joints[4] = TPE_joint(TPE_vec3(0,0,0),jointSize) ; 
} C(6, 0,4) C(7, 3,4) 


void TPE_makeCenterRectFull(TPE_Joint joints[5], TPE_Connection 
connections[10], 


TPE_Unit width, TPE_Unit depth, TPE_Unit jointSize) 


TPE makeCenterRect (joints, connections, width, depth, jointSize) ; 
C(8, 1,4) C(9, 2,4 


void TPE_makeTriangle(TPE_Joint joints[3], TPE_Connection connections[3] 


TPE_Unit sideLength, TPE_Unit jointSize 


joints[9] = TPE Joint (TRE_vecs (sideLength / 2,0, . 
TPE_sqrt((sideLength * sideLength) / 2) / 2), jointsize); 


joints[1] = joints[0]; 
joints[1].position.x *= -1; - 2. M 
joints[2] = TPE_joint(TPE_vec3(0,0,-1 * joints[0].position.z),jointSize); 


z c(0, 0,1) C(1, 1,2) C(2, 2,0) 


void TPE makeBox(TPE Joint joints[8], TPE Connection connections[16] 
TPE Unit width, TPE Unit depth, TPE Unit height, TPE Unit jointSize) 


1 
width /- 2; 
depth /- 2; 
height /- 2; 
for (uint8 t i = 0; i < 8; ++i) 
joints[i] = TPE_joint( 
TPE_vec3 ; i 
i % 2) ? width : (-1 * width), 
i >> 2) % 2) ? height : (-1 * height), 
i >> 1) % 2) ? depth : (-1 * depth)), 
jointSize); 
C(0, 0,1) C(1, 1,3) C(2, 3,2) C(3, 2,0) // to 
C(4, 4,5) C(5, 5,7) C(6, 7,6) C(7, 6,4) // bottom 
C(8, 0,4) C(9, 1,5) C(10,3,7) C(11,2,6) // middle 
" C(12,0,7) C(13,1,6) C(14,2,5) C(15,3,4) // diagonal 


void TPE makeCenterBox(TPE Joint joints[9], TPE Connection connections[18] 
TPE Unit width, TPE Unit depth, TPE Unit height, TPE Unit jointSize) 


TPE_makeBox( joints, connections, width, depth, height, jointSize) ; 
joints[8] = TPE_joint(TPE_vec3(0,0,0),jointSize) ; 
C(16, 0,8) C(17, 7,8) 


#undef C 


void TPE bodyDeactivate(TPE Body *body) 
body->flags |= TPE BODY FLAG DEACTIVATED; 


void TPE worldStep(TPE World *world) 
.TPE collisionCallback = world-»collisionCallback; 
for (uinti6 t i = 0; i < world->bodyCount; ++i) 
t TPE_Body *body = world->bodies + i; 


if (body->flags & (TPE BODY FLAG DEACTIVATED | TPE BODY FLAG DISABLED)) 
continue; 


TPE Joint *joint = body->joints, *joint2; 
TPE_Vec3 origPos = body->joints[0].position; 
for (uint16_t j = 0; j < body->jointCount; ++j) // apply velocities 
í // non-rotating bodies will copy the 1st joint's velocity 
if (body:s[lags & TPE-BODY.FLAG NONROTATING) 


for (uint8_ 0; k < 3; ++k 
joint->velocity[k] = body->joints[0].velocity[k]; 


joint->position.y += joint->velocity[1 
joint->position.z += joint-»velocity[2 


, 
r 


joint->position.x += Joint :zveteeityka]i 


joint++; 


J: 

TPE_Connection *connection = body->connections; 
TPE_Vec3 aabbMin, aabbMax; 

TPE bodyGetAABB(body, &aabbMin, &aabbMax) ; 


.TPE bodyiIndex 
.TPE body2Index -  TPE bodyiIndex; 


i; 


uint8 t collided - A" y 
TPE_bodyEnvironmentResolveCollision(body,world->environmentFunction); 


if (body->flags & TPE_BODY_FLAG_NONROTATING) 


/* Non-rotating bodies may end up still colliding after environment coll 
parari) vement (unlike rotating bodies where each joint is ensured 
se ely 


Hor to not collide). So if still in collision, we try a few more times. If 


successful, we simply undo any shifts we've done. This should absolutely 
prevent any body escaping out of environment bounds. */ 


for (uint8 t i = 0; i < TPE NONROTATING COLLISION RESOLVE ATTEMPTS; ++i) 


if (!collided) 
break; 


collided - 


TPE bodyEnvironmentResolveCollision(body,world-»environmentFunction); 


if (collided && 
TPE_bodyEnvironmentCollide(body,world->environmentFunction)) | 
} TPE_bodyMoveBy (body, TPE_vec3Minus(origPos, body->joints[0].position) ); 
else // normal, rotating bodies 
TPE_Unit bodyTension = 0; 
for (uint16_t j = 0; j < body->connectionCount; ++j) // joint tension 


joint 
joint2 


&(body-»joints[connection-»joint1]); 
&( body->joints[connection->joint2]); 


TPE Vec3 dir = TPE_vec3Minus(joint2->position, joint->position); 


TPE Unit tension = TPE connectionTension(TPE LENGTH(dir), 
connection-»length); 


bodyTension += tension > 0 ? tension : -tension; 


if (tension » TPE TENSION ACCELERATION THRESHOLD 
tension « -1 * TPE TENSION ACCELERATION THRESHOLD) 


TPE vec3Normalize(&dir); 


if (tension » TPE TENSION GREATER ACCELERATION THRESHOLD ld 
( tension « -1 * TPE TENSION GREATER ACCELERATION THRESHOLD) 
/* app ly twice the acceleration after a second threshold, not so 
e egant but seems to work :) */ 


dir.x 2; 
dir.y *- 2; 
dir.z *- 2; 


3 

dir.x /- TPE TENSION ACCELERATION DIVIDER; 
dir.y /- TPE TENSION ACCELERATION DIVIDER; 
dir.z /- TPE TENSION ACCELERATION DIVIDER; 


if (tension « 0) 


dir.x *= -1; 
dir.y i- -1; 
dir.z *- -1; 


joint-»velocity[0] += dir.x; 
joint-»velocity[1] += dir.y; 


joint->velocity[2] += dir.z; 
joint2->velocity[0] -= dir.x; 
joint2-»velocity[1 dir.y; 
joint2-»velocity[2] -= dir.z; 


connection++; 


if (body->connectionCount > 0) 
uint8_t hard = !(body->flags & TPE_BODY_FLAG_SOFT); 


if (hard) 
TPE_bodyReshape(body, wor ld->environmentFunction) ; 
bodyTension /= body->connectionCount; 
if (bodyTension > TPE RESHAPE TENSION LIMIT 


for (uint8_t k = 0; k < APE RESHAPE ITERATIONS; ++k) 
TPE bodyReshape(body, wor ld->environmentFunction); 


if_(1(body->f lags & TPE_BODY_FLAG_SIMPLE_CONN) ) 
__bodyCance LOutVelocities(body, hard); 
} 3 
for (uinti6 t j = 0; j < world->bodyCount; ++j) 
if (j > i || (world->bodies[j].flags & TPE_BODY_FLAG_DEACTIVATED) ) 
í // firstly quick-check collision of body AA bounding boxes 


TPE Vec3 aabbMin2, aabbMax2; ; 
TPE bodyGetAABB(&wor ld-»bodies[j],&aabbMin2,&aabbMax2); 


TPE body2Index - j; 


if (TPE hecküver I apAnppaabbHin,sabbMax, adbOMin2, gaBbMaxz) && 
TPE_bodiesResolveCollision(body,world->bodies + j, 
wor Ld->environmentFunction) ) 


ee bodyActivate(bod nn 
body->deactivateCount = TPE LIGHT DEACTIVATION; 


JEF bodyActivatelworld bodies + j); 
} wor ld->bodies[j].deactivateCount = TPE LIGHT DEACTIVATION; 
} 
H 


if (!(body-»flags & TPE BODY FLAG ALWAYS ACTIVE)) 
if (body->deactivateCount >= TPE DEACTIVATE AFTER) 
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FEE bodyStop( body) ; 

body->deactivateCount = 0; 

g body->flags |= TPE BODY FLAG DEACTIVATED; 

else if (TPE bodyGetAverageSpeed(body) «- TPE LOW SPEED) 
body->deactivateCount++; 

else 
body->deactivateCount = 0; 


} 
H 
H 
void TPE bodyActivate(TPE Body *body) 


// the if check has to be here, don't remove it 


if (body->flags & TPE BODY FLAG DEACTIVATED) 
TPE bodyStop(body); 
body et lane ee OY dé Bopv. FLAG. DEACTIVATED; 
} body->deactivateCount = 0; 
H 
TPE Unit TPE bodyGetNetSpeed(const TPE Body *body) 


hir TPE APPROXIMATE NET SPEED 
TPE Vec3 netV - TPE vec3(0,0,0); 


const TPE Joint *joint = body->joints; 
for (uint16_t i = 0; i < body->jointCount; ++i) 
netV.x += TPE_abs Joint Svetoci ty 3]}) 


netV.y += TPE abs(joint-»velocity[1 
netV.z += TPE_abs(joint->velocity[2 


1 
r 


joint++; 
return TPE_vec3LenApprox(netV); 
#else 
TPE_Unit velocity = 0; 
const TPE_Joint *joint = body->joints; 
for (uint16_t i = 0; i < body->jointCount; ++i) 


velocity += TPE LENGTH(. N ; IN . 
TPE_vec3(joint->velocity[0], joint-»velocity[1], joint-»velocity[2])); 


joint++; 
return velocity; 
#endif 
H 
eae TPE_bodyGetAverageSpeed(const TPE_Body *body) 
return TPE_bodyGetNetSpeed(body) / body->jointCount; 


void TPE bodyMultiplyNetSpeed(TPE Body *body, TPE Unit factor) 
TPE Joint *joint = body->joints; 
for (uinti6 t j = 0; j « body->jointCount; ++j) 
for (uint8 t k = 0; k « 3; ++k) 
joint-»velocity[k] = 
(((TPE Unit) joint->velocity[k]) * factor) / 
TPE F; 
joint++; 
H 


void TPE bodyLimitAverageSpeed(TPE Body *body, TPE Unit speedMin, 
TPE Unit speedMax) 


for (uint8 t i = 0; i « 16; ++i) 
TPE Unit speed - TPE bodyGetAverageSpeed(body); 


if (speed »- speedMin && speed «- speedMax) 
return; 


TPE Unit fraction - 
{((speedmax + speedMin) / 2) * TPE_F) / 
, nonZero(speed); 


TPE bodyMultiplyNetSpeed(body, fraction); 
} H 
void TPE bodyCancelOutVelocities(TPE Body *body, uint8 t strong) 
for (uinti16 t i = 0; i < body->connectionCount; ++i) 
TPE Connection *c = &body-»connections[i]; 


TPE Joint *ji 
TPE Joint *j2 


&(body->joints[c->joint1]); 
atbedy ioin fezii]; 


TPE Vec3 dir = TPE_vec3Minus(j2->position, j1->position) ; 


TPE_Unit len 


TPE nonZero(TPE LENGTH(dir)); 

uint8 t cancel - 1; 

if (strong) 
TPE Unit tension = TPE connectionTension(len,c-»length); 


cancel - tension «- TPE TENSION ACCELERATION THRESHOLD && 
tension »- -1 * TPE TENSION ACCELERATION THRESHOLD; 


if (cancel) 


TPE Vec3 
vi = TPE vec3(ji-»velocity[0], j1-»velocity[1], j1-»velocity[2 
v2 = TPE vec3(32-»velocity[01], 32-»velocity[1], 32-»velocity[2]); 
dir.x - (dir.x * TPE F) / len; // normalize 
dir.y - (dir.y * TPE F) / len; 
dir.z - (dir.z * TPE F) / len; 
vi 


TPE-vecsbrolectNormalizedi vo dary: 


v2 TPE vec3ProjectNormalized(v2,dir 


f 


TPE Vec3 avg = TPE vec3Plus(v1,v2); 
avg.x /= 2; 
avg.y /= 2: 
avg.z /= 2; 


if (strong) 
{ 


ji-»velocity[0] = ji-»velocity[0] - vi.x + avg.x; 
]i-»velocity[1] = j1->velocity[1] - vi.y + avg.y; 
ji->velocity[2] = j1->velocity[2] - v1.z + avg.z; 
j2->veloci j2-»velocity[0] - v2.x + avg.x; 
]2-»veloci ]2-»velocity[1] - v2.y + avg.y; 
j2-»veloci j2-»velocity[2] - v2.2 + avg.z; 
l 
105 
ji-»velocity[0] = ji-»velocity[0] - vi.x + (v1.x * 3 + avg.x) / 4; 
ji-»velocity[1] = ji-»velocity[1] - vi.y + (v1.y * 3 + avg.y) / 4; 
ji->velocity[2] = ji-»velocity[2] - v1.z + (v1.z * 3 + avg.z) / 4; 
j2->velocity[0] = j2-»velocity[0] - v2.x + (v2.x * 3 + avg.x) / 4; 
j2-»velocity[1] = j2-»velocity[1] - v2.y + (v2.y * 3 + avg.y) / 4; 
} j2-»velocity[2] = j2-»velocity[2] - v2.z + (v2.2 * 3 + avg.z) / 4; 
3 
3 
3 
void TPE_bod Reshape(TPE-Body *body, 
TPE_ClosestPointFunction environmentFunction) 


for (uint16_t i = 0; i < body-»connectionCount; ++i) 
TPE_Connection *c = &body->connections[i]; 


TPE_Joint *j1 = &(body->joints[c->joint1]); 
TPE Joint *j2 = &(body-»joints[c-»joint2]); 

TPE Vec3 dir = TPE_vec3Minus(j2->position, j1->position) ; 
TPE Vec3 middle = TPE_vec3PLus(ji->position, j2->position); 


middle.x /= 2; 
middle.y /= 2; 
middle.z /= 2; 


TPE vec3Normalize(&dir); 


dir.x = (dir.x * c-»length) / TPE F; 
dir.y = (dir.y * c->length) / TPE F; 
dir.z = (dir.z * c-»length) / TPE F; 


TPE Vec3 positionBackup = ji1-»position; 


ji->position.x 
j1->position.y 
ji->position.z 


middle.x - dir.x / 2; 
middle.y - dir.y / 2; 
middle.z - dir.z / 2; 


if (environmentFunction != 0 && TPE LENGTH(TPE vec3Minus(ji-»position, 
environmentFunction(ji-»position,TPE JOINT SIZE(*j1))) 
< TPE JOINT SIZE(*ji)) 
ji-»position = positionBackup; 


positionBackup j2->position; 


j2->position.x = ji-»position.x + dir.x; 
j2-»position.y = j1->position.y + dir.y; 
j2-»position.z = ji-»position.z + dir.z; 
if (environmentFunction != 0 && TPE LENGTH(TPE vec3Minus(j2-»position, 
environmentFunction(j2-»position,TPE JOINT SIZE(*j2))) 
< TPE JOINT. SIZE(*]2]) 
j2->position = positionBackup; 
H 
pore TPE vec3Plus(TPE Vec3 vi, TPE_Vec3 v2) 
V1.x += V2.X; 


vi.y += v2.y; 
vi.z += v2:2; 


return vi; 


H 

oe TPE_vec3Minus(TPE_Vec3 vi, TPE_Vec3 v2) 
vi.y -= v2.y; 
v1.2 -= : 


return vi; 


H 
us TPE vec3Normalize(TPE Vec3 *v) 
TPE Unit l - TPE LENGTH(*v); 


if (l == 0) 
*y = TPE_vec3(TPE_F,0,0); 
else 


if (l < 16) // too short vec would cause inacurracte normalization 


v->x *= 8; 


v->y *= 8; 

v->z *= 8; 

l = TPE_LENGTH(*v); 
H 
v-»x = (v-»x * TPE F) / l; 
v->y = (v->y * TPE F) / l; 
v-»z = (v->z * TPE_F) / l; 


TPE_Vec3 IPE bodyGetRotation(const TPE Body *body, uinti6 t joint1, 
uinti6 t joint2, uinti6 t joint3) 


return TPE rotationFromVecs( 

TPE vec3Minus( 
body-»joints[joint2].position 
body->joints[joint1 ‘position), 

TPE_vec3Minus( 
body->joints[joint3].position 
body->joints[joint1 ‘position)); 


TPE_Vec3 TPE_bodyGetCenterOfMass(const TPE_Body *body) 
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// note that joint sizes don't play a role as all weight the same 
TPE Vec3 result = TPE_vec3(0,0,0); 
const TPE Joint *j - body-»joints; 
for (uinti6 t i = 0; i < body->jointCount; ++i) 
result = TPE vec3Plus(result, j-»position); 


j++; 


} 


result.x /= body->jointCount; 
result.y /- body-»jointCount; 
result.z /- body-»jointCount; 


return result; 


H 

void TPE bodySpinWithCenter(TPE Body *body, TPE_Vec3 rotation, TPE Vec3 center) 
for (uinti6 t i = 0; i < body->jointCount; ++i) 
í TPE_Joint *j = body->joints + i; 


TPE_Vec3 toPoint = TPE_vec3Minus(j->position, center); 


toPoint = TPE_vec3Project(toPoint, rotation); 
toPoint = TPE_vec3Plus(center,toPoint); 
toPoint = TPE_vec3Minus(j->poSition, toPoint); 
toPoint = TPE_vec3Cross(toPoint, rotation); 


j->velocity[1] += toPoint.y; 
j-»velocity[2] += toPoint.z; 


H 

H 

et TPE_bodySpin(TPE_Body *body, TPE_Vec3 rotation) 
TPE_bodySpinwithCenter (body, rotation, TPE_bodyGetCenterOfMass(body) ); 


jd] *- toPoint.x; 


TPE Vec3 TPE rotateByAxis(TPE Vec3 p, TPE Vec3 axisNormalized, TPE Unit angle) 


TPE Vec3 projected - TPE vec3ProjectNormalized(p,axisNormalized); 
TPE Vec3 a - TPE vec3Minus(p, projected); 


if (a.x == 0 && a.y == 0 && a.z == 0) 
return p; 


TPE Vec3 b - TPE vec3Cross(a, axisNormalized); 


return TPE vec3Plus projected TPE vec3Plus( 
TPE-vec3Times(b,T EE Hi T 
; 


TPE vec3Times(b,TPE sin(angle 


Ls TPE bodyRotateByAxis(TPE Body *body, TPE Vec3 rotation) 


TPE Vec3 bodyCenter - TPE bodyGetCenterOfMass(body); 
TPE Unit angle - TPE LENGTH(rotation); 


TPE vec3Normalize(&rotation); 


for (uinti6 t i = 0; i < body->jointCount; ++i) 
TPE Vec3 toPoint - TPE vec3Minus(body-»joints[i].position,bodyCenter); 
body->joints[i].position = TPE vec3P us(bodycenter, 
_TPE_rotateByAxis(toPoint, rotation, angle) ); 


H 
H 
TPE Vec3 TPE vec3Cross(TPE Vec3 v1, TPE Vec3 v2) 
TPE Vec3 r; 
r.X = (V1.y * v2.z - VEZ * v2.y) / IPEF: 
r.y = (V1.Z * v2.x - V1.x * v2.2) / TPE_F; 
r.Z = (v1.x * v2.y - vi.y * v2.x) / TPE F; 


return r; 


TPE Vec3 TPE vec3ProjectNormalized(TPE Vec3 v, TPE Vec3 baseNormalized) 
TPE Vec3 r; 


TPE Unit p - TPE vec3Dot(v,baseNormalized); 


r.x = (p * baseNormalized.x) / TPE F; 
r.y - (p * baseNormalized.y) / TPE F; 
r.z = (p * baseNormalized.z) / TPE F; 
return r; 


TPE Vec3 TPE vec3Project(TPE Vec3 v, TPE Vec3 base) 


TPE vec3Normalize(&base); 


return TPE vec3ProjectNormalized(v,base); 


void TPE bodyMoveBy(TPE Body *body, TPE Vec3 offset) 
for (uinti6 t i = 0; i < body->jointCount; ++i) 
bo y-zjoints[i] position = TPE vec3Plus(body-»joints[i].position, 
offset); 
v TPE bodyApplyGravity(TPE Body *body, TPE Unit downwardsAccel) 
if (fpody->f tags & TPE BODY FLAG DEACTIVATED) || 


body->flags & TPE BODY FLAG DISABLED)) 
return; 


for (quinti t i = 0; i < body->jointCount; ++i 
} bo y-Sjoints[i].velocity[1} -= downwardsAccel; 
void TPE_bodyAccelerate(TPE_Body *body, TPE_Vec3 velocity) 
TPE_bodyActivate(body); 
for (uinti6 t i = 0; i < body->jointCount; ++i) 


body->joints[i].velocity[0] += velocity.x; 
body-»joints[i].velocity[1] += velocity.y; 


body->joints[i].velocity[2] += velocity.z; 
H 
void TPE bodyStop(TPE Body *body) 


for (uinti6 t i = 0; i < body->jointCount; ++i) 


body->joints[i].velocity[0] = 0; 
body->joints[i].velocity[1] = 0; 
body->joints[i].velocity[2] = 0; 


} 


void TPE bodyNonrotatingJointCollided(TPE Body *b, int16_t jointIndex, 
TPE Vec3 origPos, uint8 t success) 


origPos = TPE vec3Minus(b-»joints[jointIndex].position,origPos); 


for (uinti16 t i = 0; i < b-»jointCount; ++i) 
if (i != jointIndex) 


b->joints[i].position = TPE vec3Plus(b-»joints[i].position,origPos); 
if (success 
f fot 


for (uin 


j =0; 4 <3; 
b-šjoints{i] óclty 1 


Tj) 
.velocity[j] = D^» joints[jointindex].velocity[j]; 
H 
TPE Unit TPE vec3Dot(TPE Vec3 vi, TPE Vec3 v2) 


return (v1.x * v2.x + vi.y * v2.y + viz * v2.z) / TPE_F; 


TPE_Unit TPE_cos(TPE_Unit x) 
return TPE_sin(x + TPE_F / 4); 


TPE_Unit TPE_sin(TPE_Unit x) 
int8_t sign = 1; 
if (x < 0) // odd function 


x *- -1 
sign - -1; 
x %= TPE F; 


if (x » TPE F / 2) 
x -= TPE_F / 2; 
sign *- -1; 
TPE Unit tmp = TPE_F - 2 * x; 


#define _PI2 5053 // 9.8696044 * TPE F 
return sign * // Bhaskara's approximation 


(32 * x * PI2) / TPE F) * tmp) / 
.PI2 * (5 * TPE_F - (8 * x * tmp) / 
TPE F)) / TPE F); 

#undef _PI2 


} 


uint8 t TPE bodiesResolveCollision(TPE Body *b1, TPE_Body *b2, 
TPE ClosestPointFunction env) 


uint8_t r = 0; 


for (uint16_t i = 0; i < b1->jointCount; ++i) 
for (uint16_t j = 0; j < b2->jointCount; ++j) 


TPE_Vec3 origPos2 = 


bi-sloints [1] position! 


TPE Vec3 origPos1 b1-»joints[i].position; 
.TPE jointiIndex = i; 
.TPE joint2Index = j; 


if (TPE-jointsResolvecollision £(b1-s]oints il) &(b2-sjointsD) J; 
bi-»jointMass,b2-»2jointMass,(bi--elàsticity + b2->elasticity) / 2, 
(bi-»friction + b2->friction) / 2,env)) 
r=1; 
if (b1->flags & TPE_BODY_FLAG_NONROTATING) 

_TPE_bodyNonrotatingJointCollided(b1,i,origPos1,1); 


if (b2-»fla s & TPE BODY FLAG, NONROTATING) . 
} _TPE_bodyNonrotatingJointCollided(b2,j,origPos2,1); 
H 
return r; 
uint8 t TPE jointsResolveCollision(TPE Joint *j1, TPE Joint *j2, 
TPE Unit massi, TPE Unit mass2, TPE Unit elasticity, TPE Unit friction, 
TPE ClosestPointFunction env) 
TPE Vec3 dir = TPE_vec3Minus(j2->position, j1->position) ; 
TPE Unit d = TPE LENGTH(dir) - TPE_JOINT_SIZE(*j1) - TPE JOINT SIZE(*j2); 
if (d « 0) // collision? 


if ( TPE collisionCallback != 0 && ! TPE collisionCallback( 
Tee body1Index, TPE jointtIndex, TPE body2Index, TPE_Joint2index, 


TPE vec3Plus(j1i-»position,dir))) 
return 0; 
TPE Vec3 
posiBackup - ji-»position, 
pos2Backup - j2-»position; 


// separate joints, the shift distance will depend on the weight ratio: 
d = -1 * d + TPE COLLISION RESOLUTION MARGIN; 
TPE vec3Normalize(&dir); 


TPE Unit ratio - (mass2 * TPE F) / 
TPE nonZero(massi + mass2); 


TPE Unit shiftDistance - (ratio * d) / TPE F; 
TPE Vec3 shift = TPE_vec3Times(dir,shiftDistance) ; 


ji->position = TPE_vec3Minus(ji1->position, shift); 
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shiftDistance - d - shiftDistance; 

shift - TPE vec3Times(dir,shiftDistance); 

j2-»position - TPE vec3Plus(j2-»position,shift); 

// compute new velocities: 

TPE Unit vi, v2; 

TPE_Vec3 vel = TPE_vec3(ji->velocity[0],j1->velocity[1],j1->velocity[2]); 
vel = TPE_vec3Project(vel, dir); 


j1-»velocity[1 
j1->velocity[2 


ji-»velocity[1] - vel.y; 


ji-»velocity[0O 
ji-»velocity[2] - vel.z; 


ES LEN - vel.x; 


/* friction explanation: Not physically correct (doesn't depend on load), 
friction basically means we weighted average the velocities of the bodies 
in the direction perpendicular to the hit normal, in the ratio of their 
masses, friction coefficient just says how much of this effect we apply 
(it multiplies the friction vectors we are subtracting) */ 


TPE_Vec3 frictionVec = 
TPE vec3(ji-»velocity[0], ji-»velocity[1], ji-»velocity[2]); 


vi - TPE_vec3Dot(vel, dir); ^ ; F 
vel = TPE_vec3(j2->velocity[0], j2-»velocity[1], j2->velocity[2]); 
vel = TPE_vec3Project(vel, dir 


r 


]2-»velocity[1 


2-»velocity[1] - vel.y; 
j2-»velocity[2 j y ži 


j2-»velocity[0O 
j2-»velocity[2] - vel.z; 


1 Svetoci ty ti - vel.x; 


frictionVec = TPE_vec3Minus( 
TPE vec3(j2-»velocity[0], j2-»velocity[1], j2-»velocity[2]), 
frictionvec); 
v2 = TPE vec3Dot(vel,dir); 
TPE getVelocitiesAfterCollision(&v1,&v2,massi,mass2,elasticity); 
vel - TPE vec3Times(dir,v1); 
fine assignVec(j,i,d,0) V — . E 
"ive tecity[i] = j-»velocity[i] + vel.d o (((frictionVec.d * ratio) / \ 
TPE F) * friction) / TPE F; 
assignVec(j1,0,x,+ 
assignVec(j1,1,y,+ 
assignVec(j1,2,z,+ 
vel = TPE_vec3Times(dir,v2); 
ratio = TPE_F - ratio; 


assignVec(]2,1,y, - 
assignVec(j2,2,Z, - 


asume py] 
def assignVec 
if (env != 0) 
// ensure the joints aren't colliding with environment 


if (TPE jointEnvironmentResolveCollision(ji,elasticity,friction,env) -- 


ji-»position = posiBackup; 
if (TPE jointEnvironmentResolveCollision(j2,elasticity,friction,env) -- 
j2-»position - pos2Backup; 
return 1; 
eturn 0; 
_Vec3 TPE vec3Times(TPE Vec3 v, TPE Unit units) 
Xx = (v.x * units) / TPE F; 
y = (v.y * units) / TPE F; 
va z * units) / TPE_F; 
eturn v; 
_Vec3 TPE_vec3TimesPlain(TPE_Vec3 v, TPE Unit q) 
Xx *= q; 
yg 
.zo*- q; 
eturn v; 
d TRE getvelocitiesAftercollision( TE Unit *v1, TPE Unit *v2, 
PE Unit m1, TPE Unit m2, TPE Unit elasticity) 


* In the following a lot of TPE F cancel out, feel free to 
check if confused. * 


PE Unit miPm2 
PE Unit v2Mvi 


TPE nonZero(mi + m2); 
TPE nonZero(*v2 - *v1); 


PE Unit miviPm2v2 = ((m1 * *v1) + (m2 * *v2)); 


*vi = (( (elasticity * m2 / TPE F) * v2Mv1) 
* miv 


* 


} 


uin 
T 


í TI 


T 


E 


m2v2) / miPm2; 
v2 = (( (elasticity * m1 / TPE F) * -1 * v2Mv1) 
* miviPm2v2) / miPm2; 
t8 t PES |ointEnvironmentResolveCo LU s10n TPE Joint *joint, . 
PE Unit elasticity, TPE Unit friction, TPE_ClosestPointFunction env) 
PE Vec3 toJoint - 


TPE vec3Minus(joint-»position,env(joint-»position,TPE JOINT SIZE(*joint))); 


PE Unit len = TPE_LENGTH(toJoint); 
f (len <= TPE JOINT SIZE(*joint)) 


AT [-IPE.collisioncallback != 0) 
i {i -TPE-collisioncal tback(_TPE Dod 1Index, 
PE jointiIndex, TPE body2Index, _ a | palace 


) 


TPE vec3Minus(joint-»position,toJoint) 
return 0; 


// colliding 


TPE Vec3 positionBackup = joint->position, shift; 
uint8 t success - 0; 


if (len » 0) 
/* Joint center is still outside the geometry so we can determine the 


normal and use it to shift it outside. This can still leave the joint 
colliding though, so try to repeat it a few times. */ 


for (int i = 0; i < TPE COLLISION RESOLUTION ITERATIONS; ++i) 
shift - toJoint; 
TPE vec3Normalize(&shift); 


shift = TPE vec3Times(shift, TPE JOINT SIZE(*joint) - len + 
TPE COLLISION RESOLUTION MARGIN); 


joint->position = TPE vec3Plus(joint-»position,shift); 


toJoint = TPE vec3Minus(joint-»position,env(joint-»position, 
TPE JOINT SIZE(*joint]] 


i 
len = TPE_LENGTH(toJoint); // still colliding? 
i (len >= TPE JOINT. SIZE(*joint)) 


success - 1; 
break; 


J 
H 
H 
if (!success) 


/* Shifting along normal was unsuccessfull, now try different approach: 
shift back by joint velocity. */ 


shift "SIDE NECS EIE joint->velocity[0],-1 * joint->velocity[1] 
-1 * joint-»velocity12]); 


for (int i = 0; i < TPE COLLISION RESOLUTION ITERATIONS; ++i) 
joint->position = TPE vec3Plus(joint-»position,shift); 


toJoint - TPE vec3Minus(joint-»position, 
env(joint-»position,TPE JOINT SIZE(*joint))); 


len - TPE LENGTH(toJoint); // still colliding? 


if (len >= TPE JOINT. SIZE(*joint)) 


success - 1; 
break; 


// decrease the step a bit 


} } 


if (success) 


TPE_Vec3 vel = TPE_vec3(joint->velocity[0], joint->velocity[1] 
joint->velocity[2]); 


vel = TPE_vec3Project(vel,shift); // parallel part of velocity 


TPE Vec3 vel2 = TPE_vec3Minus( // perpendicular part of velocity 
._ TPE_vec3( joint->velocity[0], joint->velocity[1], joint- 
>velocity[2]),ve J; 


vel2 = TPE_vec3Times(vel2, friction); 
vel = TPE_vec3Times(vel, TPE_F + elasticity); 


vel.x + vel2.x; 
vel.y + vel2.y; 


joint->velocity[1 
vel.z + vel2.z; 


joint->velocity[0] - 
joint->velocity[2 


else 
TPE_LOG("WARNING: joint-environment collision couldn't be resolved"); 


joint->position = positionBackup; 
joint->velocity[0 


joint->velocity[1 = 9; 
joint->velocity[2] = 0; 
n return 2; 
return 1; 
return 0; 


uint8 t TPE bodyEnvironmentCollide(const TPE Body *body, 
TPE ClosestPointFunction env) 


for (uinti6 t i = 0; i < body->jointCount; ++i) 
const TPE Joint *joint = body->joints + i; 
TPE Unit size - TPE JOINT SIZE(*joint); 
if (TPE_DISTANCE(joint->position, env(joint->position,size)) <= size) 
return 1; 
H 
return 0; 
void TPE bodyGetFastBSphere(const TPE Body *body, TPE Vec3 *center 
( TPE Unit *radius) 
TPE Vec3 b; 
TPE bodyGetAABB(body, center, &b); 


center-»x - (center-»x * b.x) / 2; 
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center ->y 
center ->Z 


center->y + b.y 
center->z + b.z 


*radius = TPE_DISTANCE(*center,b); 


void “he aiiud) nene (conse TPE Body *body, TPE Vec3 *center, 


TPE Unit *radius 


TPE INFINITY; 
TPE_ bodyGetCenterOfMass(body); 


*radius 
*center 


const TPE_Joint *j = body->joints; 
for (uint16_t i = 0; i < body->jointCount; 


TPE_Vec3 diff; 


++i) 


TPE_Unit js = TPE_JOINT_SIZE(*j); 


/* Sadly we have to have these conditions here which slow this down. If we 
were only computing a BB sphere of a point cloud, we wouldn't have to 
compute abs vals (as squaring would effectively compute them), but here 
we need to add joint size which needs to know about the sign. */ 


diff.x = ((center->x > j->position.x) ? 
(center: >x - j->position.x) (j->position.x - center->x)) + js; 


diff.y ((center->y > j->position.y) ? 
(center: >y - j->position.y) (j->position.y - center->y)) + js; 


diff.z = ((center->z > j->position.z) ? 
(center->z - j->position.z) (j->position.z - center->z)) + js; 


TPE_Unit distSquared = 
diff.x * diff.x + diff.y * diff.y + diff.z * diff.z; 


if (distSquared < *radius) 
*radius = distSquared; 


} jtt; 


*radius = TPE_sqrt(*radius); 


uint8 t TPE bodyEnvironmentResolveCollision(TPE Body *body, 


{ 


TPE ClosestPointFunction env) 


TPE Vec3 c; 
TPE Unit d; 


TPE bodyGetFastBSphere(body, &c, &d) ; 


if (TPE DISTANCE(c, env(c,d)) » d) 
return 0; 


// now test the full body collision: 


uint8 t collision - 0; 


for (uint16_t i = 0; i < body->jointCount; ++i) 
TPE_Vec3 previousPos = body->joints[i].position; 
.TPE jointiIndex = i; 


uint8 t r - TPE jointEnvironmentResolveCollision( 
body->joints + i,body->elasticity, body->friction, env); 


if (r) 
collision = 1; 


->flags & TPE_BODY_FLAG_NONROTATING) 


if En P 3 i N . 
BodyNonrotatingJointCollided( body, 1, previousPos, r == 1); 


p 


return collision; 


TPE Vec3 TPE vec3Normalized(TPE Vec3 v) 


TPE vec3Normalize(&v); 
return v; 


TPE Unit TPE atan(TPE Unit x) 


/* atan approximation by polynomial 


WARNING: this will break with different value of TPE FRACTIONS PER UNIT */ 


TPE Unit sign = 1, x2 = x * x; 


if (x < 0) 
x *= -1; 
sign - -1; 


if (x » 30000) // anti overflow 
return sign * (TPE F / 4); 


return sign * 
(307 * x + x2) / ((267026 + 633 * x + x2) / 128); 


ee _TPE_vec2Rotate(TPE_Unit *x, TPE_Unit *y, TPE_Unit angle) 


} 


TPE_Unit TPE_vec2Angle(TPE_Unit x, 


TPE_Unit tmp = 


TPE_Unit s = TPE_sin(angle); 
TPE_Unit c = TPE_cos(angle); 
*x * *y) / TPE_F; 


E Fox onis 


*y S * tmp +c * *y) / TPE_F; 


TPE Unit y) 


í TPE Unit r = 0; 


if (x != 0) 
r - TPE atan((y * TPE F) / x); 


if (x « 92 
r += TPE_F / 2; 


else if (r < 0) 


r += TPE F; 
else 
if (y < 9) 
r Es TPE F) / 4 
else i v > 0) 
r = TPÈF/4 
// else (y == j r stays 0 
return r; 


oor TPE_rotationFromVecs(TPE_Vec3 forward, TPE_Vec3 right) 
TPE_Vec3 result; 


// get rotation around Y: 


result.y = TPE_vec2Angle(forward.z,-1 * forward.x); 


// now rotate back by this angle to align with x = © plane: 


_TPE_vec2Rotate(&forward.z,&forward.x,result.y); 
_TPE_vec2Rotate(&right.z, &right. X, result. y) 


// now do the same for the second axis: 


result.x - 
TPE vec2Angle(forward.z,forward.y); 


TPE vec2Rotate(&right.z,&right.y,-1 * result.x); 


result.z - TPE vec2Angle(right.x,-1 * right.y); 


return result; 


} 


TPE_Vec3 _TPE_project3DPoint(TPE_Vec3 p, TPE_Vec3 camPos, TPE_Vec3 camRot, 
( TPE Vec3 camView) 


// transform to camera space: 

p = TPE_vec3Minus(p,camPos) ; 
_TPE_vec2Rotate &p .2,&p.x, camRot y); 
_TPE_vec2Rotate(&p.z,&p.y,-1 * camRot.x); 
_TPE_vec2Rotate(&p.y,&p.x,-1 * camRot.z); 


if (p.z <= 0) 
return p; 


ir (camView.z != 0) 
// perspective 


p. rR EA 


F sz; 


p.x * camView.z 
p.y * camView.z 


p 
p. 
p 


camView.x / 2 + (ry * 
p 


i camView.x) / (2 * TPE F 
camView.y / 2 - 


y * camView.x) / (2 * TPE F 
// ^ x here intentional 


<x 


else 
// ortho 


p.x = camView.x / 2 
p.y = camView.y / 2 


1 
Es] 
<x 


} 


return p; 


} 


void _TPE rawDebugPixel( 
TPE Unit x, TPE Ünit y, 


TPE Unit w, 
TPE DebugDrawFunction f) 


TPE Unit h, uint8 t c, 


if (x >= 0 && x <w && y >= 0 && y « h) 
fox, y,c); 


void TPE worldDebugDraw(TPE World *world, TPE DebugDrawFunction drawFunc, 
TPE Vec3 camPos, TPE Vec3 camRot, TPE Vec3 camView, uinti6_t envGridRes, 
TPE_Unit envGridSize) 


{ 
#define Z_LIMIT 250 . 
if (world->environmentFunction !- 0) 


// environment: 

TPE Vec3 testPoint; 

TPE Unit gridHalfSize - (envGridSize * envGridRes) / 2; 

TPE Vec3 center; 

if (envGridRes !- 0) 

y center - TPE vec3(0,TPE sin(camRot.x),TPE cos(camRot.x)); 


TPE vec2Rotate(&center.x,&center.z,camRot.y); 


center - TPE vec3Times(center,gridHalfSize); 
center = TPE vec3Plus(camPos, center); 

center.x - (center.x / envGridSize) * envGridSize; 
center.y - (center.y / envGridSize) * envGridSize; 
center.z - (center.z / envGridSize) * envGridSize; 


H 
testPoint.y - 


center.y gridHalfSize; 


for (uint8 t j = 0; j < envGridRes; ++j) 
testPoint.x - center.x - gridHalfSize; 
for (uint8 t k = 0; k < envGridRes; ++k) 

testPoint.z - center.z - gridHalfSize; 

for (uint8 t l = 0; l < envGridRes; ++1) 

TPE Vec3 r = world-»environmentFunction(testPoint,envGridSize); 


if (r.x != testPoint.x || r.y != testPoint.y || r.z 


r = TPE project3DPoint(r,camPos, camRot, camView); 
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!= testPoint. 


if (r.z » Z LIMIT i 
SUPE dt BRR EEUGR LW ey Enn Eon Y c ED gwitch (region) 


TPE_DEBUG_COLOR_ENVIRONMENT, drawFunc); #define align(c,i) point.c = center.c + sign[i] * maxCornerVec.c 


testPoint.z += envGridSize; tae 9x92; sun ati Break! 


case 0x04: align(z,2 break; 
testPoint.x += envGridSize; case 0x03: align(x,0); align(y,1); break; 

case 0x05: align(x, 2 ; align(z,2 break; 

case 0x06: align y,i ; align(z,2 break; 


testPoint.y += envGridSize; 
case 0x07: align(x,0); align(y,1); align(z,2); break; 
} default: break; i B 22 ‘ 
for (uinti6 t i = 0; i < world->bodyCount; ++i) #undef align 


// connections: 


for (uinti6 t j = 0; j < world->bodies[i].connectionCount; ++j) return point; 
; 


TPE Vec3 
dox rld->bodies oint : i 
n wor ld: ioaea eS tonmections [i]: jointi].position, TPE Vec3 TPE envAABoxInside(TPE Vec3 point, TPE Vec3 center, TPE Vec3 size) 
p2 = world--bodies[i].joints[ { 
wor ld->bodies[i]. connections[j].joint2].position; Size: y "s 2i 
pi = TPE projerradpaint (pd; camPos, camRot, drca size.z /- 2j 
2 = TPE project3DPoint(p2, camPo mRot, camVie : r 
P progec Sne pecans; ea CAE TPE_Vec3 shifted = TPE_vec3Minus(point, center) 
if 1.z <= Z LIMIT 2.2 <= Z LIMIT 
Ptas: B II P g ) TPE_Vec3 a = TPE_vec3Minus(size, shifted), 
* b - TPE ' vecaPlus(shifted, size); 


TPE Vec3 diff - TPE vec3Minus(p2,p1); üntü-t"sx --d; sy c d, sz: d 
— = , — , E $ 


#define SEGS 16 if (b.x « a.x) 


uint8 t c = (world->bodies[i].flags & TPE BODY FLAG DEACTIVATED) ? { iene 
TPE_DEBUG_COLOR_INACTIVE : TPE_DEBUG_COLOR_CONNECTION; Sx = 4: d 
= Li 
for (uinti16 t k = 0; k « SEGS; ++k) 
p2.x = pi.x + (diff.x * k) / SEGS; ee ee) 
p2.y = pi.y + (diff.y * k) / SEGS; 
asc Duy 
} .TPE drawDebugPixel(p2.x,p2.y,camView.x,camView.y,c,drawFunc); y= 
alae od SEGS if (b.z « a.z) 


ns a.z - b.z; 

// joints: sz = -1: 
for (uinti6 t j = 0; j < world->bodies[i].jointCount; ++j) á 
TPE_Vec3 p = _TPE_project3DPoint(world->bodies[i].joints[j].position, 


camPos, camRot, camView) ; if (a.x < 0 ay « 0 || a.z « 0) 


return poin 
if (p.z » Z LIMIT) 
uint8 t color = (world->bodies[i].flags & TPE BODY FLAG DEACTIVATED) ? 


if (a.x « a.y) 


. 7 if (a.x « a.z) 
TPE DEBUG COLOR INACTIVE : TPE DEBUG COLOR JOINT; point ox = center.x + sx * size.x; 
: : f else 
.TPE drawDebugPixel(p.x,p.y,camView.x,camView.y,color,drawFunc); point.z = center.z + sz * size.z; 
l 
TPE Unit size = TPE JOINT SIZE(world-»bodies[i].joints[j]); else 
if (camView.z !- 0) // not ortho? if (a.y « a.z 
point.y = center.y + sy * size.y; 
size /= 2; else "x 
size - (size * camView.x J TPE_F; point.z = center.z + sz * size.z; 
size = (size * camView.z) / p.z; } 


return point; 
#define SEGS 4. ) 
for (uint8 t k = 0; k < SEGS + 1; ++k) 
poe TPE envSphereInside(TPE Vec3 point, TPE_Vec3 center, TPE Unit radius) 


Te Unit 
FUE, sin(TPE F * k / (8 * SEGS)) * size) TPE Vec3 shifted - TPE vec3Minus(point,center); 
nui cos(TPE_F * k / (8 * SEGS)) * size) TPE Unit l - TPE LENGTH(shifted); 
if (l >= radius 
&define dp(a,b,c,d) \ eekurnvernee” 
.TPE i| BrouDend FAVA .X a b,p.y c d,camView.x,camView.y,color,drawFunc); else if (1 < 0 
x, +,dy) dp(*,dx, -,dy) dp(-,dx,*,dy) dp(-, dx, -, dy return TPE_vec3(center.x + radius,center.y,center.z); 
db e ; dy, *; dx) dp(+,dy,-,dx) dp(- ; dy, +, dx) dp(-,dy,-,dx 
sundet UON TPE_vec3Normalize(&shifted) ; 
} l } return TPE_vec3PLus(center, TPE_vec3Times(shifted, radius) ); 
H 
PM Z LIMIT oin TPE envSphere(TPE Vec3 point, TPE Vec3 center, TPE Unit radius) 
H 


TPE Vec3 dir - TPE vec3Minus(point,center); 


TPE Vec3 TPE envBox(TPE Vec3 point, TPE Vec3 center, TPE_Vec3 maxCornerVec, N 
TPE_Vec3 rotation) TPE_Unit l = TPE_LENGTH(dir); 


point = TPE pointRotate(TPE | vecaMinus(point, center), 


radius) 
TPE rotationInverse(rotation)); 


point; 


dir.x * radius) / l; 
dir.y * radius) / l; 
dir.z * radius) / l; 


return 
TPE vec3Plus(center,TPE pointRotate(TPE envAABox(point,TPE vec3(0,90,0), 
maxCornerVec), rotation)); 


return TPE vec3Plus(center,dir); 


TRENGES TPE_envAABox(TPE_Vec3 point, TPE_Vec3 center, TPE Vec3 maxCornerVec) H 
TPE Vec3 shifted = TPE_vec3Minus(point, center); TPE Vec3 TPE envHalfPlane(TPE Vec3 point, TPE Vec3 center, TPE Vec3 normal) 
int8 t sign[3] - ü. 3. d { 


TPE_Vec3 point2 = TPE_vec3Minus(point, center); 


^ xc . TPE Unit tmp = : 
shifted.x qud point2.x * normal.x + point2.y * normal.y + point2.z * normal.z; 


if (tmp « 0) 
if (shifted.y « 0) return point; 


shifted.y *- -1; TPE Unit l = TPE LENGTH(normal); 
sign[1] = -1; tmp /= 1; 
= L 
if (shifted.z « 0) normal.x = (normal.x * TPE F) / l; 
normal.y = (normal.y * TPE F) / l; 
shifted.z *= -1; normal.z = (normal.z * TPE F) / l; 


sign[2 
return TPE yecaninus(point, 
TPE_vec3Times(normal, tmp) ); 
uint8_t region = 
shifted.x > maxCornerVec.x) | 
tehirted.> > DA «« 3} | uint8_t TPE_checkOver LapAABB(TPE_Vec3 viMin, TPE_Vec3 viMax, TPE_Vec3 v2Min, 
<< 2); TPE_Vec3 v2Max) 


shifted.z > maxCornerVec.z 
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TPE Unit dist; 
#define test(c) \ 

dist = viMin.c + viMax.c - v2Max.c - v2Min.c; \ 
if (dist < 0) dist *= -1; \ 
if (dist > viMax.c - viMin.c + v2Max.c - v2Min.c) return 0; 
test(x 
test(y 
test(z 


#undef test 


return 1; 


void TPE_bodyGetAABB(const TPE_Body *body, TPE_Vec3 *vMin, TPE_Vec3 *vMax) 


*vMin 


body->joints[0].position; 
*vMax i 


*vMin; 


TPE Unit js = TPE_JOINT_SIZE(body->joints[0]); 


vMin->x -= js; 
vMin->y -= ]s; 
vMin->z -= js; 


vMax-»x += js; 
vMax->y += ]S; 
vMax->Z += jS; 


for (uinti6 t i = 1; i < body->jointCount; ++i) 
TPE_Unit v; 
js = TPE_JOINT_SIZE(body->joints[i]); 
#define test(c) \ . Pe 4 
v = body-»joints[i].position.c - js; \ 
if M < vMin->c) \ 
vMin->c = v; 
v += 2 * asi \ 
if (v > vMax->c) \ 
vMax->c = v; 
test(x 
test(y 
test(z 
#undef test 
H 
void TPE jointPin(TPE Joint *joint, TPE Vec3 position) 
joint->position = position; 
joint-»velocity[O 


joint-»velocity[1 
joint->velocity[2 


9; 
9; 


TPE Vec3 TPE pointRotate(TPE Vec3 point, TPE Vec3 rotation) 


.TPE vec2Rotate(&point.z,&point.y,rotation.x); 


.TPE vec2Rotate(&point.y,&point.x,rotation.z); 
.TPE vec2Rotate(&point.x,&point.z,rotation.y); 


return point; 


TPE Vec3 TPE rotationInverse(TPE Vec3 rotation) 


/* If r1 = (X,Y,Z) is rotation in convention ABC then r1^-1 = (-X,-Y,-Z) in 
convention CBA is its inverse rotation. We exploit this, i.e. we rotate 
Torward/r ight vectors in opposite axis order and then turn the result 
into normal rotation/orientation. * 


TPE Vec3 f 


TPE vec3(0,0,TPE F); 
TPE Vec3 r 


TPE vec3(TPE' F, 0,0); 
rotation.x 
rotation.y *= -1; 
rotation.z *= ; 
_TPE_vec2Rotate(&f.x,&f.z,rotation.y); 
_TPE_vec2Rotate(&f.z,&f.y, rotation.x); 
.TPE vec2Rotate(&f.y,&f.x,rotation.z); 
.TPE vec2Rotate(&r.x,&r.z,rotation.y); 
.TPE vec2Rotate(&r.z,&r.y,rotation.X); 
.TPE vec2Rotate(&r.y,&r.x,rotation.z); 


return TPE rotationFromVecs(f,r); 


H 
toe TPE_rotationRotateByAxis(TPE_Vec3 rotation, TPE_Vec3 rotationByAxis) 


TPE_Vec3 f = TPE_pointRotate(TPE_vec3(0,0,TPE_F), rotation); 
TPE_Vec3 r = TPE_pointRotate(TPE_vec3(TPE_F, 0,0), rotation 


h 


TPE_Unit a = TPE_LENGTH(rotationByAxis); 
TPE_vec3Norma ize(&rotationByAXis); 


f 
r 


_TPE_rotateByAxis(f, rotationByAxis, a); 
.TPE rotateByAxis(r,rotationByAxis,a 


r 


return TPE_rotationFromVecs(f,r); 


H 
TPE Unit TPE keepInRange(TPE Unit x, TPE Unit xMin, TPE Unit xMax) 
return x » xMin ? (x « xMax ? x : 


xMax) xMin; 


TPE Vec3 TPE vec3KeepWithinDistanceBand(TPE Vec3 point, TPE_Vec3 center 
TPE Unit minDistance, TPE Unit maxDistance) 


1 
TPE Vec3 toPoint - TPE vec3Minus(point,center); 
TPE Unit l - TPE LENGTH(toPoint); 


if (l <= maxDistance) 


if (l >= minDistance) 
return point; 


} l = minDistance; 
else , 
l = maxDistance; 


return TPE vec3Plus(center, , 
TPE vec3Times(TPE vec3Normalized(toPoint),1)); 


TPE Vec3 TPE vecskeepWithinBox(TPE_vec3 point, TPE_Vec3 boxCenter 
TPE Vec3 boxMaxVect ) 


{ 
point.x = TPE_keepInRange(point.x, 
boxCenter.x - boxMaxVect.x,boxCenter.x + boxMaxVect.x); 


point.y = TPE_keepInRange(point.y, 
boxCenter.y - boxMaxVect.y,boxCenter.y + boxMaxVect.y); 


point.z = TPE_keepInRange(point.z, 
boxCenter.z - boxMaxVect.z,boxCenter.z + boxMaxVect.z); 


return point; 


} 


TPE Vec3 TPE envInfiniteCylinder(TPE Vec3 point, TPE_Vec3 center, TPE Vec3 


direction, TPE Unit radius) 


TPE Vec3 d = TPE vec3Minus(point,center); ; 
d = TPE vec3Minus(d, TPE vec3Project(d,direction)); 


TPE Unit 1 = TPE LENGTH(d); 


if (l «- radius) 
return point; 


radius = l - radius; 


d.x = (d.x * radius) / l; 
d.y = (d.y * radius) / 1; 
d.z = (d.z * radius) / 1; 
return TPE_vec3Minus(point,d); 


} 


TPE_Vec3 pre E dd point, TPE Vec3 center, TPE Vec3 direction, 


( TPE Unit radius 


point - TPE vec3Minus(point,center); 


TPE Vec3 projected - TPE vec3Project(point,direction); 


point = TPE envInfiniteCylinder(point,TPE vec3(0,0,0),direction,radius); 


TPE Unit lDir = TPE nonZero(TPE LENGTH(direction)); 
TPE Unit lDiff - TPE LENGTH(projected) - lDir; 
if (lDiff > 0) 


direction.x = (direction.x * lDiff) / lbDir; 
direction.y = (direction.y * lDiff) / lDir; 
direction.z = (direction.z * lDiff) / Dir; 


point = (TPE_vec3Dot(projected,direction)) >= 0 ? 
TPE vec3Minus(point,direction) : TPE_vec3PLus(point, direction); 


return TPE vec3Plus(center, point); 


} 


TPE Vec3 TPE fakeSphereRotation(TPE Vec3 positioni, TPE_Vec3 position2, 
TPE Unit radius) 


{ 
TPE_Vec3 m; 
m.x = positioni.z - position2.z; 
m.y = 0; 
m.z = position2.x - positioni.x; 


TPE Unit l = TPE sqrt(m.x * m.x + m.z * m.z); 


if (l-- 0) 
return TPE_vec3(0,0,0); 


TPE Unit d - (TPE DISTANCE(positioni,position2) * 
TPE F) / (radius * 4); 


m.x = (m.x * d) / 1; 
m.z = (m.z * d) / 1; 
return m; 


H 
TPE_Vec3 TPE castEnvironmentRay(TPE Vec3 rayPos 


TPE ClosestPointFunction environment, TPE Uni 
( TPE Unit rayMarchMaxStep, uint32 t maxSteps) 

TPE Vec3 p - rayPos; 

TPE Vec3 p2 = environment(rayPos, rayMarchMaxStep) ; 

TPE_Unit totalD = 0; 


TPE_Vec3 rayDir, 
insideStepSize, 


TPE vec3Normalize(&rayDir); 
uint8 t found - 0; // 0 - nothing found, 1 - out/in found, 2 - in/out 
if (p2.x !- p.x || p2.y !- p.y || p2.z !- p.z) 

// outside ray: ray march 

for (uint32 t i = 0; i « maxSteps; ++i) 

t TPE_Unit d = TPE_DISTANCE(p, p2); 


if (d > rayMarchMaxStep) 
d = rayMarchMaxStep; 


totalD += d; 


p2 = TPE_vec3Plus(rayPos,TPE_vec3Times(rayDir,totalD)); 


if (d == | 
2.X == p.x && p2.y == p.y && p2.z == p.z 
(Burn pP // point not aside S but bis Je , ideal case 


TPE Vec3 pTest - environment(p2,rayMarchMaxStep); 

t (pTest.x -- p2.x && pTest.y -- p2.y && pTest.z -- p2.z) 
// stepped into env, will have to iterate 
found = 1; 
break; 


} 
p = p2; 
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found 


p2 = pTest; 


else if (insideStepSize != 0) 
// inside ray: iterate by fixed steps 
for (uint32_t i = 0; i < maxSteps; ++i) 
í totalD += insideStepSize; 
p2 = TPE_vec3Plus(rayPos,TPE_vec3Times(rayDir,totalD)); 
TPE_Vec3 pTest = environment(p2,16); 


if (p2.x != pTest.x || p2.y != pTest.y || p2.z != pTest.z) 


found = 2; 
break; 


b2 P 
} 3 
if (found) 
/* Here we've found two points (p, p2), each one the other side of the 


env surface. Now iterate (binary search) to find the exact surface 
pos. 


for (uint8_t i = 0; i < 128; ++i) // upper limit just in case 
TPE_Vec3 middle = TPE_vec3Plus(p, p2); 
middle.x /= 2; 


middle.y /- 2; 
middle.z /- 2; 


if (imide: x == p.x && middle.y == p.y && middle.z == p.z) || 
(middle.x p2.x && middle.y == p2.y && middle.z == p2.z) 
break; // points basically next to each other, don't continue 


TPE_Vec3 pTest = environment(middle,16); // 16: just a small number 


if ((found == 1) = 3 
(pTest.x -- middle. x && pTest.y == middle.y && pTest.z == middle.z)) 
p2 = middle; 
else 
} p = middle; 


return (found == 1) ? p : p2; 
return TPE_vec3(TPE_INFINITY, TPE_INFINITY, TPE_INFINITY) ; 


TPE Vec3 TPE | cast BodyRay(TPE Vec3 rayPos, TPE Vec3 rayDir, inti6 t excludeBody, 
const TPE World *world, inti6 t *bodyIndex, inti16 t *jointIndex) 


TPE_vec3(TPE_INFINITY, TPE INFINITY,TPE INFINITY); 
TPE INFINITY; 


TPE Vec3 bestP 
TPE Unit bestD 


if (bodyIndex !- 0) 
*bodyIndex - -1; 


if (jointIndex != 0) 
*jointIndex = -1; 


TPE vec3Normalize(&rayDir); 
Hd (uinti6 t i = 0; i < world->bodyCount; ++i) 


TPE Vec3 c, p; 
TPE Unit r, d; 


TPE bodyGetFastBSphere(&world-»bodies[i],&c,&r); 


c 
p 


if (TPE_vec3Dot(p,rayDir) >= 0) // point is in ray's forward dir? 
d = TPE_DISTANCE(p, C); 


TPE vec3Minus(c,rayPos); 
TPE “vec3ProjectNormalized(c, rayDir); 


if (d <= r) 


// bounding sphere hit, now check all joints: 


const TPE Joint *joint = world->bodies[i].joints; 
for (uint16_t j = 0; j < world->bodies[i].jointCount; ++j) 


c 
C 


p 
tt (TPE_vec3Dot(p,rayDir) >= 0) 


d = TPE_DISTANCE 
TPE Unit js = 


joint-»position; 
TPE vec3Minus(c,rayPos); 
TPE “vec3ProjectNormalized(c, rayDir); 


BLP Glár srzE(*joint); 
if (d <= js) 


// joint hit, compute exact coordinates: 
if (bodyIndex !- 0) 
*bodyIndex = i; 


if (jointIndex !- 0) 
*jointIndex = j; 


c = TPE_vec3Times(rayDir, TPE Sorts * js -d*d)); 
// ^ offset vector to two intersections 
p = TPE vec3Plus(p,rayPos); 


TPE Vec3 . 3 . 
ii = TPE vec3Plus(p,c), // intersection points 
TPE vecaMinus(p, €); 


i2 


d - TPE DISTANCE(rayPos, i1); 
TPE Unit d2 = TPÉ DISTANCE(rayPos, i2); 


if (d2 < d) // take the closer one 


bestD - d; 
bestP = il; 
} H 
H 
joint++; 


3 
3 
3 


return bestP; 


void TPE worldDeactivateAll(TPE World *world) 


none uint16_t i = 0; i < world->bodyCount; ++i) 
} "bodyDeactivaté(&wor ld- »bodies[i]); 


void TPE worldActivateAll(TPE World *world) 
for (uinti6 t i = 0; i < world->bodyCount; ++i) 
TP "bodyActivate(&wor ld-»bodies[i]): 
E TPE worldGetNetSpeed(const TPE World *world) 
TPE Unit result 0; 


for (uinti6 t i = 0; i < world- zbodycount, ++i) 
result += TPE Bodveetnerseed (NOE d->bodies + i); 


return result; 


TPE_Vec3 TPE_bodyGetLinearVelocity(const TPE_Body *body) 
í TPE_Vec3 r = TPE_vec3(0,0,0); 
for (uint16_t i = 0; i < body->jointCount; ++i) 
r Eppe VeesPlus (t, TPE vocal vio], LA] WET) 


r.x /= body->jointCount; 
r.y /- body-»jointCount; 
r.z /- body-»jointCount; 


return r; 


TPE Unit TPE abs(TPE Unit x) 


return x >= 0 ? x : (-1* x); 


TPE Unit TPE max(TPE Unit a, TPE Unit b) 


return (a > b) ? a: b; 


TPE_Unit TPE_min(TPE_Unit a, TPE_Unit b) 


return (a < b) ? a: b; 


TPE_Vec3_TPE_envAATriPrism(TPE_Vec3 point, TPE_Vec3 center, 
const TPE_Unit sides[6], TPE_Unit depth, uint8_t direction) 


point = TPE_vec3Minus(point, center); 


if (direction == 1) 
TPE_Unit tmp = point.z; 
point.z = point.y; 

j point.y - tmp; 

else if (direction -- 2) 
TPE Unit tmp - point.z; 
point.z - point.x; 
point.x - tmp; 

depth /- 2; 

if (point.z » depth) 
point.z = depth; 

else 


t depth *= -1; 


if (point.z < depth) 
point.z = depth; 


for (uint8_t i = 0; i < 6; i += 2) 
uint8 t i2 


u 
B 
^ 
> 
» 
B 
"m 
N 
S 


TPE Vec3 - 
TPE SenvlialfPlane(point, TPE vec3(sides[i],sides[i + 1],0), 
TPE vec3(sides[i2 + 1] - sides[i + 1], sides[i] - sides[12],0)); 


a (p.x != point.x || p.y != point.y) 
point = p; 
if (.// dot product to determine which side the point is on 
sides[i2] - sides[i]) * (point.x - sides[i]) + 
sides[i2 + 1] - sides[i + 1]) * (point.y - sides[i + 1]) « 0) 
point.x = sides[i]; point.y = sides[i + 1]; 
else if // same but for. the other vertex 
sides[i] - Sides[12]): 3 Apot, x - sides[i2]) + 
sides[i + 1] - sides + 1]) * (point.y - sides[i2 + 1]) < 0) 


point.x = sides[i2]; point.y = sides[i2 + 1]; 


break; 
H 
H 


if (direction -- 1) 
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TPE Unit tmp = pone 
point. z = point.y; 


point.y tmp; 

else if (direction == 2) 
TPE Unit tmp = point.z; 
point. Z = point.x; 
point.x = tmp; 


return TPE_vec3PLus(point, center); 


TPE_Vec3 TPE_envGround(TPE_Vec3 point, TPE_Unit height) 


if (point.y > evant 
point.y = heigh 


return point; 


uint32_t _TPE_hash(uint32_t n) 


// parameters found by hash- prospector project 
n = 250009959 * (n ^ (n >> 17 

n = 2626308659 * (n ^ (n >> 1 T 

return n ^ (n »» 16); 


uint32 t TPE jointHash(const TPE Joint *joint) 

uint32 t 

TPE_hash(joint->position.x); 

TPE hash(r ^ joint->position.y 

TPE hash(r ^ joint-»position.z 

TPE hash(r ^ 
uint32 t) joint-»velocity[0 d 
uint32 t) joint-»velocity[1 << 16))); 
TPE hash(r ^ 

uint32 t) joint->velocity[2 | 

uint32_t) joint-»sizeDivided))); 


33553 


own nou n 


= 


— cc Lg! 


return r; 


uint32 t TPE connectionHash(const TPE Connection 


return TPE hash( i 
uint32 t) connection->length) 
uint32 t) connection-»jointi) << 16) | 
uint32 t «« 24)); 


*connection) 


connection-»joint2 


uint32 t TPE bodyHash(const TPE Body *body) 


uint32 t r = _TPE_hash( 
uint32 t) body-»jointMass) | 
uint32 t body- >flags) << 16) " 
uint32 t) body->deactivateCount) << 24)) ^ 
.TPE hash 
uint32 t) body->friction) | 
(uint32 t) body->elasticity) << 16)); 
for (uint8 t i = 0; i « body-»jointCount; tu . 
r = TPE hash(r ^ TPE _jointHash(&body->joints[i])); 
for (uints_ t i = 0; i < body->connectionCount; ++i) 
r = TPE Thash(r ^ TPE . connectionHash(&body- Sconnéctions[i])); 


return r; 


uint32 t TPE worldHash(const TPE World *world) 
uint32_t r = 0; 


for (uint8_t i = 0; i < world->bodyCount; ++i) 
r = TPE hash(r ^ TPE_bodyHash(&world->bodies[i])); 


return r; 


void TPE_bodyMoveTo(TPE_Body *body, TPE_Vec3 position) 
position = TPE_vec3Minus(position, TPE_bodyGetCenterOfMass(body) ); 


for r quinte t i= 0; 


i < body- TppintCount ++i 
y->joints[i].position = T 


E eap Tii od): >joints[i].position, position); 


"1 A e (THE closest roan genes tab, 
TPE UnitReduced allowedError, TPE Vec3' *errorPoint) 
TPE Vec3 p; 
cornerTo - TPE vec3Minus(cornerTo, cornerFrom); 
for (uinti16 t z = 0; z < gridResolution; ++z) 
p.z = cornerFrom.z + (z * cornerTo.z) / gridResolution; 
for (uinti6 t y = 0; y < gridResolution; ++y) 
p.y = cornerFrom.y + (y * cornerTo.y) / gridResolution; 
for (uinti16 t x = 0; x < gridResolution; ++x) 
p.x = cornerFrom.x + (x * cornerTo.x) / gridResolution; 
TPE Vec3 p2 - f(p,TPE INFINITY); 
nd (p.x != p2.x || p.y != p2.y || p.z != p2.z) // only test outside 


ane // 1st try to approach the closest point and see if it stays the 
same: 


TPE Vec3 p3 - p; 


for (uint8_t i = 0; i < 3; ++i) 


3= 
P TPE vec3((p3.x + p2.x) / 2,(p3.y + p2.y) / 2,(p3.z + p2.z) / 2); 
TPE Vec3 p4 = f(p3,TPE INFINITY); 


if (TPE abs(p4.x - p2.x) + TPE abs(p4.y - p2.y) 
* TPE abs(p4.z - p2.z) » allowedError) // taxicab dist. for speed 


if (errorPoint != 0) 


*errorPoint = p; 
return 0; 
H 
J 
// now test 8 points inside the sphere of radius: 
TPE_Unit d = TPE_DISTANCE(p, p2); 
p3.z=pz-d/2; 


for (uint8 t zz = 0; zz < 2; ++zz) 
p3.y = py -d/ 2; 
for (uint8 t yy = 0; yy < 2; ++yy) 


p3.x =p.x -d/ 2; 
for (uint8_t zz = 0; zz < 2; 
if (TPE DISTANCE(p,f(p3, TPE INFINITY)) + allowedError < d) 


T*ZZ) 


/* In the sphere of distance radius to the original point's 
closest point we've gotten a closer point which should 
never happen. */ 


if (errorPoint != 0) 
*errorPoint - p; 
return 0; 
p3.x += d; 
p3.y += d; 
p3.z += d; 
H 
} } 
H 
return 1; 


TPE Vec3 TPE envLineSegment(TPE Vec3 point, TPE Vec3 a, TPE Vec3 b) 
í point = TPE_vec3Minus(point,a); 

b = TPE_vec3Minus(b,a); 

point = TPE_vec3Project(point,b); 

if (TPE_ vec3Dot (point, b) < 0) 


point = TPE_vec3(0, O, 0 
else if (TPE. abs(point. x) + TPE _abs(point.y) + TPE abs(point.z) > 
TPE. abs(b. x) + TPE abs(b.y) + TPE abs(b.z)) 


point - b; 
point - TPE vec3Plus(point,a); 


return point; 


} 


TPE_Vec3 TPE_envHeightmap(TPE_Vec3 point, TPE_Vec3 center, TPE_Unit gridSize, 
( TPE Unit (*heightFunction)(int32 t x, int32 t y), TPE Unit maxbist] 


point - TPE vec3Minus(point,center); 


TPE Vec3 closestP 
TPE Unit closestD 


TPE vec3(TPE INFINITY, TPE INFINITY,TPE INFINITY); 
TPE INFINITY; 


inti6 t startSquareX = 


point.x / gridSize - (point: x< 8}: 


startSquareY point.z / gridSize - (point.z « O 
inti6 t squareX = startSquarex, 
squareY - startSquareY; 


uint8 t spiralDir - 1; 
uinti6 t spiralStep = 1, spiralStepsLeft = 1; 


TPE_Vec3 // 4 corners of the current square . 
bl = TPE vec3(squareX * gridSize,heightFunction(squareX, squareY), 


squareY * gridSize), 
br = TPE_vec3(bl.x + gridsize, heightFunction(squareX + 1,squareY),bl.z 
tl = TPE vec3(bl.x, heightFunction squareX,squareY + 1) bi.z + gridsize), 
tr = TPE vec3(br.x,heightFunction(squareX + 1, S Nata" + 1),tl.z 


for (uinti6 t i = 0; i < 1024; 


if ((TPE min(TPE abs(squareX - startSquareX), 
TPE abs(squareY - startSquareY)) - 1) * gridSize 
> TPE min(maxDist,closestD)) 
break; // here we can no longer find the dist we're looking for -» end 


for (uint8 t j = 0; 


TPE Vec3 testP - TPE .,envHa lf Plane(point, j-z-0?bLl:tr, 
TPE | vec3Normalized j = 0? 
TPE_vec3Cross(TPE_vec3Minus tl, bl), TPE_vec3Minus(br, bl E 
TPE vec3Cross(TPE vec3Minus br,tr | TPE_vec3Minus tl,tr)))); 


j < 2; ++j) // check the two triangles of the segment 


TPE_Unit testD = TPE_DISTANCE(testP, point); 


if (testD < closestD) 


if (j == 0 ? // point is inside the triangle? 
(testP.x >= bl.x && testP.z >= bl.z && 
(testP.x - bl.x <= tl.z - testP. 2) 
(testP.x <= tr.x && testP.z <= tr.z && 
(testP.x - bl.x »- tl.z - testP.z))) 


closestP = testP; 
closestD = testD; 
else 


// point outside the triangle, check individual boundary sides 
#define testEdge(a,b 
testP = TPE_envLineSegment(point,a,b); testD = TPE_DISTANCE(testP,point); \ 
if (testD < closestD) { closestP = testP; closestD = testD; 


testEdge(j == 0 ? bl : tr,br 
testEdge j == 0? bl: tr,tl 
testedge r,tl) 


120 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Tinyphysicsengine 


++i) // while (1) should work in theory but... 


#undef testEdge TPE Vec3 TPE envCone(TPE Vec3 point, TPE Vec3 center, TPE Vec3 direction 
} TPE_Unit radius) 


} { 
} point = TPE_vec3Minus(point, center); 
// now step to another square, in spiralling way: a (TPE vec3Dot(point,direction) <= 0) 
switch (spiralDir) // underneath the cone 
case 0: // moving up direction.x *= -1; 
squareY++; direction.y *- -1; 
direction.z *- -1; 
bl = tl; br = tr; i : . i : 
idsi BH = TPE vec3(bl.x,heightFunction(squareX,squareY + 1),bl.z + point = TPE envHalfPlane(point,TPE vec3(0,0,0),direction); 
gridSize); 
tr = TPE vec3(br.x,heightFunction(squareX + 1,squareY + 1),bl.z TPE_Unit dist = TPE_LENGTH(point); 
+ gridSize); 
break; if (dist > radius) 
point.x = (point.x * radius) / dist; 
case 1: // moving right point.y = (point.y * radius) / dist; 
squareX++; point.z = (point.z * radius) / dist; 
bl = br; tl = tr; ees , 
tt 2 TPE_vec3(tl.x + gridSize,heightFunction(squareX + 1,squareY + 1), ce 
tl.z); d : A : 
t= FRE vecs(bl.x + gridSize,heightFunction(squareX + TPE Unit height = TPE_LENGTH(direction) ; 


1 y bl.z) 

square v2)? 

4 : i TPE_Vec3 helper = TPE_vec3Project(point,direction); 
break; TPE_Unit y = TPE_LENGTH(helper); 


case 2: // moving down helper = TPE_vec3Minus(point, helper); 
squareY--; 
TPE_Unit x = TPE_LENGTH(helper); 


tl = bl; tr = br; 
bl = TPE_vec3 tl.x,heightFunction squareX,squareY),tl.z - gridSize); if (x « 20) 
>.. br = TPE_vec3(tr.x,heightFunction(squareX + 1,squareY),tr.z - J . : 
gridSize); // for such small distance big numeric errors occur in the other branch 
if (y >= height) 
break; point = direction; 
case 3: // moving left oe 
SquareX--; TPE Unit scaledRadius - radius - ((y * radius) / height) 
br = bl; tr = tl; y A : 
i^t yj = TPE_vec3(tr.x - gridSize,heightFunction(squareX,squareY + Y (y > height || x > scaledRadius) // outside? 
,tr.Z); : P 
bl = TPE vec3(br.x - gridSize, heightFunction(squarex, squareY), br .z); if (x <= 0) 
TPE LOG("WARNING: arithmetic error in envCone (library bug)" i 
break; x = 1; // shouldn't happen but just in case, to prevent div by zero 
default: break; 
helper.x = (helper.x * radius) / x; 
helper.y = (helper.y * radius) / x; 
spiralStepsLeft--; helper.z - (helper.z * radius) / x; 
if (spiralStepsLeft == 0) } point = TPE_envLineSegment (point, helper, direction); 
spiralDir = spiralDir != 0 ? spiralDir - 1: 3; } } 
if (spiralDir == 3 || spiralDir == 1) 
spiralStep++; return TPE_vec3PLus(point, center); 
spiralStepsLeft = spiralStep; 


static inline uint8_t TPE_bodyIsActive(const TPE_Body *body) 


} 
return !(body->flags & TPE BODY FLAG DEACTIVATED); 


return TPE vec3Plus(closestP,center); 
#endif // guard 


old/tinyphysicsengine.h 


#ifndef TINYPHYSICSENGINE_H #define TPE_SHAPE_POINT io} ///< single point in space 
#define TINYPHYSICSENGINE_H #define TPE SHAPE SPHERE 3. ///< sphere, params.: radius 
#define TPE SHAPE CAPSULE 2 ///« capsule: radius, height 
/** #define TPE SHAPE CUBOID 3 ///< cuboid, params.: width, height, depth 
author: Miloslav Ciz define TPE SHAPE PLANE 4 ///« plane, params.: width, dept 
license: CCO 1.0 (public domain) #define TPE SHAPE CYLINDER 5 ///< cylinder, params.: radius, height 
found at https: //creativecommons.org/publicdomain/zero/1.0/ #define TPE SHAPE TRIMESH 6 /**« triangle mesh, params.: 
* additional waiver of all IP vertex count, 
version: 0.1d triangle count 


vertices (int32 t pointer 


vert i i ' 
This is a suckless library for simple 3D (and 2D) physics simulation. The indices (uinti6 t pointer} u 


physics is based on the Newtonian model but is further simplified, 
articularly in the area of rotation: there is no moment of inertia for #define TPE MAX SHAPE PARAMS 3 
pbjects, Te every object rotates as if it was a ball, and the object can be #define TPE_MAX_SHAPE_PARAMPOINTERS 2 
rotating around at most one axis at a time, i.e. it is not possible to > : 
. simulate e.g. the Dzhanibekov effect. Therefore the library is mostly #define TPE BODY FLAG DISABLED 0x00 ///« won't take part in simul. at all 
intended #define TPE BODY FLAG NONCOLLIDING 0x01 ///« simulated but won't collide 
for entertainment software. 
// anti-vibration constants: 
CONVENTIONS: #define TPE ANTI VIBRATION MAX FRAMES 100 
#define TPE ANTI VIBRATION INCREMENT 20 
- Compatibility and simple usage with small3dlib is intended, so most #define TPE ANTI VIBRATION VELOCITY BREAK 60 
convention and data types copy those of small3dlib (which takes a lot of 
yr TPE Unit TPE wrap(TPE Unit value, TPE Unit mod 


conventions of OpenGL i t . di 
TPE_Unit TPE_clamp(TPE_Unit v, TPE_Unit v1, TPE_Unit v2); 


- No floating point is used, we instead use integers (effectively a fixed static inline TPE Unit TPE abs(TPE Unit x); 
f point). TPE_PRACTIONS PER’ UNIT is an equivalent to 1.0 in floating point static inline TPE Unit TPE nonZero(TPE Unit x); 
an 
all numbers are normalized by this constant. /** Returns an integer square root of given value. */ 
TPE Unit TPE sqrt(TPE Unit value); 
- Units: for any measure only an abstract mathematical unit is used. This 
unit : /** Multiplies two values (with normalization) so that the result is 0 only if 
always has TPE FRACTIONS PER UNIT parts. You can assign any correcpondence one or both values are zero. 
with real life units to these units. E.g. 1 spatial unit (which you can see TPE Unit TPE timesAntiZero(TPE Unit a, TPE Unit b); 
as e.g. 1 meter) is equal to TPE_FRACTIONS PER UNIT. Same with temporatl 
(e.g. 1 second) and mass (e.g. 1 kilogram) units, and also any derived /** Returns a sine of given arguments, both in TPE Units (see the library 
units, e.g. a unit of velocity (e.g. ms) is a so equal to 1 conventions). */ 
TPE FRACTIONS PER UNIT. A full angle is also split into TPE Unit TPE Sin(TPE Unit 
TPE-FRACTIONS-PER-UNIT parts (instead of 2 * PI or degrees). i -Sin(TPE Unit x) 
i . " TPE Unit TPE cos(TPE Unit x); 
- Quaternions are represented as vec4 where x ~ i, y~ j, z~ k, w - real. TPE Unit TPE asin(TPE Unit x); 
TPE Unit TPE aeea TPE -Unit x); 
nie There is no vec3 type, vec4 is usead for all vectors, for simplicity. int8_t TPE sign(TPE Unit x); 


. i typedef struct 
#include <stdint.h> 


TUE 
typedef int32 t TPE Unit; Unit y; 
yp int32 Unit; TPE Unit z; 
/** How many fractions a unit is split into. This is NOT SUPPOSED TO BE } TEE Uni i 
REDEFINED, so rather don't do it (otherwise things may overflow etc.). */ = , 


define TPE FRACTIONS-PER UNIT 512 #define TPE PRINTF VECA(v) printf("[%d %d Xd %d] ",(v).x, (V) .y, (V) z, (V) .w); 


Tderine TPE-INEINITY 2147483647 /** Initializes vec4 to a zero vector. */ 


: Sou : void TPE initVec4(TPE Vec4 *v); 
define TPE PI 1608 ///« pi in TPE Units void TPE vec4Set(1PE Vec4 *v, TPE Unit x, TPE Unit y, TPE Unit z, TPE Unit w); 
void TPE vec3Add(TPE Vec4 a, TPE Vec4 b, TPE Vec4 *result); 
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void TPE vec4Add(TPE Vec4 a, TPE Vec4 b, TPE_Vec4 *result); 

void TPE vec3Substract(TPE Vec4 a, TPE Vec4 b, TPE Vec4 *result); 
void TPE vec3Average(TPE Vec4 a, TPE Vec4 b, TPE Vec4 Leu 

void TPE vec4Substract(TPE Vec4 a, TPE Vec4 b, TPE_Vec4 *result); 
void TPE vec3Multiply(TPE Vec4 v, TPE Unit f, TPE_Vec4 *result); 

void TPE vec3MultiplyPlain(TPE Vec4 v, TPE Unit f, TPE Vec4 *result); 
void TPE vec4Multiply(TPE Vec4 v, TPE Unit f, TPE Vec4 *result); 

void TPE vec3CrossProduct(TPE Vec4 a, TPE Vec4 b, TPE Vec4 *result); 
void TP Vecdorma Lie (TP _Vec4 p 


void TPE vec4Normalize(TPE Vec4 *v 
É vec4 base, TPE Vec4 *result); 


void TPE vec3Project(TPE Vec4 v, T 


TPE Unit TPE vec3Len(TPE Vec4 v); 

TPE Unit TPE vec3LenTaxicab(TPE Vec4 v); 

TPE Unit TPE vec3Dist(TPE Vec4 a, TPE Vec4 b); 

TPE Unit TPE vec4Len(TPE Vec4 v); 

TPE Unit TPE vec3DotProduct(TPE Vec4 vi, TPE Vec4 v2); 

TPE Unit TPE vec3DotProductPlain(TPE Vec4 vi, TPE Vec4 v2); 


TPE_Vec4 TPE vec4(TPE Unit x, TPE Unit y, TPE Unit z, TPE Unit w); 
TPE_Vec4 TPE vec3Plus(TPE Vec4 a, TPE Vec4 b); 

TPE Vec4 TPE vec3Minus(TPE Vec4 a, TPE Vec4 H 
TPE_Vec4 TPE_vec3Times(TPE_Vec4 a, TPE_Unit f); 

TPE_Vec4 Tee-vecgTimesAntizero( TPE _vec4 a, TPE_Unit f); 

TPE_Vec4 TPE_vec3Cross(TPE_Vec4 a, TPE_Vec4 b); 

static inline TPE_Vec4 TPE_vec3Normalized(TPE_Vec4 v); 

static inline TPE_Vec4 TPE_vec3Projected(TPE_Vec4 v, fPE Vec4 base); 


a Returns the closest point on given line segment (a,b) to given point (p). 
TPE_Vec4 TPE lineSegmentClosestPoint(TPE Vec4 a, TPE Vec4 b, TPE Vec4 p); 


/** Converts a linear velocity of an orbiting point to the angular velocity 
(angle units per time units). This depends on the distance of the point from 
the center of rotation. */ . ; . 

TPE Unit TPE linearVelocityToAngular(TPE Unit velocity, TPE Unit distance); 


/** performs the opposite conversion of TPE linearVelocityToAngular. */ 
TPE Unit TPE angularVelocityToLinear(TPE Unit velocity, TPE Unit distance); 


fax Holds a rotation state around a single axis, in a way that prevents 
rounding 
errors from distorting the rotation over time. In theory rotation of a body 
could be represented as 


[current orientation, axis of rotation, angular velocity] 


However applying the rotation and normalizing the orientation quaternion each 
simulation step leads to error cumulation and the rotation gets aligned with 
one principal axis after some time. Because of this we rather represent the 

rotation state as 


[original orientation, axis of rotation, angular velocity, current angle] 


From this we can at each simulation step compute the current orientation by 
app lying rotation by current angle to the original rotation without error 
cumulation. */ 

typedef struct 
TPE_Vec4 originalOrientation; /**< quaternion holding the original 
orientation of the body at the time when it 
has taken on this rotational state */ 

/**< axis of rotation (x,y,z) and a 
non-negative angular velocity around this 
axis (w), determined ny the right hand 
rule */ 

/**« angle the body has already rotated along 
the rotation axis (from the original 
orientation) */ 


TPE_Vec4 axisVelocity; 


TPE Unit currentAngle; 


} TPE Rotationstate; 


/** Represents a physical rigid body that has certain attributes such as a 
specific shape or mass. */ 
typedef struct 


uint8 t shape; 


TPE Unit shapeParams TPE MAX SHAPE PARAMS] ; ///€ parameters of the body type 
void. shapeRarampoin ers[TPE MAX SHAPE PARAMPOINTERS]; ///« pointer 
parameters 


uint8 t flags; 

TPE Unit mass; /**« body mass, Setting this to TPE INFINITY will 
make the object static (not moving at all) 
which may help performance */ 


TPE Vec4 position; ///« position of the body's center of mass 


TPE Vec4 velocity; ///« linear velocity vector 

TPE RotationState rotation; /**« holds the state related to rotation, i.e. 
the rotation axis, angular momentum and data 
from which current orientation can be 
inferred */ 

TPE Unit boundingSphereRadius; 


uint8 t antiVibration; 
} TPE Body; 


/** Initializes a physical body, this should be called on all TPE Body objects 
that are created.*/ 
void TPE bodyInit(TPE Body *body); 


/** Recomputes the body bounding sphere, must be called every time the body's 
shape parameters change. */ 
void TPE bodyRecomputeBounds(TPE Body *body); 


/** Computes a 4x4 transform matrix of given body. The matrix has the same 
format as S3L Mat4 from small3dlib. * 
void TPE bodyGetTransformMatrix(const TPE Body *body, TPE Unit matrix[4][4]); 


/** Gets the current orientation of a body as a quaternion. */ 
TPE_Vec4 TPE bodyGetOrientation(const TPE Body *body); 


/** Multiplies the body's kinetic energy, i.e. changes its linear and angular 
ve EiT x . . . 
void TPE bodyMultiplyKineticEnergy(TPE Body *body, TPE Unit f); 


void TPE bodySetOrientation(TPE Body *body, TPE Vec4 orientation); 


/** Updates the body position and rotation according to its current velocity 
and rotation state. */ 
void TPE bodyStep(TPE Body *body); 


/** Sets the rotation state of a body as an axis of rotation and angular 
velocity around this axis. */ 
void TPE bodySetRotation(TPE Body *body, TPE Vec4 axis, TPE Unit velocity); 


/** Adds a rotation to the current rotation of a body. This addition is 
perfomed 


as a vector addition of the current and new rotation represented as vectors 


whose direction is the rotation axis and magnitude is the angular velocity 
around that axis. */ ] j 
void TPE bodyAddRotation(TPE Body *body, TPE Vec4 axis, TPE Unit velocity); 


fom Applies impulse (force in short time) to a body at a specified point 
(relative to its center), which will potentially change its linear and/or 
angular velocity. */ 

void TPE_bodyApplyImpulse(TPE_Body *body, TPE_Vec4 point, TPE_Vec4 impulse); 


void, TPE_attractBodies(TPE_Body *body1, TPE Body *body2, TPE Unit 
acceleration); 


frie computes and returns a body's bounding sphere radius, i.e. the maximum 
extent from its center point. * 
TPE Unit TPE bodyGetMaxExtent(const TPE_Body *body); 


/** Computes and returns a body's total kinetic energy (sum of linear and 
rotational kin. energy) « In rotating bodies this may not be physically 
accurate as, for simplicity, we operate with the moment of inertia of sphere 
for all bodies (when in reality moment of inertia depends on shape). */ 

TPE_Unit TPE_bodyGetKineticEnergy(const TPE_Body *body); 


/** Attempts to correct rounding errors in the total energy of a system of two 
bodies after collision, given the initial energy and desired restitution 
(fraction of energy that should remain after the collision). */ 

void TPE correctEnergies(TPE Body *body1, TPE Body *body2, 

TPE Unit previousEnergy, TPE Unit restitution); 


/** Collision detection: checks if two bodies are colliding. The return value 
1s 


the collision depth along the collision normal (0 if the bodies are not 
colliding). World-space collision point is returned via a pointer. Collision 
normal (normalized) is also returned via a pointer and its direction is 
"away from bodyi", i.e. if you move body1 in the opposite direction of this 
normal by the collision dep h (return value), the bodies should no longer 
exhibit this particular collision. This function checks the bounding spheres 
to quickly opt out of impossible collisions. */ 

TPE Unit TPE_bodyCollides(const TPE Body *bodyi, const TPE Body *body2, 
TPE_Vec4 *collisionPoint, TPE Vec4 *collisionNormal); 


/** Gets a velocity of a single point on a rigid body, taking into account its 
linear velocity and rotation. The point coordinates are relative to the body 
center. The point does NOT have to be on the surface, it can be inside and 
even outside the body too. */ 

TPE_Vec4 TPE bodyGetPointVelocity(const TPE Body *body, TPE Vec4 point); 


void TPE resolveCollision(TPE Body EE ,TPE Body *body2, 
TPE Vec4 collisionPoint, TPE Vec4 collisionNormal, TPE Unit collisionDepth, 
TPE Unit energyMultiplier); 


ed Gets a uinti6 t integer type of collision depending on two shapes, the 
order 
of shapes doesn't matter. */ 
#define TPE COLLISION TYPE(shapei,shape2) V 
shaped) = (shape2) ? \ 
uinti6 t shapei «« 8 shape2) : \ 
uinti6 t shape2 «« 8 shape1)) 


/** Represents a world consisting of physics bodies. */ 
typedef struct 


TPE Body *bodies; 
uinti6 t bodyCount; 
} TPE World; 


///« array of bodies 
///« length of the body array 


void TPE worldInit(TPE World *world); 
void TPE worldStepBodies(TPE World world); 

void TPE worldApplyGravityDown(TPE World *world, TPE Unit g); 

youd TPE worldApplyGravityCenter(TPE World *wor d, TPE_Vec4 center, TPE Unit 
9); 

void TPE worldResolveCollisionNaive(TPE World *world); 


/** Multiplies two quaternions which can be seen as chaining two rotations 
represented. by them. This is not commutative (a*b != b*a)! Rotations a is 
performed firth, then rotation b is performed. */ 

void TPE_quaternionMultiply(TPE_Vec4 a, TPE_Vec4 b, TPE_Vec4 *result); 

/** Initializes guaternion to the rotation identity (i.e. NOT zero 
quaternion). * 

void TPE_quaternionInit(TPE_Vec4 *quaternion); 


/** Converts a rotation given as an axis and angle around this axis (by right 
hand rule) to a rotation quaternion. */ 

void TPE rotationToQuaternion(TPE Vec4 axis, TPE Unit angle, 
TPE Vec4 *quaternion); 


void TPE quaternionToRotation(TPE Vec4 quaternion, TPE Vec4 *axis, 
TPE Unit *angle); 


/** Computes the conjugate of a quaternion (analogous to matrix inversion, the 
Guaternion will represent the opposite rotation). */ 
PE_Vec4 TPE_quaternionConjugate(TPE_Vec4 quaternion) ; 


/** Converts a rotation quaternion to a 4x4 rotation matrix. The matrix is 
indexed as [column][row] and is in the same format as S3L_Mat4 from 
small3dlib. */ 

yas TPE_quaternionToRotationMatrix(TPE_Vec4 quaternion, TPE_Unit matrix[4] 

; 


void TPE rotatePoint(TPE Vec4 *point, TPE Vec4 quaternion); 


TPE Vec4 TPE createVecFromTo(TPE Vec4 pointFrom, TPE Vec4 pointTo, 
TPE Unit size); 


void TPE getVelocitiesAfterCollision( 
TPE Unit *vi, 


TPE Unit m2, 
TPE Unit elasticity 


r 


V->X 
v->y 
V->Z 
V->W 


H 
TPE veca TPE_vec4(TPE_Unit x, TPE_Unit y, TPE_Unit z, TPE_Unit w) 
TPE_Vec4 r; 


Won n aD 
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r.w = Ww; 
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void TPE_vec4Set(TPE_Vec4 *v, TPE Unit x, TPE Unit y, TPE Unit z, TPE Unit w) 


v->X = X; 
Meay zy 
v->Z = Z; 
v-«w-w; 
H 
TPE Unit TPE wrap(TPE Unit value, TPE Unit mod) 
return value >= 0 ? (value % mod) (mod + (value % mod) - 1); 
TPE Unit TPE clamp(TPE Unit v, TPE Unit vi, TPE Unit v2) 
return v >= vi? (v <= v2 ? v : v2) : v1; 
TPE Unit TPE nonZero(TPE Unit x) 
return x + (x == 0); 


return r; 


define TPE SIN TABLE LENGTH 128 


static const TPE Unit TPE sinTable[TPE SIN TABLE LENGTH] - 


3; 


/* 511 was chosen here as a highest number that doesn't overflow during 
compilation for TPE_FRACTIONS_PER_UNIT == 


25*TPE FRACTIONS PER UNIT 
37*TPE FRACTIONS PER UNIT 
50*TPE FRACTIONS PER UNIT 
62*TPE FRACTIONS PER UNIT 
74*TPE FRACTIONS PER UNIT 
87*TPE FRACTIONS PER UNIT 

99*TPE FRACTIONS PER UNIT 

111*TPE FRACTIONS PER UNI 

124*TPE FRACTIONS PER UNIT 
136*TPE FRACTIONS PER UNIT 
148*TPE FRACTIONS PER UNIT 
160*TPE FRACTIONS PER UNIT 
172*TPE FRACTIONS PER UNIT 


183*TPE FRACTIONS PER UNIT 
195*TPE FRACTIONS PER UNIT 
207*TPE FRACTIONS PER UNIT 
218*TPE FRACTIONS PER UNIT 


229*TPE FRACTIONS PER UNIT 
240*TPE FRACTIONS PER UNIT 
251*TPE FRACTIONS PER UNIT 
262*TPE FRACTIONS PER UNIT 


273*TPE FRACTIONS PER UNIT 
283*TPE FRACTIONS PER UNIT 
294*TPE FRACTIONS PER UNIT 
304*TPE FRACTIONS PER UNIT 


314*TPE FRACTIONS PER UNIT 
324*TPE FRACTIONS PER UNIT 
333*TPE FRACTIONS PER UNIT 
343*TPE FRACTIONS PER UNIT 


352*TPE FRACTIONS PER UNIT 
361*TPE FRACTIONS PER UNIT 
370*TPE FRACTIONS PER UNIT 
378*TPE FRACTIONS PER UNIT 
386*TPE FRACTIONS PER UNIT 
395*TPE FRACTIONS PER UNIT 
402*TPE FRACTIONS PER UNIT 
410*TPE FRACTIONS PER UNIT 
417*TPE FRACTIONS PER UNIT 


424*TPE FRACTIONS PER UNIT 


431*TPE FRACTIONS PER UNIT 
438*TPE FRACTIONS PER UNIT 


444*TPE FRACTIONS PER UNIT 
450*TPE FRACTIONS PER UNIT 
456*TPE FRACTIONS PER UNIT 
461*TPE FRACTIONS PER UNIT 


467*TPE FRACTIONS PER UNIT 
472*TPE FRACTIONS PER UNIT 
476*TPE FRACTIONS PER UNIT 
481*TPE FRACTIONS PER UNIT 


485*TPE FRACTIONS PER UNIT 
488*TPE FRACTIONS PER UNIT 
492*TPE FRACTIONS PER UNIT 
495*TPE FRACTIONS PER UNIT 


498*TPE FRACTIONS PER UNIT 
501*TPE FRACTIONS PER UNIT 
503*TPE FRACTIONS PER UNIT 
505*TPE FRACTIONS PER UNIT 


507*TPE FRACTIONS PER UNIT 
508*TPE FRACTIONS PER UNIT 
509*TPE FRACTIONS PER UNIT 
510*TPE FRACTIONS PER UNIT 


510*TPE FRACTIONS PER UNIT 


1024 */ 


/511, (18*TPE FRACTIONS PER UNÍT)/511, 
/511, (31*TPE FRACTIONS PER UNIT)/511, 
/511, (43*TPE FRACTIONS PER UNIT)/511, 
/511, (56*TPE FRACTIONS PER UNIT)/511, 
/511, (68*TPE FRACTIONS PER UNIT)/511, 
/511, (81*TPE FRACTIONS PER UNIT)/511, 
/511, (93*TPE FRACTIONS PER UNIT)/511, 
/511, (105*TPE FRACTIONS PER UNIT)/511, 
/511 118*TPE FRACTIONS PER UNIT)/511, 
/511, (130*TPE FRACTIONS PER UNIT)/511, 
/511, (142*TPE FRACTIONS PER UNIT)/511, 
/511, (154*TPE FRACTIONS PER UNIT)/511, 
/511 166*TPE FRACTIONS PER UNIT)/511, 
/511, (178*TPE FRACTIONS PER UNIT)/511, 
/511, (189*TPE FRACTIONS PER UNIT)/511, 
/511, (201*TPE FRACTIONS PER UNIT)/511, 
/511 212*TPE FRACTIONS PER UNIT )/511, 
/511, (224*TPE FRACTIONS PER UNIT)/511, 
/511, (235*TPE FRACTIONS PER UNIT)/511, 
/511, (246*TPE FRACTIONS PER UNIT)/511, 
/511 257*TPE FRACTIONS PER UNIT)/511, 
/511, (268*TPE FRACTIONS PER UNIT)/511, 
/511, (278*TPE FRACTIONS PER UNIT)/511, 
/511, (289*TPE FRACTIONS PER UNIT)/511, 
/511 299*TPE FRACTIONS PER UNIT )/511, 
/511, (309*TPE FRACTIONS PER UNIT )/511, 
/511, (319*TPE FRACTIONS PER UNIT)/511, 
/511, (328*TPE FRACTIONS PER UNIT)/511, 
/511 338*TPE FRACTIONS PER UNIT)/511, 
/511, (347*TPE FRACTIONS PER UNIT)/511, 
/511, (356*TPE FRACTIONS PER UNIT)/511, 
/511, (365*TPE FRACTIONS PER UNIT)/511, 
/511 374*TPE FRACTIONS PER UNIT)/511, 
/511, (382*TPE FRACTIONS PER UNIT)/511, 
/511, (391*TPE FRACTIONS PER UNIT)/511, 
/511, (398*TPE FRACTIONS PER UNIT)/511, 
/511 406*TPE FRACTIONS PER UNIT)/511, 
/511, (414*TPE FRACTIONS PER UNIT)/511, 
/511, (421*TPE FRACTIONS PER UNIT)/511, 
/511, (428*TPE FRACTIONS PER UNIT)/511, 
/511 435*TPE FRACTIONS PER UNIT)/511, 
/511, (441*TPE FRACTIONS PER UNIT)/511, 
/511, (447*TPE FRACTIONS PER UNIT)/511, 
/511, (453*TPE FRACTIONS PER UNIT)/511, 
/511 459*TPE FRACTIONS PER UNIT)/511, 
/511, (464*TPE FRACTIONS PER UNIT)/511, 
/511, (469*TPE FRACTIONS PER UNIT)/511, 
/511, (474*TPE FRACTIONS PER UNIT)/511, 
/511 478*TPE FRACTIONS PER UNIT)/511, 
/511, (483*TPE FRACTIONS PER UNIT)/511, 
/511, (487*TPE FRACTIONS PER UNIT)/511, 
/511, (490*TPE FRACTIONS PER UNIT)/511, 
/511 494*TPE FRACTIONS PER UNIT)/511, 
/511, (497*TPE FRACTIONS PER UNIT)/511, 
/511, (499*TPE FRACTIONS PER UNIT)/511, 
/511, (502*TPE FRACTIONS PER UNIT)/511, 
/511 504*TPE FRACTIONS PER UNIT )/511, 
/511, (506*TPE FRACTIONS PER UNIT)/511, 
/511, (507*TPE FRACTIONS PER UNIT)/511, 
/511, (509*TPE FRACTIONS PER UNIT)/511, 
/511 510*TPE FRACTIONS PER UNIT)/511, 
/511, (510*TPE FRACTIONS PER UNIT)/511, 
/511, (510*TPE FRACTIONS PER UNIT)/511 


define TPE SIN TABLE UNIT STEPN 
(TPE FRACTIONS PER UNIT / (TPE SIN TABLE LENGTH * 4)) 


TPE Unit TPE sqrt(TPE Unit value) 


int8 t sign - 1; 
if (value < 0) 


sign - -1; 
value *- -1; 


uint32 t result - 0; 
uint32 t a - value; 
uint32 t b - 


while (b » a) 
b >>= 2; 

oe (b != 0) 
Hr (a >= result + b) 


a -= result * b; 


result = result + 2 * 


b >>= 2; 
result >>= 1; 


} 


return result * sign; 


TPE_Unit TPE_sin(TPE_Unit x) 
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b; 


xX = TPE wrap(x / THE_SIN_TABLE_UNIT_STEP, TPE_SIN_TABLE_LENGTH * 4); 
ive = F 


int8_t posi 


, 


if (x « TPE SIN TABLE LENGTH) 


else if (x « TPE SIN TABLE LENGTH * 2) 

X = TPE SIN TABLE LENGTH * 2 - x - 1; 
bise if (x « TPE SIN TABLE LENGTH * 3) 
í X = X. - TPE_SIN_TABLE_LENGTH * 2; 


positive - 0; 


else 


{ 


X = TPE SIN TABLE LENGTH - (x - TPE SIN TABLE LENGTH * 3) - 1; 


positive - 0; 


return positive ? TPE sinTable[x] 


} 


TPE_Unit TPE_cos(TPE_Unit x) 


return TPE_sin(x + TPE_FRACTIONS_PER_UNIT / 4); 


yoia TPE_bodyInit(TPE_Body *body) 


// TODO 


TPE initVec4(&(body-»position)); 
body-»velocity 


TPE initVec4(& 


, 


-1 * TPE sinTable[x]; 


// init orientation to identity unit quaternion (1,0,0,0): 


TBE-quaternionInit(&(body-srotationori inalOrientation 
io 


TPE_vec4Set (&(body->rota n.axisVe locity), TPE_FRACTION 


body->rotation.currentAngle = 0; 


body->mass = TPE_FRACTIONS_PER_UNIT; 


body->boundingSphereRadius = 0; 


body->antiVibration = 0; 


} 


void TPE_bodySetOrientation(TPE_Body *body, TPE_Vec4 orientation) 


body->rotation.originalOrientation = 


body->rotation.currentAngle = 0; 


orientation; 


WX TPE bodyGetOrientation(const TPE Body *body) 


TPE Vec4 axisRotation, 


result; 


TPE rotationToQuaternion( 
body-»rotation.axisVelocity, 
body-»rotation.currentAngle, 


&axisRotation); 


TPE quaternionMultiply( , 
body-»rotation.originalOrientation, 


axisRotation, 
&result); 


TPE_vec4Normalize(&result); 


return result; 


} 


void TPE_vec3CrossProduct(TPE_Vec4 a, TPE_Vec4 b, TPE_Vec4 *result) 


TPE_Vec4 r; 
r.x = (a.y * b.z - 
r.y = (a.z * b.x - 
r.z = (a.x * b.y - 
*result - r; 


Aps 
* biz 
* b.x 


i dcaidat TPE vec3Cross(TPE Vec4 a, TPE Vec4 b) 
TPE vec3CrossProduct(a, b, &a) ; 


return a; 


void TPE bodyApplyImpulse(TPE Body *body, TPE Vec4 point, 


TPE Unit pointDistance - TPE vec3Len(point); 


ir (pointDistance 
impulse.x 


impulse.z 


12 9) 


/ TPE FRACTIONS PER UNIT; 
/ TPE FRACTIONS PER UNIT; 
/ TPE FRACTIONS PER UNIT; 


/ body->mass; 
/ body->mass; 


i = (impulse.x * TPE FRACTIONS PER UNIT) / body->mass; 
impulse.y - (impulse.y * TPE FRACTIONS PER UNIT 
- (impulse.z * TPE FRACTIONS PER UNIT 


TPE vec3Add(body-»velocity,impulse,&(body-»velocity)); 


/* normalize the 
recompute the 


point, we don't use the function as we don't want 


vector length */ 


point.x - (point.x * TPE FRACTIONS PER UNIT 
point.y = (point.y * TPE FRACTIONS PER UNIT 
point.z - (point.z * TPE FRACTIONS PER UNIT 


| 


/ pointDistance; 
/ pointDistance; 
/ pointDistance; 


/* for simplicity we'll suppose angular momentum of a sphere: 


impulse = TPE_vec3Cross(impulse, point); 


TPE Unit r = TPE bodyGetMaxExtent (body) ; 


r - TPE nonZero((2 * r * r) / TPE FRACTIONS PER UNIT); 


TPE_Vec4 tmp = impulse; 


impulse.x = (i 
impulse.y = (impulse 
impulse.z = 


if (impulse.x 0 && 
impulse.y 0 && 
impulse.z == 0 && 
tmp.x != 0 
tmp.y != 0 || 


impulse.x * 5 * TPE FRACTIONS PER UNIT 
.y * 5 * TPE FRACTIONS PER UNIT 
impulse.z * 5 * TPE FRACTIONS PER UNIT 


£ r} 
Jv; 
/r, 


E 


); 
A) ER UNIT, 0, 0,0); 


TPE_Vec4 impulse) 


to 


tmp.z != 0 
)) 


{ 
impulse.x = TPE_sign(tmp.x); 
impulse.y = TPE_sign(tmp.y); 
} impulse.z = TPE_sign(tmp.z); 
/* 
impulse.x - (impulse.x * 5 * TPE FRACTIONS PER UNIT) / r; 
impulse.y - (impulse.y * 5 * TPE FRACTIONS PER UNIT) / r; 
iy impulse.z - (impulse.z * 5 * TPE FRACTIONS PER UNIT) / r; 
} TPE_bodyAddRotation(body, impulse, TPE_vec3Len(impulse) ) ; 
H 


void z[PESgetShapes const TPE Body *bi, const TPE Body *b2, uint8 t shape1, 
const TPE Body **first, const TPE Body **second) 


if (b1->shape == shape1) 


*first = b1; 
*second = b2; 


else 
*first = b2; 
*second = bi; 


} } 


void TPE getCapsuleCyllinderEndpoints(const TPE Body *body, 
TPE_Vec4 *a, TPE Vec4 *b) 


TPE Vec4 quat = TPE bodyGetOrientation(body); 


*a 
*b 


TPE vec4 9, body-»shapeParams[1] / 2,0,0); 
TPE vec4(60, -1 a->y,0,0); 


TPE rotatePoint(a,quat); 
TPE rotatePoint(b,quat); 
TPE vec3Add(*a, body->position,a); 
} TPE_vec3Add(*b, body->position,b); 
/** Helpter function for cuboid collision detection. Given a line segment 

as a line equation limited by parameter bounds ti and t2, center point C and 

side offset from the center point O, the function further limits the 
parameter 


bounds (t1, t2) to restrict the line only to the region between two planes: 


both with normal O, one passing throung point C + O and the other through 
C - 0. If t2 > t1 after this function finishes, the line segment is 
completely 
outside the region. */ 
void (PE Cutt inesegmentByP lanes ITE Vect center, TPE Vec4 sideOffset, 
TPE_Vec4 lineStart, TPE Vec4 lineDir, TPE Unit *t1, TPE Unit *t2) 
// we shift the center to [0,0,0] to simplify and prevent overflows 
lineStart = TPE vec3Minus(lineStart,center); 


//center = TPE_vec4(0,0,0,0) 


TPE Unit da = TPE vec3DotProductPlain(sideOffset, lineStart); 
TPE_Vec4 dc; 
dc.z = 0; 


// TODO: dot(d,dc) could be cached for all sides between calls to save 
recomputing 


dc = sideOffset; 
TPE Unit denom = TPE nonZero(TPE vec3DotProductPlain(sideOffset,lineDir)); 


#define tAntiOverflow(t) \ 
TPE_Unit t = TPE_vec3DotProductPlain(sideOffset,dc) - da;\ 
i= (TPE abs (t) < 500000) ? (t * TPE FRACTIONS PER UNIT) / denom :\ 


(((t / 64) * TPE FRACTIONS PER UNIT) / TPE nonZero(denom / 64)); 
tAntiOverflow(tA) 
TPE vec3MultiplyPlain(sideOffset,-1,&dc); 
tAntiOverflow(tB) 
#undef tAntiOverflow 
if (tB « tA) 


TPE Unit tmp - tA; 
tA 


} 


if (tA > *t1) 
*td = ta; 


i 
tmp; 


if (tB « *t2) 
*t2 - tB; 


} 


TPE Unit TPE_bodyCollides(const TPE Body *body1, const TPE Body *body2, 
TPE_Vec4 *collisionPoint, TPE Vec4 *collisionNormal) 


// handle collision of different shapes each in a specific case: 
uinti6 t collType = TPE COLLISION TYPE(bodyi-»shape, body2->shape) ; 
if (collType != TPE COLLISION TYPE(TPE SHAPE SPHERE, TPE SHAPE SPHERE)) 


/* initial bounding sphere check to quickly discard impossible collisions, 
plus this also prevents overflow errors in long-distance computations */ 


// TODO: taxicab could be also considered here 
if (TRE vecslen (TPE vecaMinus (bodyT-»position, bod 2->position)) > 
body1->boundingSphereRadius + body2->boundingSphereRadius 
return 0; 
switch (TPE_COLLISION_TYPE(body1->shape, body2->shape) ) 
case TPE_COLLISION_TYPE(TPE_SHAPE_SPHERE, TPE_SHAPE_SPHERE) : 
TPE_Vec4 distanceVec; 


TPE_vec3Substract (body2->position, body1->position, &distanceVec) ; 
TPE Unit distance = TPE vec3Len(distanceVec); 


distance -= bodyi-»shapeParams[0] + body2->shapeParams[0]; 

irf (distance < 0) 
TRE YecdAvgrage(body1-»position,body2-»position,collisionPoint) 
*collisionNormal = distanceVec; 
TPE vec3Normalize(collisionNormal); 


return -1 * distance; 


} 


break; 


3 
çase TPE_COLLISION_TYPE(TPE_SHAPE_SPHERE, TPE_SHAPE_CAPSULE) : 


const TPE_Body *sphere; 
const TPE_Body *capsule; 


_TPE_getShapes(body1, body2, TPE SHAPE SPHERE, &sphere, &capsule) ; 
TPE_Vec4 cA, cB; 
_TPE_getCapsuleCyllinderEndpoints(capsule, &cA, &cB) ; 

TPE_Body sphere2; // sphere at the capsule's closest point 
TPE bodyInit(&sphere2); 

sphere2.shape - TPE SHAPE SPHERE; 

spheres. shapeParams[9] Ti cabeu le -eshaperarams [0]: 
sphere2.position = TPE_line 

uint8_t swap = sphere == body2; 


return TPE_bodyCollides(swap ? &sphere2 : sphere,swap ? sphere : 
&sphere2, 
collisionPoint,collisionNormal); 


break; 


çase TPE COLLISION TYPE(TPE SHAPE CAPSULE, TPE SHAPE CAPSULE): 
TPE Vec4 ai, bi, a2, b2; 


.TPE getCapsuleCyllinderEndpoints(bodyi,&a1,&b1); 
.TPE getCapsuleCyllinderEndpoints(body2,&a2, &b2 


; 
TPE Unit aa, ab, ba, bb; // squared distances between points 
TPE_Vec4 tmp; 


tmp = TPE vec3Minus(a1,82); 
aa = tmp.x * tmp.x + tmp.y * tmp.y + tmp.z * tmp.z; 


tmp - TPE vec3Minus(a1,b2); 
ab = tmp.x * tmp.x + tmp.y * tmp.y + tmp.z * tmp.z; 


tmp = TPE vec3Minus(b1,a2); 
ba = tmp.x * tmp.x + tmp.y * tmp.y + tmp.z * tmp.z; 


tmp - TPE vec3Minus(b1,b2); 
bb = tmp.x * tmp.x + tmp.y * tmp.y + tmp.z * tmp.z; 


// let a1 hold the point figuring in the shortest distance: 


if (ab « aa) 
aa - ab; // means: aa - min(aa,ab) 


if (bb « ba) 
ba - bb; // means: ba - min(ba,bb) 


if (ba b aa) // means: min(ba,bb) « min(aa,ab) 
ai - bi; 


a2 
ai 


TPE lineSegmentClosestPoint(a2,b2,a1); 
TPE lineSegmentClosestPoint(a1,b1,a2); 


// now ai and a2 are the closest two points on capsule axes 


TPE Body spherei, sphere2; 


TPE bodyInit(&sphere1); 
spherei.shape = TPE SHAPE SPHERE; 

spherei.shapeParams[0] = bodyi-»shapeParams[0]; 
spherei.position = a1; 


TPE bodyInit(&sphere2); 

sphere2.shape - TPE SHAPE SPHERE; 
sphere2.shapeParams[0] = body2-»shapeParams [0]; 
sphere2.position - 82; 


return 
TPE bodyCollides(&sphere1, &sphere2, collisionPoint,collisionNormal); 
break; 


3 
ad TPE COLLISION TYPE(TPE SHAPE SPHERE, TPE SHAPE CYLINDER): 


// TODO: would this be better to do via sphere-capsule collision? 


const TPE Body *sphere; 
const TPE Body *cylinder; 


.TPE getShapes(body1, body2, TPE SHAPE SPHERE, &sphere, &cylinder); 


TPE_Vec4 sphereRelativePos = // by this we shift the cylinder to 
TPE_vec3Minus(sphere->position, cylinder ->position) ; 


// vector atong the cylinder height: 
TPE_Vec4 cylinderAxis = TPE vec4 (0, TPE. FRACTIONS PER UNIT,0,0); 


TPE rotatePoint(&cylinderAxis,TPE bodyGetOrientation(cylinder)); 


TPE Vec4 sphereAxisPos - // sphere pos projected to the cylinder 
TPE vec3Projected(sphereRelativePos,cylinderAxis); 


TPE Unit sphereAxisDistance - TPE vec3Len(sphereAxisPos); 
TPE Unit tmp = cylinder->shapeParams[1] / 2; // half of cylinder 
/* now we have three possible regions the sphere can occupy: 


C:B: A :B: C 
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' 


egmentClosestPoin (cA, cB, sphere-»position); 


[0,0,0] 


axis 


height 


cylinder 
*/ 


i if (sphereAxisDistance >= tmp + sphere->shapeParams[0]) // case C: no 
col. 


break; 


TPE_Vec4 sphereAxisToRelative = 
TPE vec3Minus(sphereRelativePos,sphereAxisPos); 


TPE Unit sphereCylinderDistance = TPE vec3Len(sphereAxisToRelative); 
tmp - sphereAxisDistance - tmp; 


if (tmp « 0) // case A: potential collision with cylinder body 


TPE Unit penetration - cylinder-»shapeParams[0] 
- (sphereCylinderDistance - sphere-»shapeParams[0]); 


if (penetration > 0) 


TPE_vec3Normalize(&sphereAxisToRelative); 


*collisionPoint = TPE vec3Plus(cylinder-»position, 
TPESVOGSP lus(s hereAxisPos, TPE_vec3Times( 
sphereAxisToRe lative, cylinder ->shapeParams[0]))); 


*collisionNormal = sphereAxisToRelative; 


if (sphere == body) A EM A 
TPE vec3MultiplyPlain(*collisionNormal, -1,collisionNormal) 


return penetration; 


else 
break; 


/* case B: here we have two subcases, one with the sphere center bein 
within the cylinder radius (collision with the cylinder top/bot tom) 
and the other case (collision with the cylinder top/bottom edge). 


1 


/ 


TPE Vec4 cylinderPlaneMiddle = TPE vec3Times( 
TPE vec3Normalized(sphereAxisPos), 
cylinder->shapeParams[1] / 2); 
if (sphereCylinderDistance < cylinder->shapeParams[0]) // top/bottom cap 


TPE Unit penetration - ey Under shapeParms| i /2- 
(sphereAxisDistance - sphere-»shapeParams[0]); 


if (penetration «- 0) // shouldn't normally happen, but rounding errors 
penetration - 1; 


*collisionNormal = TPE vec3Normalized(sphereAxisPos); 
*collisionPoint - 
TPE vec3Plus( 


cylinder-»position, 
TPE vec3Plus(sphereAxisToRelative,cylinderPlaneMiddle)); 


if (Body1 == sphere} R NS : 
TPE vec3MultiplyPlain(*collisionNormal, -1,collisionNormal) 


return penetration; 
else // potential edge collision 
TPE Vec4 edgePoint = TPE vec3Plus(cylinderPlaneMiddle, 


TPE vec3Times(TPE vec3Normalized(sphereAxisToRelative), 
cylinder-»shapeParams[0])); 


TPE Unit penetration - sphere-»shapeParams[0] - 
TPE vec3Dist(edgePoint,sphereRelativePos 


; 
if (penetration > 0) 
*collisionPoint = TPE vec3Plus(cylinder-»position,edgePoint); 


*collisionNormal = i j 
TPE vec3Normalized(TPE vec3Minus(sphereRelativePos,edgePoint)); 


if (bodyi -- sphere 
TPE vec3MultiplyPlain(*collisionNormal, -1,collisionNormal) 


return penetration; 
H 


break; 


case TPE COLLISION TYPE(TPE SHAPE CUBOID, TPE SHAPE CUBOID): 
TPE Vec4 // min/max extent of the colliding area: 
collisionExtentMax - 
TPE vec4(-TPE INFINITY, -TPE INFINITY, -TPE INFINITY,0), 


collisionExtentMin - 
TPE vecA(TPE INFINITY, TPE INFINITY, TPE INFINITY,0); 


uint8 t collisionHappened - 0; 


TPE_Vec4 aX1, aY1, aZi, // first cuboid axes 
aX2, aY2, aZ2; // second cuboid axes 


for (uint8_t i = 0; i < 2; ++i) // for each body 
TPE_Vec4 q = TPE_bodyGetOrientation(body1); 
// construct the cuboid axes: 


aX1 = TPE_vec4(body1->shapeParams[0] / 2,0,0,0); 
TPE_rotatePoint (&aX1,q); 


aY1 = TPE vec4(0,bodyi-»shapeParams[1] / 2,0,0); 
TPE rotatePoint(&aY1,q); 


aZi = TPE_vec4(0,0,body1->shapeParams[2] / 2,0); 
TPE rotatePoint(&azi,q]; 


q = TPE bodyGetOrientation(body2); 


aX2 = TPE vec4(body2-»shapeParams[0] / 2,0,0,0); 
TPE rotatePoint(&aX2,q); 


aY2 = TPE vec4(0, body2->shapeParams[1] / 2,0,0); 
TPE rotatePoint(&aY2,q); 


aZ2 = TPE_vec4(0,0,body2->shapeParams[2] / 2,0); 
TPE rotatePoint(&aZ2,d); 


uint8 t edges[12] - // list of all cuboid edges as combinations of axes 
// XyZ xyz 
Ox3b, // +++ -++ 
Ox3e, // +++ ++- top 
0x13, // -+- -++ 
0x16, // -+- ++- 
0x29, // +-+ --* 


Ox2c, // +-+ +-- bottom 
0x01, // --- --* 

0x04, // --- +-- 

Ox3d, // +++ +-+ 

Ox19, // -++ --+ sides 
0x10, // -+- --- 

0x34 // ++- +-- 


3; 
for (uint8_t j = 0; j < 12; ++j) // for each edge 
// we check the edge against all sides of the other cuboid 


TPE_Vec4 lineStart = body1->position; 
TPE_Vec4 lineEnd = body1->position; 


uint8_t edge = edges[j]; 


#define offsetCenter 


(co, v.a) N 
v = (edge & c) ? TPE vec3Plus(v,a) : TPE vec3Minus(v,a); 


offsetCenter(0x02, LineStart, aY1 


offsetCenter (0x04, LineStart, aX1 
offsetCenter (0x01, lineStart,aZ1 


offsetCenter (0x10, LineEnd, aY1 
offsetCenter (0x08, LineEnd, aZ1 


offsettenter exe, LineEnd, avi] 

#undef offsetCenter 
TPE Unit t1 = 0, t2 = TPE FRACTIONS PER UNIT; 
TPE_Vec4 edgeDir = TPE vec3Minus(lineEnd, lineStart); 


"us (uint8_t k = 0; k « 3; ++k) // for each axis (pair of sides) 
TPE_Vec4 *sideOffset; 


if (k == 0) 
sideOffset - &aX2; 
else if (k == 
sideOffset = &aY2; 
lse 
sideOffset = &aZ2; 


_TPE_cutLineSegmentByP Lanes (body2->position, *sideOffset, lineStart, 
edgeDir, &t1,&t2); 


if (ti > t2) ; . 
break; // no solution already, no point checking on 


if (t2 > t1) // if part of edge exists between all side planes 
// edge collided with the cuboid 


collisionHappened = 1; 


*collisionPoint = edgeDir; 
collisionPoint-»x - (Go llisionPoint-»x *q1) 7 
TPE FRACTIONS PER UNIT; 
collisionPoint->y = (collisionPoint->y * t1) / 
TPE FRACTIONS PER UNIT; 
collisionPoint->z = (collisionPoint->z * t1) / 
TPE FRACTIONS PER UNIT; 
*collisionPoint = TPE vec3Plus(lineStart, *collisionPoint); 


if (collisionPoint->x > co 


lli isionExtentMax.x) 
collisionExtentMax.x = co 


isionPoint-»x; 


if (collisionPoint->x « co 


lli - isionExtentMin.x) 
collisionExtentMin.x = co 


isionPoint-»x; 


if (collisionPoint->y > co 


lli isionExtentMax.y) 
collisionExtentMax.y - co 


isionPoint-»y; 


if (collisionPoint->y « co 


lli - isionExtentMin.y) 
collisionExtentMin.y = co 


isionPoint->y; 


if (collisionPoint->z > co 


lli isionExtentMax.z) 
collisionExtentMax.z - co 


isionPoint-»z; 


if (collisionPoint-»z « co 


lli - isionExtentMin.z) 
collisionExtentMin.z - co 


isionPoint-»z; 


*collisionPoint - edgeDir; . ; 
llisionPoint-»x - fcollisionPoint->x * q*2) 7 


co 
TPE FRACTIONS PER UNIT; 
collisionPoint-»y 
TPE FRACTIONS PER UNIT; 
collisionPoint->z = (collisionPoint-»z * t2) / 
TPE FRACTIONS PER UNIT; 
*collisionPoint = TPE vec3Plus(lineStart, *collisionPoint); 


(collisionPoint->y * t2) / 


if (collisionPoint->x > co 


lli isionExtentMax.x) 
collisionExtentMax.x = co 


isionPoint-»x; 


if (collisionPoint->x « co 


lli - isionExtentMin.x) 
collisionExtentMin.x - co 


isionPoint-»x; 


if (collisionPoint->y > co 


lli isionExtentMax.y) 
collisionExtentMax.y = co 


isionPoint->y; 


if (collisionPoint->y < co 


lli - isionExtentMin.y) 
collisionExtentMin.y = co 


isionPoint->y; 


if (collisionPoint->z > co 


lli isionExtentMax.z) 
collisionExtentMax.z - co 


isionPoint-»z; 


if (collisionPoint->z « co 


lli - isionExtentMin.z) 
collisionExtentMin.z - co 


isionPoint-»z; 
} ) for each edge 
if (i == 0) 

// now swap the bodies and do it again: 


const TPE Body *tmp = body1; 
bodyi - hody?! p Tut 
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body2 - tmp; 
int8 t r - restitution » TPE FRACTIONS PER UNIT ? 
} // for each body 1 : (restitution < TPE FRACTIONS PER UNIT ? -1 : 0) 


if (collisionHappened) TPE Unit newEnergy = TPE_bodyGetKineticEnergy(body1) + 


// average all collision points to get the center point TPE-bodyGetKineticEnergy(body2); 


TPE Unit f - (newEnergy * TPE FRACTIONS PER UNIT) / 


*collisionPoint = TPE vec3Plus(collisionExtentMin,collisionExtentMax); previousEnergy; 

collisionPoint-»x /- 2; restitution - (f !- 9) ? 

collisionPoint-»y /- 2; (restitution * TPE FRACTIONS PER UNIT) / f 
collisionPoint->z /- 2; TPE FRACTIONS PER UNIT; 

collisionPoint->w = 0; 


/* We'll find the "closest" side to collision point, compute the if (restitution > TPE FRACTIONS PER UNIT + 10 || // TODO: magic const. 
enetration depth for both bodies (can't do just one) and return the restitution;s IPE-FRACTIONS-PER-UNIT 719) 
igger one. */ f = (previousEnergy * restitution) / TPE FRACTIONS PER UNIT; 


TPE Unit result - -TPE INFINITY; 


if ((r « 0 && f « previousEnergy) MIT 


: : ; : r == 0 && f == previ E 
for (int i = 0; i < 2; ++i) // for each body r»08& f » previousEnergy]) 
TPE Vec4 bestAxis - TPE vec4(1,0,0,0); TPE_bodyMultiplyKineticEnergy(body1, restitution); 
TRE UMEE SUE a patai } TE-bodVMu LE Tb Kineticener gy bodea’ restitution)! 
collisionExtentMin = TPE vec3Minus(*collisionPoint, H t 
i == 0 ? body1->position : body2->position); // reuse 


#define checkAxis(a) \ ‘inte’ t. TPE_bodyUsdereantivibratson(iPE Body "bod 
currentDot = (TPE_vec3DotProduct(a,collisionExtentMin) * AD ERES STEEP OC rae aca ea EBOOy ody) 
TPE FRACTIONS PER UNIT) / * 
TPE nonZero(TPE vec3DotProduct(a,a)); \ 
if (currentDot > bestDot) \ 
{ bestDot = currentDot; bestAxis = a; } \ 


uint8 t tmp = body->antiVibration & Ox7f; 


if (body->antiVibration & 0x80) 


RISE ees *2 -1: N tmp - (tmp « 127 - TPE ANTI VIBRATION INCREMENT) ? 
if (currentDot »'béstbot) CN tmp + TPE ANTI VIBRATION INCREMENT : 127; 
bestDot = currentDot; bestAxis = a; \ m : NS 
TPE vecaMultiplyPlain(bestAxis,-1,&bestAxis); ) \ a = (body-»antiVibration & 0x80) 
; 
heckAxis(ax1 
checkAxis aYi return tmp «- TPE ANTI VIBRATION MAX FRAMES; 
checkAxis(aZi 
#undef checkAxis void TPE resolveCollision(TPE Body *body1 ,TPE Body *body2,. . 
UT RR TPE Vec4 collisionPoint, TPE Vec4 collisionNorma , TPE_Unit collisionDepth 
TPE Unit len = TPE nonZero(TPE vec3Len(bestAxis)); ( TPE Unit energyMultiplier) 


len - len - TPE vec3DotProductPlain(bestAxis, 
TPE_vecgMinus igollistonroint,, 5 iti 2A Topo: 
i == ? bodyl-»position : body2->position en; 
Yo eee » i - false coll. detection? 
- coll with static 
- handle small values!!! 
- handle big values 


/* 


if (len > result) 


result = len; */ 
*collisionNormal = bestAxis; 


TPE_vec3Normalize(collisionNormal 
T ( E if (body2->mass == TPE INFINITY) // handle static bodies 


if (i == 0) zt 
TPE vec3MultiplyPlain(*collisionNormal, -1,collisionNormal); ar Apodyix-nass =r TEE INFINITY] S do nothing 
; : 


// switch the bodies so that the static body is always the first one: 


m - axi // check the second body's axes in next iteration 

aYi - aY2; 

Z1 = n9; TPE_Body *tmp = body1; 
} E € body1 = body2; ' 


body2 = tmp; 


return result > 1 ? result : 1; 
5 TPE vec3MultiplyPlain(collisionNormal, -1,&collisionNormal); 


H 
break; 
RESI TPE_Vec4 pi, p2; 
default: pi = TPE vec3Minus(collisionPoint,bodyi1-»position 
break; p2 = TeE-vecaMinus collisionPodnt! body2->position}: 
F 
// separate the bodies: 
return 0; 
collisionPoint - collisionNormal; // reuse collisionPoint 
TPE Vec4 TPE bodyGetPointVelocity(const TPE Body *body, TPE Vec4 point) if (bodyi-»mass != TPE INFINITY) 
TPE Vec4 result = body->velocity; Tee-vecgmuttiply(collisionPoint collisionDepth / 2,&collisionPoint); 
TPE_vec3Add (body. ->position, collisionPoint, &body2-Sposition); 
TPE_Vec4 normal = TPE_vec3Cross( TPE_vec3Substract (body1->position, collisionPoint, &body1->position); 


point, TPE_vec3Minus(point, body->rotation.axisVelocity) ); ise 


TPE vec3MultiplyPlain(normal,-1,&normal); // TODO: think about WHY TPE vecgMultiply(collisionPoint ,collisionDepth, &collisionPoint) ; 
y ! 2 s , e ody2-»po on, co onPoin ody2-»po 
TPE Unit dist = TPE vec3Len(normal); // point-line distance E ( Yecoposttionpe Xr ML. y2-»position); 


TPE Unit velocity - R : ; i | { 
TPE_angularVe LocityToLinear (body->rotation.axisVelocity.w, dist); TPE_Vec4 veli, vel2; 
TPE vec3Normalize(&normal); veli = TPE bodyGetPointVelocity(bodyi, p1 
vel2 = TPE bodyGetPointVelocity(body2,p2); 


return TPE vec3Plus(result,TPE vec3Times(normal, velocity) ); 
if (TPE vec3Len(TPE vec3Minus(veli,vel2)) >= 
: g : : 2 TPE ANTI VIBRATION VELOCITY BREAK) 
void TPE bodyMultiplyKineticEnergy(TPE Body *body, TPE Unit f) 


. body1->antiVibration = 0; 
if (body->mass == TPE_INFINITY) body2->antiVibration = 0; 
return; } 
TPE_vec3Multiply(body->velocity f,&(body-»velocity)); if (TPE vecaDotProduct(colL1slonNormal, veli) < 
f = TPE sqrt( TPE FRACTIONS, PER UNIT) ; TPE_vec3DotProduct(collisionNormal, vel2) ) 


return; // invalid collision (bodies going away from each other) 
TPE vec3Multiply(body-»velocity,f,&(body-»velocity)); 


i i = /* We now want to find an impulse I such that if we apply I to body2 and -I 
ante t Soulo d tati isVelocit to body1, we conserve kinetic energy (or keep as much of it as defined by 
sign (body-»rotatioricaxIsVeloeltyiw)y energyMultiplier). The direction of I is always the direction of 


s : : : = collisionNormal, we are on looking for the size of the impulse. We don't 
Se adi sr DERE ADI ONIS lorie E * f) / TPE FRACTIONS PER UNIT; have to worry about conserving momentum, it is automatically conserved by us 
y j ; y. - -PER i applying the same (but opposite) impulse to both bodies. The equation is 


: : constructed as: 
/* we try to prevent the angular welocity from falling to O as that causes 
issues with gravity (bodies balancing on corners) * 


e outi + e out2 - energyMultiplier * (e ini + e in2) = 0 


if (f !- 0 && ; ; ; 
= A ; ; ] me Where e ini (e in2) is the current kin. energy of bodyi (body2) and e outi 
Sagn J= uus Dody ~votat ton axis VE TOC LEY W == 8) (e_out2) is the energy of body1 (body2) AFTER applying impulse I. The 
y ] Yew = Signy unknown (x) in the equation is the size of the impulse. Expanding all this 
considering moment of ineartia of a sphere (for Simplicity). we get a 


: : adratic equati ith coefficient 
void TPE correctEnergies(TPE Body *bodyi, TPE Body *body2, qu Xe PATARIA COS NOLES 


TPE Unit previousEnergy, TPE Unit restitution) a = 1/(2* m) + 1/(2 * m2) + 
A : zu q1/2 * dot(cross(normal,p1),cross(normal, p1 + 
SUM rev tousEnergy. == 0) q2/2 * dot(cross(normal, p2), cross(normal, p2 

i 
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dot 


bz dot v2,normal) - dot(vi,normal) + 
ri cross 


dot „Cross normal, p2 
normal, pi 


c = m1/2 * rS MT ,V1) + wi * dot(ri,r1) + 
m2/2 * dot(v2,v2) * w2 * dot(r2, r2) - energyMultiplier * (e ini * e in2) 


where 
n= 2* m * dü 
"n = T id dn) 5 ) 
dn - maximum Dene of body n 


The following code is solving this equation: */ 


TPE Unit tmp = TPE_bodyGetMaxExtent(body1); 
TPE Unit wi = ((((body1- zmass * tmp) / TPE FRACTIONS PER UNIT) * tmp) / 
TPE | FRACTIONS PER RONITI 
TPE Unit qi = (TPE FRACTÍONS | SER UNIT * TPE FRACTIONS PER UNIT * 2) / 
TPE nonzero(wi); 
TPE Vec4 nxpi = TPE_vec3Cross(collisionNormal, p1); 
TPE_Vec4 roti = 
TPE vec3Times(body1-»rotation.axisVelocity,bodyi1-»rotation.axisVelocity.w); 


tmp - TPE MUTET (pody 2); 

TPE Unit w2 = £C £ body2- wae Y tmp) / TPE FRACTIONS PER UNIT) * tmp) / 
TPE FRACTION R UNIT 57 

TPE Unit ge - (se FRACTTONS 1 PER | UNIT * TPE FRACTIONS PER UNIT * 2) / 
TPE non ero(w2); 

TPE Vec4 nxp2 - TPE __vec3Cross(collisionNormal, p2); 

TPE_Vec4 rot2 = 
TPE_vec3Times(body2->rotation.axisVe locity, body2->rotation.axisVelocity.w); 


uint8 t dynamic = body1->mass !- TPE INFINITY; 


// quadratic eq. coefficients: 
TPE Unit a - 
((dynamic * TPE FRACTIONS PER UNIT * TPE FRACTIONS PER UNIT) / body1->mass 


TPE FRACTIONS PER UNIT * TPE FRACTIONS PER neg / ,body2- >mass) / 2 + 
dynamic * qi * TPE | vec3DotProduct(nxpi,nxpi) + 

TPE vec3DotProduct(nxp2,nxp2)) / 
(2 * TPE FRACTIONS | PER |! UNIT); 


TPE Unit b - "er 
TPE vec3DotProduct(body2- »velocity,collisionNormal) * 
TPE vec3DotProduct(rot2,nxp2) - 
dynamic * ( 

TPE vec3DotProduct(body1- >velocity, collisionNormal) + 
TPE vec3DotProduct (roti, nxp1) ); 


er Unit 
dynamic * TPE sbedygetKineticEnergy(body1), 
e = TPE bodyGetKineticEnergy(body2); 


TPE Unit c - 


dynamic * bodyi-»mass * TPE vec3DotProduct(body1-»velocity,body1i- 
>velocity) + 
body2->mass * TPE vec3DotProduct(body2-»velocity,body2-»velocity) 
/ (2 * TPE FRACTIONS PER UNIT) + 


dynamic * wi * TPE vec3DotProduct(roti,roti) + 
w2 * TPE vec3DotProduct(rot2,rot2 
/ TPE | FRACTIONS PER_UNIT 

((e1 + e2) * energyMultiplier) / TPE_FRACTIONS_PER_UNIT); 


c = TPE_sqrt(b * b - 4 * a * c); // discriminant 
b 
a 
// solutions: 


TPE Unit x1, x2; 


x1 
x2 


b - c) * TPE FRACTIONS PER UNIT) / a; 
b + c) * TPE FRACTIONS PER UNIT) / a; 


// here at least one solution (x1 or x2) should be © (or close) 


if TPE abs(x1) < TPE abs(x2)) 
xi = x2; // we take the non-0 solution 


collisionNormal - TPE vec3Times(collisionNormal, x1); 


if ( TPE bodyUpdateAntivibration(body2)) 
JiBE-bodyApp lyImpulse(body2, p2, collisionNormat) ; 
else 
TPE bodyMultiplyKineticEnergy(body2,9); 
if (bodyi-»mass !- TPE INFINITY) 
if ( TPE bodyUpdateAntivibration(body1)) 
TPE vec3MultiplyPlain(collisionNormal, -1,&collisionNormal) 
TPE bodyApplyImpulse(bodyi,p1,collisionNormal); 
else 
TPE bodyMultiplyKineticEnergy(body1,9); 


// we try to correct possible numerical errors: 


} TPE_correctEnergies(body1, body2,e1 + e2,energyMultiplier); 


TPE_Unit TPE linearVelocityToAngular(TPE Unit velocity, TPE Unit distance) 


2 * TPE PI * distance) / TPE FRACTIONS PER UNIT; 


TPE Unit circumfence - 
RACTIONS PER UNIT) / circumfence; 


return (velocity * TPE | 
TPE Unit TPE angularVelocityToLinear(TPE Unit velocity, TPE Unit distance) 


TPE Unit circumfence - (2 * TPE | PI * distance) / TPE FRACTIONS PER UNIT; 
return (velocity * circümfence) / TPE FRACTIONS PER UNIT; 


void TPE bodyStep(TPE Body *body) 

if (body-»mass !- TPE INFINITY) 
TPE_vec3Add(body->position, body->velocity, &(body- posit lonj]; 
body->rotation. currentAngle += body->rotation.axisVelocity.w; 


if ((body->antiVibration & 0x7f) > 0) 


body->antiVibration = (Body 22 zn LO & 0x80) | 
((body-»antiVibration & 0x7 1) 


r 


if (body->antiVibration == 0x80) 
body->antiVibration = 0; 


H 
H 
void TPE bodySetRotation(TPE Body *body, TPE Vec4 axis, TPE Unit velocity) 


if (body->rotation.currentAngle != 0) i 
body->rotation.originalOrientation = TPE bodyGetOrientation(body); 


ir (velocity < 0) 


velocity *- ‘4; 


TPE_vec3Normalize(&axis) ; 


body->antiVibration = (body->antiVibration & Ox7f) 
((TPE_vec3DotProductPlain(axis, body->rotation.axisVelocity) <= 0) << 7); 


body->rotation.axisVelocity axis; 
body->rotation.axisVelocity.w = velocity; 
body->rotation.currentAngle 0; 


H 
void TPE bodyAddRotation(TPE Body *body, TPE Vec4 axis, TPE Unit velocity) 


"EM 


/* Rotation is added like this: we convert both the original and added 
rotation to vectors whose direction is atong the rotations axis and 
magnitude is the rotation speed, then we add these vectors and convert 
the final vector back to normalized rotation axis + scalar rotation 
speed. */ 

if (velocity == 0) 

return; 


body->rotation.axisVelocity.x 
f ody->rotation. axisvelocity. x * body-»rotation.axisVelocity.w) 
. FRACTIONS PER UNIT; 


body -»rotation.axisVe goiti = : A 
Dody-srotation.axisVe loki y.y * body->rotation.axisVelocity.w) 
TPE FRACTIONS PER UNIT; 


body-»rotation.axisVelocity.z 
g ody->rotation. axisve locity. z * body-»rotation.axisVelocity.w) 
TPE FRACTIONS_PER_UNIT; 


TPE_vec3Normalize(&axis); 


axis.x = (axis.x * velocity) / TPE_FRACTIONS_PER_UNIT; 
axis.y = (axis.y * velocity) / TPE FRACTIONS PER UNIT; 
axis.z - (axis.z * velocity) / TPE FRACTIONS PER UNIT; 


TPE_vec3Add(body->rotation.axisVelocity, axis, &axis); 
axis.w = TPE_vec3Len(axis); 


} TPE_bodySetRotation(body, axis, axis.w); 


we TPE_quaternionMultiply(TPE_Vec4 a, TPE_Vec4 b, TPE_Vec4 *result) 

TPE_Vec4 r; // in case result is identical to a or b 
X 
( * 
4 


) / TPE FRACTIONS PER UNIT; 


* 0x eK 


cocco 


x 
w 
z 
Y 


+ 


oooO 


y 
su ob: 
wt 
x) / TPE FRACTIONS PER UNIT; 


* ox ox ox 


cocco 


z+ 
yo 
x + 
w) / TPE FRACTIONS PER UNIT; 


* ox ox ox 


cocco 


w 
x 
-y 
Z) / TPE FRACTIONS PER UNIT; 
result-»x - 
result->y 
result->z 
result->w = r.w; 


} 


yoid TPE_rotationToQuaternion(TPE_Vec4 axis, TPE_Unit angle, TPE_Vec4 
*quaternion) 


TPE vec3Normalize(&axis); 
angle /- 2; 
TPE Unit s - TPE sin(angle); 


quaternion->x 
quaternion->y 


S * axis.y) / TPE FRACTIONS PER UNIT; 
quaternion->z 


S * axis.z) / TPE FRACTIONS PER UNIT; 


fs * axis. y) / TPE_FRACTIONS_PER_UNIT; 


quaternion->w 


} 
Jeune TPE_asin(TPE_Unit x) 
x = TPE clamp(x,-TPE FRACTIONS PER UNIT, TPE_FRACTIONS_PER_UNIT); 


TPE cos(angle); 


int8 t sign - 1; 
if (x « 0) 
sign - -1; 
pu 
} 


inti6 t low = 0; 
inti6 t high = TPE_ SIN TABLE LENGTH -1; 
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inti6 t middle; 


while (low «- high) // binary search a.x = a.x >= TPE FRACTIONS PER UNIT ? a.x / TPE FRACTIONS PER UNIT 


. : (a.x> 0? 1 : -1); 
middle = (low + high) / 2; 


TPE_Unit v = TPE_sinTable[middle]; 


if (v > x). a.y = a.y >= TPE_FRACTIONS_PER_UNIT ? a.y / TPE_FRACTIONS_PER_UNIT 
high = middle - 1; {a.y > 0? 1: -1); 

else if (v « x) 
low = middle + 1; a.z *- f; 

else i 
break; if (a.z != 0) 


a.z = a.z >= TPE_FRACTIONS_PER_UNIT ? a.z / TPE FRACTIONS PER UNIT : 


r 


middle *= TPE_SIN_TABLE_UNIT_STEP; 


return sign * middle; if (a.x != 0) 
} ar = 2x5 TPE_FRACTIONS_PER_UNIT ? a.x / TPE FRACTIONS PER UNIT 
a.x > 2-1); 
TPE Unit TPE acos(TPE Unit x) j 
: if (a.y != 0) 
return TPE asin(-1 * x) * TPE FRACTIONS PER UNIT / 4; Bry Say PE TPE_FRACTIONS_PER_UNIT ? a.y / TPE FRACTIONS PER UNIT 
a.y > : -1); 
yoid TPE_quaternionToRotation(TPE_Vec4 quaternion, TPE_Vec4 *axis, TPE_Unit if (a.z != 0) 
angle) a.z = eres TPE_FRACTIONS_PER_UNIT ? a.z / TPE FRACTIONS PER UNIT 
R a > d, 9 " 
*angle - 2 * TPE acos(quaternion.x); */ (a.z 
TPE_Unit tmp = return a; 


TPE nonZero(TPE sqrt( 
(TPE FRACTIONS PER UNIT - 


jue ee BER ah pde 0 TPE FRACTIONS: PER-UNGT yoid TPE-vecsAverage(TPE Vec4 a, TPE Vec4 b, TPE Vec4 *result) 
X x +b. ; 
axis->x = (quaternion.x * TPE FRACTIONS PER UNIT) / tmp; eon Uis = halves bey , 2i 
axis-»y - (quaternion.y TPE FRACTIONS PER UNIT tmp; - = .z +b. 
axis-»z = (quaternion.z * TPE-FRACTIONS PER UNIT) / tmp: PABM EL oZ Mane E Miah deer 


d 2 i : i r id TPE_vec4Substract(const TPE_Vec4 a, c t TPE_Vec4 b, TPE_Vec4 *result 
void TPE quaternionToRotationMatrix(TPE Vec4 quaternion, TPE Unit matrix[4][4]) — (^. -vecáSubstract( - 7 GORS = a result) 


->x 2 a.x - b. 
TPE unit | | pu CI 
_2x2 = (2 * quaternion.x * quaternion.x) / TPE FRACTIONS PER UNIT, result->z = a.z - b.z: 
_2y2 = (2 * quaternion.y * quaternion.y) / TPE FRACTIONS PER UNIT, result-»w = a.w - b.w: 
.222 = (2 * quaternion.z * quaternion.z) / TPE FRACTIONS PER UNIT, H 
PHI Ug 5$ 0HM o0: y 
—2xw quaternion.x * quaternion.w il | PER | : : 
-2zu 2 * quaternion.z : quaternion.w / TRE FRACTIONS PER UNIT, ren TPE vec3Multiply(const TPE Vec4 v, TPE Unit f, TPE Vec4 *result) 
_2xZ = quaternion.x * quaternion.z ki | PER | z = 
-2yw = (2 * quaternion.y * quaternion.w) / TPE FRACTIONS PER UNIT, Fest Ee zx + [1 7 TBE-ERACTIONS-PER-UNIT; 
_2yz = (2 quaternion.y quaternion.z) / TPE_FRACTIONS_PER_UNIT; result-»z = (v2 * fj 7 TPE FRACTIONS PER UNIT; 


#define ONE TPE FRACTIONS PER UNIT 
void TPE vec3MultiplyPlain(TPE Vec4 v, TPE Unit f, TPE Vec4 *result) 


matrix[0][0] = ONE - 2y2 - _2z2; { 
matrix[1][O] = _2xy - _2zw; resu 
matrix[2][0] = _2xz + _2yw; resu 
matrix[3] [0 = 0; resu 
matrix[0][1] = _2xy + _2zw; } 
matrix[1][1] = ONE - _2x2 - _2z2; void TPE_vec4Multiply(const TPE_Vec4 v, TPE_Unit f, TPE_Vec4 *result) 
matrix[2][1] = _2yz - _2xw; { 
matrix[3][1] = 0; result->x = (v.x * f) / TPE FRACTIONS PER UNIT; 

result-»y - (v.y * f) / TPE FRACTIONS PER UNIT; 
matrix[0][2] = _2xz - _2yw; result->z = (v.z * f) / TPE FRACTIONS PER UNIT; 
matrix[1]|]2] = 2yz + 2xw; result-»w - (v.w * f) / TPE FRACTIONS PER UNIT; 
matrix[2][2] = ONE- 2x2 - _2y2; } 
matrix[3][2] = 0; 

TPE_Unit TPE_abs(TPE_Unit x) 
matrix[0][3] = 0; 
matrix[1][3] = 0; return (x >= 0) ? x : (-1 * x); 
matrix[2][3] = 0; 
matrix[3][3] = ONE; 
TPE_Unit TPE_vec3Len(TPE_Vec4 v) 
#undef ONE 
} return TPE sqrt(v.x * v.x + v.y * v.y + v.z * v.z); 


void TPE_vec3Add(const TPE_Vec4 a, const TPE_Vec4 b, TPE_Vec4 *result) E 
{ TPE_Unit TPE_vec3Dist(TPE_Vec4 a, TPE_Vec4 b) 
result->x 
result->y 
result->z 


Won 
m 
+ 


t 
b.y; } return TPE vec3Len(TPE vec3Minus(a,b)); 


TPE Unit TPE vec4Len(TPE Vec4 v) 
void TPE vec4Add(const TPE Vec4 a, const TPE Vec4 b, TPE Vec4 *result) 
t return TPE sqrt(v.x * v.x * V.y * v.y + V.Z * v.z + V.W * vV.w); 


result-»x - a.x * b.x; 
result->y = a.y + b.y; 
result->z = a.z + b.z; TPE_Unit TPE_vec3LenTaxicab(TPE_Vec4 v) 
result->w = a.w + b.w; 


return TPE_abs(v.x) + TPE_abs(v.y) + TPE_abs(v.z); 


void TPE_vec3Substract(const TPE_Vec4 a, const TPE_Vec4 b, TPE_Vec4 *result) 
{ TPE Unit TPE vec3DotProduct(const TPE Vec4 vi, const TPE_Vec4 v2) 


result-»x - a.x - b.x; 

result-»y - a.y - b.y; return 

result-»z = a.z - b.z; n (v1.x * v2.x + v1.y * V2.y + v1.z * v2.z) / TPE FRACTIONS PER UNIT; 
TPE Vec4 TPE vec3Plus(TPE Vec4 a, TPE Vec4 b) TPE Unit TPE vec3DotProductPlain(const TPE Vec4 vi, const TPE Vec4 v2) 


return v1.x * v2.x + vi.y * v2.y + v1.z * v2.z; 


pu TPE vec3Normalize(TPE Vec4 *v) 
TPE Unit l = TPE vec3Len(*v); 


if (1 == 0) 
v->X = TPE FRACTIONS PER UNIT; 
return; 
v->x = (v->x * TPE FRACTIONS PER UNIT) / l; 
v->y = (v->y * TPE FRACTIONS PER UNIT) / l; 
1 P v->Z = (v->Z * TPE FRACTIONS PER UNIT) / l; 
Ten TPE vec3Times(TPE Vec4 a, TPE Unit f) H 
a.x = (a.x * f) / TPE FRACTIONS PER UNIT; id TPE vec4Normali TPE Vec4 * 
aly = (a.y * f) / TPE-FRACTIONS PER UNIT: p c ize(TPE- v) 
a.z = (a.z * f) / TPE FRACTIONS PER UNIT; TPE Unit l = TPE vec4Len(*v); 
return a; if (1 == 0) 
v->X = TPE FRACTIONS PER UNIT; 
TPE_Vec4 TPE vec3TimesAntiZero(TPE Vec4 a, TPE Unit f) } return; 
a.x *= f; 
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} 


V-2X = (v-»x * TPE FRACTIONS PER UNIT) / l; 
v->y v->y * TPE FRACTIONS PER UNIT) / Ll; 
V->Z v->zZ * TPE FRACTIONS PER UNIT) / l; 
v->w = (v->w * TPE FRACTIONS PER UNIT) / l; 


yota TPE_vec3Project(TPE_Vec4 v, TPE_Vec4 base, TPE_Vec4 *result) 


} 


TPE Unit p = TPE_vec3DotProduct(v, base); 

result->x = (p * base.x) / TPE FRACTIONS PER UNIT; 
result-»y - (p * base.y) / TPE FRACTIONS PER UNIT; 
result->z = (p * base.z) / TPE FRACTIONS PER UNIT; 


TPE_Vec4 TPE vec3Projected(TPE Vec4 v, TPE Vec4 base) 


TPE_Vec4 r; 
TPE vec3Project(v,base,&r); 


return r; 


void TPE ..getVelocitiesAfterCollision( 


) 


} 


TPE Unit *v1, 
TPE Unit *v2, 
TPE Unit mi, 
TPE Unit m2, 
TPE Unit elasticity 


/* in the following a lot of TPE FRACTIONS PER UNIT cancel out, feel free to 
check if confused * 


#define ANTI OVERFLOW 30000 
#define ANTI OVERFLOW SCALE 128 


uint8 t overflowDanger = mi > ANTI OVERFLOW || 


*v1 > ANTI OVERFLOW || 
m2 » ANTI OVERFLOW || *v2 » ANTI OVERFLOW; 


if (overf LowDanger ) 


mi = (mi != 0) ? TPE nonZero(mi / ANTI OVERFLOW SCALE) : 0; 
m2 = (m2 != 0) ? TPE nonZero(m2 / ANTI OVERFLOW SCALE) : 0; 
*v1 = (*vi != 0) ? TPE nonzero(*vi / ANTI OVERFLOW SCALE) : 0; 
*v2 = (*v2 != 0) ? TPE nonZero(*v2 / ANTI OVERFLOW SCALE) : 0; 


} 


TPE Unit miPm2 
TPE Unit v2Mvi 


TPE nonZero(mi + m2); 
TPE nonZero(*v2 - *v1); 


TPE Unit miviPm2v2 = ((mi * *v1) + (m2 * *v2)); 


= (((elasticity * m2 / TPE FRACTIONS PER UNIT) * v2Mvi) 
* miviPm2v2) / miPm2; 


*v2 = (( (elasticity * mi / TPE FRACTIONS PER UNIT) * -1 * v2Mv1) 


+ miviPm2v2) / miPm2; 


if (overflowDanger) 


*v1 *- ANTI OVERFLOW SCALE; 
*v2 *- ANTI OVERFLOW SCALE; 


#undef ANTI OVERFLOW 
#undef ANTI OVERFLOW SCALE 


void TPE bodyGetTransformMatrix(const TPE Body *body, TPE Unit matrix[4][4]) 


} 


TPE_Vec4 orientation; 


orientation = TPE bodyGetOrientation(body); 
TPE_quaternionToRotationMatrix(orientation, matrix); 
matrix[0][3 body->position.x; 

matrix[1][3 body-»position.y; 

matrix[2][3 body-»position.z; 


void TPE quaternionInit(TPE Vec4 *quaternion) 


quaternion->x 
quaternion->y 
quaternion->z 
quaternion->w 


0: 
TPE_FRACTIONS_PER_UNIT; 


Co TPE_rotatePoint(TPE_Vec4 *point, TPE_Vec4 quaternion) 
// TODO: the first method is bugged, but maybe would be faster? 


"if 0 


TPE Vec4 quaternionConjugate = TPE quaternionConjugate(quaternion); 
point-»w - 0; 


TPE quaternionMultiply quaternion, *point, point); 
TPE quaternionMultiply(*point,quaternionConjugate, point); 


else 


TP 
TPE? FRACTIONS PER n 
TP 


TPE Unit m[4][4]; 

TPE quaternionToRotationMatrix(quaternion,m); 

TPE Vec4 p = *point; 

Peel to) + p.y * m[O][1] + p.z * m[0][2]) / 
ESI + p.y * m[1][1] + p.z * m[1][2]) / 
pólo] + p.y * m[2][1] + p.z * m[2][2]) / 


oint-»x (Bex 
FRACTIONS ER | m 


oint-»z (Bex 
FRACTIONS ER | m 


#endif 
H 


TPE_Vec4 TPE quaternionConjugate(TPE Vec4 quaternion) 


quaternion.x *- -1; 
quaternion. y *= -1; 
quaternion.z *= -1; 


return quaternion; 


TPE_Vec4 TPE_vec3Normalized(TPE_Vec4 v) 


} 


TPE_vec3Normalize(&v); 
return v; 


piam TPE lineSegmentClosestPoint(TPE Vec4 a, TPE Vec4 b, TPE Vec4 p) 
TPE_Vec4 ab = TPE vec3Minus(b,a); 


TPE Unit t - cic ay OnsDotProduct (ab, TPE qpecgManus (p, ay) * 
TPE FRACTIONS PER UNIT) / TPE nónZero(TPE vecaDotProduct(ab,ab))); 


if macs $ 9) 


else. in’ TX > TPE FRACTIONS PER UNIT) 
FRACTIONS PER UNIT; 


TPE vec3Multiply(ab,t,&ab); 


} return TPE vec3Plus(a,ab); 


oe TPE_bodyGetKineticEnergy(const TPE_Body *body) 
TPE Unit v = TPE_vec3Len(body->velocity) ; 


v *= Vv; 


M | v »- TPE FRACTIONS PER UNIT) ? 


9 | 
PES FRACTIONS PER UNIT : 1; 


< 


v = (body-»mass * v) / (2 * TPE FRACTIONS PER UNIT); 


// TODO: handle small values 


// TODO: clean this mess :) 


TPE Unit r = TPE bodyGetMaxExtent (body); 
re 


TPE_timesAntiZero( 
TPE_timesAntiZero(r 
TPE timesAntiZero(b 

>rotation.axisVelocity. 


) 


body-»mass 
/ (5 * TPE FRACTIONS PER UNIT); 


iv) 
ody->rotation.axisvelocity.w, body- 
w 


if (r "m © && body->rotation.axisVelocity.w !- 0) 
r=41,; 


return v + r; 


RAE TPE bodyGetMaxExtent(const TPE Body *body) 
switch (body-»shape) 


case TPE SHAPE SPHERE: 
return body-»shapeParams [0]; 
break; 


case TPE SHAPE CUBOID: 
return TPE vec3Len(TPE vec4( 
body->shapeParams[0] / 2, 
body->shapeParams[1 i 2, 
body->shapeParams[2 2; 0)); 
break; 


// TODO: 


other shapes 
default: 


} return 0; break; 
H 
void TPE bodyRecomputeBounds(TPE Body *body) 


body->boundingSphereRadius = TPE bodyGetMaxExtent (body); 


ae TPE_timesAntiZero(TPE_Unit a, TPE_Unit b) 
TPE_Unit result = a * b; 


return result >= TPE FRACTIONS PER UNIT ? 


result / TPE FRACTIONS PER UNIT : (result !- 0 ? 1 : 0); 


int8 t TPE sign(TPE Unit x) 


return x >0?1: (x«0? -1: 0); 


void TPE worldInit(TPE World *world) 
world->bodyCount = 0; 


void TPE worldStepBodies(TPE World *world) 
for uinti6 t i = 0; i « world->bodyCount; 
} . bodyStep(&(wor ld- >bodies[i])); 


TPE_Vec4 TPE_createVecFromTo(TPE_Vec4 pointFrom, TPE_Vec4 pointTo, 
TPE_Unit size) 


++i) 


return TPE_vec3Times(TPE_vec3Normalized( 
TPE_vec3Minus(pointTo, pointFrom) ),size); 
void TPE worldApplyGravityDown(TPE World *world, TPE_Unit g) 
TPE Body *b = world->bodies; 
for (uint16_t i = 0; i < world->bodyCount; 


if (b->mass != TPE_INFINITY) 
b- >velocity. y -= g; 


++i) 


b++; 


3 
3 


void TPE worldApplyGravityCenter(TPE World *world, TPE_Vec4 center, TPE Unit g) 


TPE Body *b = world->bodies; 
for (uint16 t i = 0; i < world->bodyCount; 
if (b->mass != TPE_INFINITY) 


b- >velocity = TPE vec3Plus(b-»velocity,TPE createVecFromTo( 
b-»position,center,g)); 


++i) 
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b-t; 


void TPE worldResolveCollisionNaive(TPE World *world) 
TPE Body *b1 = world->bodies; 
for (uinti16 t i = 0; i < world->bodyCount - 1; ++i) 
t TPE_Body *b2 = &(world->bodies[i + 1]); 
TPE_Vec4 p, n; 
for (uint16_t j = i + 1; j < world->bodyCount; ++j) 
if (b1->mass != TPE_INFINITY || b2->mass != TPE_INFINITY) 
TPE_Unit d = TPE_bodyCollides(b1,b2,&p,&n); 


programs/test.c 


/** General automatic test for tinyphysicsengine thig should always be run 
and passed before publishing a new version of TPE. */ 


#include " t Atinyphysicsengine; h" 
#include <stdio 


osrin ass s(send, ,text) { printf (" [CHECK] ey; text ": "); if (!(cond)) 


( puts("ERROR"); return 1; } else puts("OK"); } 


TPE Unit rampPoits[6] - 
0,0, 


-5400, 1400, 
-2400, 0 


i 


po envFunc(TPE_Vec3 p, TPE_Unit maxD) 


TPE_ENV_START( TPE_envAABoxInside(p, TPE_vec3(0,1000, 0), TPE_vec3(7000, 6000, 7000) 


p 
"TPE ENV. | NEXT TPE envAATriPrism(p, TPE : vec3(100, 200, -10), rampPoits, 3000, 2), p) 
TPE_ENV_NEXT( TPE envBox(p TPE vec3(30,2 
10), TPE_vec3(500, 600, 700), TPE_vec3(10, 20, 3855 
TPE_ENV_NEXT( TPE envAABox(p, TPE_vec3(-100, 300, 200), TPE_vec3(500, 600, 700) ), 


p 
TPE_ENV_END 


TPE_Vec3 envFunc2(TPE_Vec3 p, TPE_Unit maxD) 


TPE ENV START( TPE ;envSphereInside(p, TPE vec3(100,20,-3),5000), p) 
TPE ENV NEXT( TPE envGround(p, -500), p) 


if (TPE_ENV_BCUBE_TEST(p,maxD, TPE. vec3(300, -40,50),1100) ) 
TPE_ENV_NEXT( TPE envCylinder(p, TPE_vec3(300, -40,50), TPE_vec3(-400, -200, - 
50), 751), p) 
} 
TPE ENY NEXI( TPE ẹnvCylinder (p, TPE_vec3(-500, 500, -20), TPE_vec3( - 
400,600, 700), 500), p) 


TPE_ENV_END 


toe envFuncBad(TPE_Vec3 p, TPE_Unit maxD) 
p.x += 200; 
return p; 

TPE_Vec3 envFuncBad2(TPE_Vec3 p, TPE_Unit maxD) 


if (p.y > p.x) 
p.x = p.y; 


return p; 


qoe nem envSimple(TPE Vec3 p, TPE Unit maxD) 


TPE ENV START( TPE envAABoxInside(p, TPE vec3(0,0,0),TPE vec3(10000, 10000, 10000) 


p) 
"TPE_ENV_NEXT( TPE envHalfPlane(p, TPE_vec3(0, -5000, 0), TPE_vec3(500,500,0)), p) 
TPE_ENV_END 


TPE_Unit heightMap(int32_t x, int32_t y) 


x *= 16; 
y *= 16; 
return 


TPE sin(x + TPE cos(y * 2) * TPE sin(y * 2 + TPE cos(x * 4)) / 
(TPE FRACTIONS PER UNIT / 2); 


TPE Vec3 envFuncHeightmap(TPE Vec3 p, TPE Unit maxD) 
return TPE envHeightmap(p, TPE vec3(10,20,39),500,heightMap,maxD); 


int main(void) 


puts("-- testing tinyphysicsengine --"); 


ass(TPE vec2Angle(-100,0) == TPE FRACTIONS PER UNIT / 2,"vec2 angle") 
TPE Unit 1; 


l = TPE LENGTH(TPE, vec3Normalized(TPE vec3(100,0,0))); 
ass(TPE abs(l - TPE FRACTIONS PER UNIT) « 5,"vec3 normalize") 


l = TPE LENGTH(TPE vec3Normalized(TPE - eur 0))); 
ass(TPE abs(l - TPE_FRACTIONS_PER_UNIT) « "Zero vec3 normalize") 


l = TPE LENGTH(TPE vec3Normalized(TPE vec3 D -1,0))); 
ass(TPE_ abs(l - TPE FRACTIONS PER UNIT) < 'small vec3 normalize") 


l = TPE LENGTH(TPE. vec3Normalized(TPE vec3(500000, 300000, -700000))); 


if (d) 
TPE_resolveCollision(b1,b2,p,n,d,300); 


b2++; 
H 
bic; 
J 
H 
void TPE attractBodies(TPE Body *body1, TPE Body *body2, TPE Unit acceleration) 


TPE Vec4 direction = TPE_createVecFromTo(body2->position, body1->position, 
acceleration); 


body2->velocity 
body1->velocity 


TPE_vec3P Lus(body2- ave locity direction); 
TPE_vec3Minus(body1->veloci y, direction); 


#endif // guard 


ass(TPE abs(l - TPE FRACTIONS PER UNIT) « 5,"big vec3 normalize") 


H 
{ ; 

TPE Joint igints[16]; 
TPE Connection cons 16]; 
joints[0] = TPE_joint(TPE_vec3( 200,100, -400), 300 
joints[1] = TPE joint TPE vec3 100, 200, -400 ,300 
joints[2] - TPE joint(TPE vec3 200, -400, 200 , 300 
joints[3] - TPE joint(TPE vec3 200, 100, ,400 
cons[0].jointi = 0; cons[0].joint2 = 1; cons[0].length = 1000; 
cons[1].jointi = 1; cons[1].joint2 = 0; cons[1]. length 1000; 
cons[2].jointi = 0; cons[2].joint2 = 1; cons[2]. length 1100; 
cons[3].jointi = 2; cons[3].joint2 = 3; cons[3]. length = 100; 
uint32_t jHashes[4], cHashes[4]; 
for (int i = 0; i < 4; ++i) 

jHashes[i] = TPE jointHash(&joints[i]); 

cHashes[i] = TPE connectionHash(&cons[1]); 
for (int i = 0; i < 4; ++i) 

for Bou j= i +1; ] <4; j) 

s(jHashes[i] != Jestésti]. && cHashes[i] !- 
cHashes[j]; joints/Cconnection h 


TPE Body brasheseai 
uint32 i bHashes[4] 


TPE bodyInit(&bodies joints -'1,3,cons, 4 00) ; 
TPE bodyInit(&bodies oints,4, cons, t 30 
bodies 3] flags |= TPE_ B DY | FLAG SOFT’ TP), bony FLAG_NONROTATING; 
TPE_bo yinit(&bodies[3], joints, 4,cons, i, 200); 


TPE isnt | , joints, 4,cons, 4, 300 


for (int i = 0; i< 4; A A 
"TPE <hodynas (&bodies[i]); 


bHashes[i] = 
for (int i = 0; i < 4; ++i) 
for (int j = i + 1; à < 4; etj) 
ass(bHashes[i] !- Hashes[41, "body hash"); 


TPE World world; 

uint32 t wHashes[4]; 

TPE worldInit(&world,bodies,4,9); 
wHashes[0] - TPE worldHash(&world); 


badies[9]: jointCount--; 

wHashes[1] = TPE. _wor LdHash(&wor ld) ; 

bodies[ Ale bodies[ [9]; bodies[0] = bodies[3]; bodies[3] = bodies[4]; 
wHashes[2] = TPE worldHash(&world); 

wor ld. bod Count--; 

wHashes[3] - TPE | wor ldHash(&wor ld); 


for (int i - = 0; i< 4; T 
for (int j i51. $ ) 
ass(wHashes[i] != WH Hashes [j]? "world hash"); 


puts("-- environment functions --"); 


ass(TPE testClosestPointFunction(envFunc, TPE.  Veca( - 3000, -3000, -3000), 
TPE vec3(3000,3000,3000),32,40,0), "env function"); 


ass(TPE_testClosestPointFunction(envFunc2, TPE_vec3(-2000, -1000, -5000), 
TPE_vec3(5000, 6000, 7000), 32, 30,0), "env function"); 


ass(TPE Best a0. 1009. 5000 TPE vecd( 40D BUD ap, 
TPE vec3(-2000, -1000, -5000 . Vec3(4000, 6000, 7000), 6,50,0), 
"env function (heightmap)") ; 


ass (1 TPE_testClosestPointFunction envFuncBad, TPE_vec3(-1000, -1000, -1000), 
E_vec3(2000, 3000, 190), 32, 40, 0), "env function bad"); 


ass(!TPE testClosestPointFunction(envFuncBad2, TPE vec3(-1000, -2000, -200), 
TPE vec3(1000,1000,2000),32,40,0), "env function bad"); 


puts("-- simulation --"); 


TPE World w; 

TPE Joint j[64]; 

TPE Connection C [128]; 
TPE Body b[4]; 


ill - TPE RI ER Ye6 (0505 0, y! ,320); 
E "bodyIni (&b[ 
TPE bodyMoveBy (&b[0 "m TPE A 42boo, 3000, 3000) ); 


TPE makeBox(j + 1,c,800, 900, 850, 320 
TPE paion Tenete + 1,8,C,16, 130 j; 


b[1].friction = 400; 
b[1].elasticity = 350; 
EAN TEEN TPE_vec3(-2000, 3800, 1500) ); 
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TPE make2Line(i + 20,c + 32,1000, 300); 

TPE bodyInit(&| [21,3 + 20,2,c + 32,1,1300); 
b[2].flags |= TPE _BODY_FLAG_NONROTATING; 
TPE_bodyMoveBy (&b[2], TPE vec3(-3000, 4100, -1500)); 


TPE makeCenterBox(j + 32,c + 64,600,500,510, 300); 
TPE_bodyInit(&b[3],j + 32,9,c + 64,18,1200): 
b[3], flags |= TPE. BODY FLAG'SOFT; 

TPE_bodyMoveBy (&b[3], TPE vec3(-1500, 3500, -3000)); 


TPE_wor LdInit (&w,b,4,envSimp le); 

inti6 t bi; 

TPE castBodyRay(TPE vec3(-1857,3743,-4800), TPE vec3(0,0,100), -1, &w, &bi, 0); 
ass(bi >= 0,"body ray hit"); 

puts("dropping bodies onto a ramp..."); 

for (int i = 0; i < 300; ++i) 


for (uint8 t i = 0; j < w.bodyCount; ++j) 
TPE bodyApplyGravity(&w.bodies[j],8); 


if (i -- 100) 
ass(TPE worldGetNetSpeed(&w) » 100,"world net speed"); 


TPE worldStep(&w); 


puts("simulation finished"); 
uint32 t hash - TPE worldHash(&w); 
printf("world hash: %Lu\n", hash); 


// change the hash if functionality changes: 
ass(hash == 3411004027,"world hash"); 
for (int i = 0; i < w.bodyCount; ++i) 


ass TPE bodyGetcenter OfMass (Sw podies[i1) x > 0,"x position > 0"); 
ass(w.bodies[i].flags & TPE BODY FLAG D CTIVATÉD, "deactivated?" P 


ass(TPE worldGetNetSpeed(&w) « 100,"world net speed"); 


TPE bodyAccelerate(&w.bodies[0], TPE_vec3(200, 300, -20)); 
TPE_bodyAccelerate( &w.bodies[1], TPE_vec3(-700, 400, 0) ); 
TPE bodyAccelerate(&w.bodies[2], TPE_vec3(20, -300, -1 DE 
TPE bodyAccelerate(&w.bodies[3], TPE vec3(0,30, -900)); 


puts("exploding bodies..."); 


for (int i = 0; i < 100; ++i) 


programs/helper.h 


/** 
Helper code for tünyphysicsengine example programs which handle things like 
see rendering, I/0, small3dlib rendering etc. 


#define TPE_LOG puts 


#include pan t invpnvsicsengineshs 
#include <SDL2/SDL.h> 

#include <math.h> 

#include <stdio.h> 

#include <sys/time.h> // for measuring time 


#ifndef RES_X 
#define RES_X 640 
#endif 


#ifndef RES_Y 
#define RES_Y 480 
#endif 


#ifndef FPS 
#define FPS 30 
#endif 


#ifndef CAMERA_STEP 
#define CAMERA_STEP 100 
#endif 


#ifndef DEBUG_DRAW_DIVIDE 
#define DEBUG_DRAW_DIVIDE 1 
#endif 


#ifndef CAMERA_ROT_STEP 
#define CAMERA ROT STEP 5 
#endif 


#define MSPF (1000 / (FPS)) 
#define S3L RESOLUTION X RES X 
#define S3L RESOLUTION Y RES Y 


#define S3L PIXEL FUNCTION s3l drawPixel 


#ifndef SCALE 3D RENDERING mE 
Seine SCALE 3D RENDERING 1 // helper divider for preveneting overflows 
#endi 


#define S3L_NEAR (S3L FRACTIONS PER UNIT / (4 * SCALE_3D_RENDERING) ) 


#ifndef S3L Z BUFFER 
#define S3L Z BUFFER 1 
#endif 


#ifndef S3L_PERSPECTIVE_CORRECTION 
$ #detine S3L_PERSPECTIVE_CORRECTION 0 
endi 


#ifndef S3L NEAR CROSS STRATEGY 
j #detine S3L_NEAR_CROSS_STRATEGY 1 
endi 


#ifndef HEIGHTMAP 3D RESOLUTION 
" pderine HEIGHTMAP. 3D RESOLUTION 8 
endi 


#ifndef HEIGHTMAP 3D STEP 


for (uint8 t i = 0; j < w.bodyCount; ++j) 
TPE bodyApplyGravity(&w.bodies[j],8); 


TPE worldStep(&w); 


// check if within environment 
for (int i = 0; i < w.bodyCount; ++i) 
TPE Vec3 p - TPE bodyGetCenterOfMass(&w.bodies[i]); 


ass(p.x « 5000 && p.x » -5000 && p.y « 5000 && p.y » -5000 && 
p.z « 5000 && p.z > -5000,"body within environment"); 


I" a Here we'll be casting environment rays and checking if inside rays 
urn 


dóé inside results and outside rays return outside results. The function 
oesn 
guarantee this but at least mostly this should hold. */ 


int correct = 0; 
int incorrect = 0; 


for (int y = -3200; y < 1000; y += 52) 
for (int x = -4000; x « 3000; x += 40) 


TPE Vec3 p = TPE vec3(x,y,x / 16); 
TPE Vec3 p2 = envFunc(p, 300) ; 


uint8 t inside - p.x -- p2.x && p.y -- p2.y && p.z -- p2.z; 
TPE Vec3 p3 = TPE_castEnvironmentRay(p, TPE_vec3(x / 64 + 1,y / 32 - 
envFunc, 30,100, 32); 


2,3), 


p2 = envFunc(p3, 300); 
uint8_t inside2 = p3.x == p2.x && p3.y == p2.y && p3.z == p2.z; 
if (inside != inside2) 

incorrect++; 


else 
correct++; 


ass(correct > incorrect * 5,"environment rays behave kind of OK?"); 
printf("(%d OK, %d not so OK)Nn", correct, incorrect); 


H 
puts("DONE, all OK"); 


return 0; 


#define HEIGHTMAP 3D STEP 512 
#endif 


#define HEIGHTMAP 3D POINTS (HEIGHT MARS DARE SOLUTION * HEIGHTMAP 3D RESOLUTION) 
#define HEIGHTMAP 3D. TRIANGLES (f HEIGHTMAP_3D_RESOLUTION - 1) * 
(HEIGHTMAP_3D_RESOLUTION - 1) * * 3) 


#define S3L_USE_WIDER_TYPES 1 

#include "small3dlib.h" 

#define PIXELS SIZE (S3L_RESOLUTION_X * S3L_RESOLUTION_Y * 4) 
#define helper_lastBody tpe_world.bodies[tpe_world.bodyCount - 1] 


S3L_Unit heightmapVertices[HEIGHTMAP_3D_POINTS * 3]; 
S3L Index heightmapTriangles[HEIGHTMAP 3D TRIANGLE 1; 
S3L Model3D heightmapModel; 


S3L Unit cubeVertices[] - ( S3L CUBE VERTICES(TPE F) ); 
S3L Index cubeTriangles[] = ( S8L CUBE TRIANGLES }; 
S3L Model3D cubeModel; 


S3L Unit tr aadgierriang isfy 


S3L Index triangleTriangles[| = (0, 1, 2, 0, 2, 1}; 
S3L_Model3D triangleModel; ae ER 


S3L_Unit planeVerices[] = 


define a S3L FRACTIONS PER UNIT / 2 
#define b -1 * S3L FRACTIONS PER UNIT / 2 


#undef b 


; 
S3L Index planeTriangles[] = { 0,2,1, 1,2,3 3; 
S3L Model3D planeModel; 


#define SPHERE VERTEX COUNT 42 
const S3L Unit spherevertices|SPHERE VERTEX COUNT *8] - 1 
0 0 0 


-512, 
370, -228, -269 //8 
-141, -228, -435, // 6 
-457, -228, //9 
-141, -228, 435 // 12 
370, -228, 269 // 15 
141, 228, -435, // 18 
-370, 228, -269, // 21 
-370, 228, 269 // 24 
141, 228, 435, // 27 
457, 228, 9, // 30 

512, 9, // 33 
-83, -435, -255, // 36 
217, -435, -158 // 39 
134, -269, -414, // 42 
435,  -269, // 45 
217, -435, 158, // 48 
-269, -435, // 51 
-352, -269, -255, // 54 
-83, -435, 255, // 57 
-352, -269, 255 // 60 
134, -269, 414, // 63 
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486, 0, -158 // 66 13, 14, 12, // 18 
486, 0, 158, // 69 15, 16, 14, // 21 
O, 0, -512, // 12 17; ; i // 24 
300, 0, -414 // 15 17, 18, 16, // 21 
-486, 0, -158 // 18 19, 1 18, // 30 
-300, 0, -414, // 81 6, 14, 18, // 33 
-300, 0, 414, // 84 1; : j // 36 
-486, 0, 158 // 87 3, 5, 4, // 39 
300, 0, 414 // 90 5, 7, 6, // 42 
9, 0, 512, // 93 T 9, 8, // 45 
352, 269, -255, // 96 9, 11, 10, // 48 
-134 269, -414, // 99 11, 13, 12, // 51 
-435 269 0 // 102 13, 45, 14, // 54 
-134, 269, 414, // 105 15, 17, 16, // 51 
352, 269, 255, // 108 > T7; // 60 
83 435, -255, // 111 d 19, 17, // 63 
269 435 [5 // 114 17, 15, 13, // 66 
-217, 435, -158, // 117 13, 13. 17, // 69 
-217, 435, 158, // 120 A ; 17, // 72 
83, 435, | 255 // 123 3, 1, 1T, // 15 
3; // sphereVertices 17; T1, 9, // 78 
17; 19, 18, // 81 
#define SPHERE TRIANGLE COUNT 80 19, 1, 9, // 84 
const SsL Index sphereTriangleIndices[SPHERE TRIANGLE COUNT s 3] 2E 18, 9; 2; j^ EA 
1 r r 
1, 13, 15, // 3 6, 8, 10, // 93 
9, 12; 17, // 6 10, 12, 14, // 96 
9, 17, 19, //9 14, 16, 18, // 99 
9, 19, 16, // 12 18, 2, 6, // 102 
1; 15, 22, // 15 6, . 20, on 014 : // 105 
2r 14, 24, // 18 3; // cylinderTriangleIndices 
3, 18, 26, //21 
4, 20, 28, // 24 S3L Model3D sphereModel; 
5, 21, 30, // 27 S3L_Model3D cylinderModel; 
T; 22, 25, yj 30 
2, 24, 27, 33 #define MAX_BODIES 128 
3 20/ 29, i E #define MAX JOINTS 1024 
, 
5 30, 23! 77 22 #define MAX CONNECTIONS 2048 
S 32, E PAR TPE Body tpe bodies[MAX BODIES] 
8 34. 40. // 51 TPE Joint tpe joints[MAX JOINTS} ; 
' ' , TPE Connection tpe connections[MAX CONNECTIONS]; 
9, 35, 41, 7, 54 
38 a a "7 EH int helper debugDrawOn = 0 
38, 36, 41, // 63 helper debugDrawOnCountdown - 0; 
36, y 41, // 66 
41, 40, 11, // 69 unsigned int 
41, 35, 40, // 72 helper jointsUsed = 0 
35, 8, 40, // 75 helper connectionsUsed - 0; 
40, 39, 41 yj 78 
40 34 39 81 
34! 7 39, 25 84 TPE_World tpe_world; 
$95 — 34€ — xj VI uint8 t sdl pixels[PIXELS SIZE]; 
33, 6, 37, // 93 ; P 
37, 38, 11, // 96 SDL Window *sdl window; 
37, 32, 38, // 99 SDL Renderer *sdl renderer; 
32, 10, 38, // 102 SDL Texture *sdl texture; 
23, 36, 10, // 105 SDL Surface *sdl screenSurface; 
23, 30, 36, // 108 
30, 9, 36, // 111 int helper frameStartTime; 
31, 35, 9, // 114 int helper frameMsLeft; 
31, 28, 35, // 117 int helper running; 
28, 8, 35, // 120 int helper frame; 
29, 34, 8, // 123 const uint8 t *sdl keyboard; 
29, 26, 34, 7, 126 
26 7 34 129 
7, 33! 7| 27 182 S3L Scene s3l scene; 
24 24! 33 j^ 123 S3L_Vec4 helper cameraForw, helper cameraRight, helper cameraUp; 
25, 32, 6, // 141 . i 
25, 22, 32, // 144 unsigned long helper getMicroSecs(void) 
22, 10, 32, // 147 
30, 31, 9, // 150 struct timeval t; 
30, 21, a3 // 153 gettimeofday(&t, NULL) 
21, 4, 31, // 156 return 1000000 * t.tv sec + t.tv usec; 
28, 29, 8, // 159 } 
28, 20, 29, // 162 
20, 3, 29, // 165 void helper bodyAdded(int joints, int conns, TPE Unit mass) 
26, 27, 7, // 168 { 
26, 18, 247, // 171 TPE bodyInit(&tpe bodies[tpe world.bodyCount] 
18, 2, 27, // 174 &tpe-joints[helper jointsUsed]. joints 
24, 25, 6, // 177 &tpe connections[helper connectionsUsed],conns,mass); 
24, 14, 25, // 180 
14, 4 25, // 183 helper jointsUsed += joints; 
22, 23, 10, // 186 helper connectionsUsed += conns; 
EA E: 
r r r ; 
16. 21. 5! 17 195 } tpe_world.bodyCount++; 
16, 19, 21, // 198 
19! 29 — a? MAE void helper addBox(TPE Unit w, TPE Unit h, TPE Unit d, TPE Unit jointSize 
19, 17, 29, 77, 207 asian mass) 
' ' , 
17, 18, 3, // 213 TPE makeBox( . 
17 12 18 // ?16 tpe joints + helper_jointsUsed, ; m 
12, 2, 18, // 219 tpe connections + helper connectionsUsed,w,h,d,jointSize) 
15, 16, g // 222 
15, 13, 16, // 225 .helper bodyAdded(8,16,mass); 
13, 9, 16, // 228 H 
12, 14, 2, // 231 
12, 13, 14, // 234 void helper addCenterBox(TPE Unit w, TPE Unit h, TPE Unit d, TPE Unit 
14 // 237 jointSize, TPE Unit mass 


13, 1, 
}; // sphereTriangleIndices 
TPE_makeCenterBox 


#define CYLINDER_VERTEX_COUNT 20 tpe_joints + he per_jointsused, i p 
const sL Unit cy tindervertices CYLINDER_VERTEX_COUNT * 3] tpe connections + helper connectionsUsed,w,h,d,jointSize); 
0, 256, 512, // 3 _helper_bodyAdded(9,18, mass); 
300, -256, 414, // 6 } 
486, -286, — 188 PEG 
486, 256, 158, 7/ 15 void helper add2Line(TPE Unit w, TPE Unit jointSize, TPE Unit mass) 
486, -256, -158, // 18 TPE make2Line( 
486, pe aoe. M 2 tpe joints * helper jointsUsed, . sa 
300, 256, 1414. 7 91 tpe connections + helper connectionsUsed,w, jointSize) 
" E 7235" 2 3 .helper bodyAdded(2,1,mass); 
-300, -256, -414 // 36 H 
-300, 256, -414, // 39 ; . : , 
-486, -256, -158, // 42 void helper_addTriangle(TPE_Unit s, TPE_Unit d, TPE_Unit mass) 
-486, 256, -158, // 45 
-486, -256, 158, // 48 TPE makeTriangle( . 
-486, 256, 158, // 51 tpe joints + helper_jointsUsed, 
-300, -256, 414, // 54 tpe connections + helper connectionsUsed,s,d); 
-300, | 256, 414 // 57 
3; // cylinderVertices " helper bodyAdded(3,3,mass); 
#define CYLINDER TRIANGLE COUNT 36 | 
const $3L Index sy tinder Trtang verndices| CYLINDER TREANGLESCOUNT. *3]={ void. helper_addcenterRect(TPE_Unit w, TPE_Unit d, TPE_Unit jointSize, TPE_Unit 
mass 
3, 4, 2; //3 { 
5, 6, 4, // 6 TPE_makeCenterRect ( 
7, 8, 6, // 9 tpe_joints + helper_jointsUsed, . "m 
9, 10, 8, // 12 tpe connections + helper connectionsUsed, w, d, jointSize) 
11, 12, 10, // 15 
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S3L_Vec4 a, b, c, d; 
_helper_bodyAdded(5,8,mass); 


a.x = pi.x; a.y = pi.y; a.z = p1.z; a.w = 0; 
b.x = p2.x; b.y = p2.y; b.z = p2.z; b.w = 0; 
void helper_addCenterRectFull(TPE_Unit w, TPE_Unit d, TPE_Unit jointSize, 
TPE_Unit mass) S3 L_projectapPointToscreen a,S3l scene.camera,&c 
S3L project3DPointToScreen b, s3l_scene. camera, &d 
TPE makeCenterRectFull( 
tpe joints + helper- S fointsused, f (e; x >= 0 && C.X < S3L_RESOLUTION_X && C.y >= 0 && c.y < S3L_RESOLUTION_Y 
tpe connections + helper connectionsUsed,w,d, jointSize); ee c.2 > 0 && 


me >= 0 && d.x < S3L RESOLUTION X && d.y >= 0 && d.y « S3L_RESOLUTION_Y 


; && d.z > 0) 
-helper-bodyAdded(5, 10, mass) ; helper drawLine2D(c.x,c.y,d.x,d.y,rr,gg,bb); 


void helper addRect(TPE Unit w, TPE Unit d, TPE Unit jointSize, TPE Unit mass) 


void tpe debugDrawPixel(uinti6 t x, uinti6 t y, uint8 t color) 
TPE makeRect( { 


tpe_joints + helper_jointsUsed x /= DEBUG_DRAW_DIVIDE; 
tpe connections + helper connectionsUsed, w, d, jointSize); y /- DEBUG DRAW DIVIDE; 
_helper_bodyAdded(4,6,mass); if (x < S3L RESOLUTION X - 2 && y < S3L RESOLUTION Y - 2) 


uint8 t r, g, b; 
void helper addBall(TPE Unit s, TPE Unit mass) 


tpe joints[helper jointsUsed] = TPE joint(TPE vec3(0,0,9),s); 


switch (color) 


et DIHE IS B = 289) Breaks 
cas Be = = ea 
_helper_bodyAdded(1,0,mass); ace 2: r=0; 4 g 50; b = 50; break; 
case r = 100; g = 100; b = ' 100; break; 
defaut: r=0; g=0; b=0; "break; 


void helper printCamera(void) H 


printf("camera: %ld %ld %ld (9ld *ld %1d)\n", 


s3l_Scene.camera. transform. translation.x, Top (ane E cig = Sin) 


for (int j j < 3; **j) 

S3l scene.camera.transform.translation.y rad 4 

S3l scene.camera.transform.translation.z, sd "draiixel( *iy*jrgb); 

S3l scene.camera.transform.rotation.x, ) 

Sol scene. camera transform rotation, Yn 

ene.camera.transform.ro o , 
H SVEEN CEST PENSON Berat void helper debugDraw(int drawEnv) 
void helper printCPU(void) ipe eei z . , 

: T S3l scene.camera.transform.translation.x 
uspet tf C CPU (%d FPS): %d%% loadNn",FPS,((MSPF - helper frameMsLeft) * 100) / S3l-scene.camera.transform.translation.y, 
) E s3l_scene.camera.transform.translation.z); 
void helper cameraFreeMovement (void) cc" D : 

: S3l scene.camera.transform.rotation.x 
if (sdl keyboard[SDL SCANCODE LSHIFT]) s3l_scene.camera.transform.rotation.y, 
if (sdl keyboard[SDL SCANCODE UP]) S3l scene.camera.transform.rotation. zj; 
S3L vec3Add(&s3l scene.camera.transform.translation,helper cameraForw); 
else if (sdl keyboard[SDL SCANCODE DOWN]) TPE worldDebugDraw(&tpe world,tpe debugDrawPixel,camPos,camRot, 
S3L vec3Sub(&s3l scene.camera.transform.translation,helper cameraForw); TPE vec3(S3L RESOLUTION X *'DEBUG DRÀW DIVIDE,S3L. RESOLUTION Y * 
else if (sdl keyboard[SDL SCANCODE LEFT]) DEBUG DRAW DIVIDE,s3l scene.camera.focalLength), 
S3L vec3Sub(&s3l scene.camera.transform.translation,helper cameraRight); drawEnv ? 16 : 0,drawEnv ? 256 : 0); 
else if (sdl keyboard[SDL SCANCODE RIGHT]) } 


S3L_vec3Add(&S31_scene.camera. transform. translation, helper_cameraRight) ; 2 
} uint8_t s3l_r = 0, s3l_g = 255, s3l_b = 
[er uint8 t s3l rr - 0, s3l gg - 255, s31 | Doi = 0; 


if sitse keyboard[SDL SCANCODE UP 


] E l 
e e Er che rorm FOE E CAMERA ROT. STEP; unsigned. int ssl previousTrianglelD = "18008; 


else if (sdl keyboard[SDL SCANCODE DOWN * 
83 pn opp FOr rover ton es CAMERA, ROT. STEP; S3L_Model3D * helper drawnModel; 
else if (sdl keyboard[SDL SCANCODE LEFT]) , 
S3l scene.camera.tránsform.rotation.y += CAMERA ROT STEP; TPE_Vec3 helper lightbir; 
else if (sdl keyboard[SDL SCANCODE RIGHT]) 
s3l_scene.camera.transform.rotation.y -= CAMERA ROT STEP; void s3l drawPixel(S3L PixelInfo *p) 
else if (sdl keyboard[SDL SCANCODE Q]) { 
s3l_scene.camera.transform.rotation.z += CAMERA_ROT_STEP; if (p->triangleIndex != s3l previousTriangleID) 
else if (sdl keyboard[SDL SCANCODE E]) { 
s3l_scene.camera.transform.rotation.z -= CAMERA_ROT_STEP; const S3L_Index *v = _helper_drawnModel->triangles 
} H + 3 * p->triangleIndex; 
. , ; . . . . TPE Vec3 a = TPE vec3( 
void sdl drawPixel(int x, int y, uint8 t r, uint8 t g, uint8 t b) _helper_drawnModel->vertices[(*v) * 3] 
_helper_drawnModel->vertices TOS Tj 
uint8 t *pixel = sdl pixels + (y * S3L RESOLUTION X + x) * 4 + 1; .helper drawnModel-»vertices * 3+ 215 
*pixel = b; vt++; 
pixel++; 
*pixel = g; TPE_Vec3 b = TPE_vec3( 
pixelt++; — .helper drawnModel-2vertices[(*v) * 3] 
“pixel = r; _helper_drawnModel->vertices *3 +1] 
_helper_drawnModel->vertices $c VLA f; 
void helper drawLine2D(int x1, int y1, int x2, int y2, uint8_t r, uint8_t g, v++: 
uint8_t b) r 
; TPE_Vec3 c = TPE_vec3( 
if (x1 <0 || x2 < lly2«98 || he ry ; * * 
= x x - . helper drawnModel--vertices[(*v 3] 
ura I x d Laks x X Îi yl >= RES_Y || y2 >= RES_Y) _helper_drawnModel->vertices| (* * 8 * 1] 
d _helper_drawnModel->vertices PBF. 2. j 


// stupid algorithm TPE Vec3 normal = TPE_vec3Normalized(TPE_vec3Cross( 


TPE vec3Minus(c,a),TPE vec3Minus(c,b))); 


yi; TPE Unit intensity = 190 + TPE vec3Dot(normal 
int max = (X2 * x2 > y2 * y2) ? x2 : y2; helper lightDir) / 8; 


s3l rr = (s3l_r * intensity) / 256; 
if (max « 9) s3l_ -9g = (s3l_g * intensity) / 256; 
max *= -1; s31_bb = (s3l b * intensity) / 256; 


for r gint i = 0; i < max; ++i 


tdrawPixei(x1 5 ree H R / max,y1 + (y2 * i) / max,r,g,b); } s3l_previousTriangleID = p->triangleIndex; 


7 helper drawPoint3D(TPE Vec3 p, uint8 t r, uint8 t g, uint8 t b) sdl_drawPixel(p->x,p->y, s3l_rr, s3l_gg, s31 bb); 


S3L Vec4 p2, p3; void helper set3DColor(uint8 t r, uint8 t g, uint8 t b) 


= p.X; s3lr-r; 

p2.y - p.y; s3l_g = g; 

p2.z = p.z; s3l_b = B: 

p2.w - 6; } 

A ME: s3l_scene.camera, &p3); void helper_drawModel(S3L_Model3D *model, TPE_Vec3 pos, TPE_Vec3 scale 
p3.x >= 0 && p3.x < S3L RESOLUTION X - 1 & { TORCTEEN OR) 

( n .y >= 0 && p3.y « S3L RESOLUTION Y - 1 && pa. z > 0) _helper_drawnModel = model; 


sdl drawPixel(p3.x,p3.y,r,g,b); 


sdl drawPixel(p3.x + 1,p3.y,r,g,b); S3l previousTriangleID = -1; 
sdl drawPixel(p3.x,p3. y + 1,r,9,b); 
sdl drawPixel(p3.x + 1,p3.y + 1,r,g,b); model->transform.translation.x = pos.x; 
} model->transform.translation.y = pos.y; 
} model->transform.translation.z = pos.z; 
void helper. py aot nes (TRE Vec3 pi, TPE_Vec3 p2, uint8_t rr, uint8_t gg, model->transform. = scale.x; 
uint8 - pe model->transform. = scale.y; 
model->transform. = scale.z; 
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model->transform.rotation.x = rot.x; 
model->transform.rotation.y = rot.y; 
model->transform.rotation.z = rot.z; 


S3l scene.models = model; 


#if SCALE_3D_RENDERING != 1 


S3L_Vec4 cp = s3l_scene.camera.transform.translation; 
S3L Vec4 ms = s3l_scene.models[0].transform.scale; | 
S3L_Vec4 mp = s3l scene.models[O ‘transform. translation; 


s3l_scene.camera.transform.translation.x /= SCALE_3D_RENDERING; 
s3l_scene.camera.transform.translation.y /- SCALE 3D RENDERING; 
S3l scene.camera.transform.translation.z /- SCALE 3D RENDERING; 


S3l scene.models[0].transform.scale.y /- SCALE 3D RENDERING; 


S3l scene.models[0].transform.scale.x /- SCALE 3D RENDERING; 
s3l_scene.models[0].transform.scale.z /- SCALE 3D RENDERING; 


S3l scene.models[0].transform.translation.y /- SCALE 3D RENDERING; 
S3l scene.models[0].transform.translation.z /- SCALE 3D RENDERING; 


SS seene:modets [a] transform: translation. y /- SCALE 3D RENDERING; 
#endif 

S3L drawScene(s3l scene); 
sif SCALE 3D RENDERING !- 1 


S3l scene.camera.transform.translation - cp; 
s3l_scene.models[0].transform.scale = ms; 
s3l_scene.models[0].transform.translation = mp; 


#endif 
} 


yoid helper_draw3DTriangle(TPE_Vec3 v1, TPE_Vec3 v2, TPE_Vec3 v3) 


triangleVertices[0] = v1.x; 
triangleVertices[1] = v1.y; 
triangleVertices[2] = v1.z; 
triangleVertices[3] = v2.x; 
triangleVertices[4] = v2.y; 
triangleVertices[5] = v2.z; 
triangleVertices[6] = v3.x; 
triangleVertices[7] = v3.y; 
triangleVertices[8] = v3.z; 


helper drawModel(&triangleModel,TPE vec3(0,0,0), 
TPE vec3(S3L FRACTIONS PER UNIT,S3L FRACTIONS PER UNIT,SS3L FRACTIONS PER UNIT), 


TPE_vec3(0,0,0)); 
void helper_draw3DBox(TPE_Vec3 pos, TPE_Vec3 scale, TPE_Vec3 rot) 
cubeMode | contig Dackracecu Ting 2-25 
helper drawModel(&cubeModel, pos, scale,rot); 
void helper draw3DCylinder(TPE Vec3 pos, TPE Vec3 scale, TPE Vec3 rot) 


helper drawModel(&cylinderModel,pos,scale,rot); 


void helper draw3DBoxInside(TPE Vec3 pos, TPE Vec3 scale, TPE_Vec3 rot) 
FübeMode t contig back race uring = 1; 

helper drawModel(&cubeModel, pos, scale, rot); 

void helper_draw3DPlane(TPE_Vec3 pos, TPE_Vec3 scale, TPE_Vec3 rot) 


helper drawModel(&planeModel, pos, scale, rot); 


void helper_draw3DSphere(TPE_Vec3 pos, TPE_Vec3 scale, TPE_Vec3 rot) 
sphereModel.config.backfaceCulling = 2; 
helper drawModel(&sphereModel, pos, scale, rot); 


H 
void helper draw3DSphereInside(TPE Vec3 pos, TPE Vec3 scale, TPE Vec3 rot) 


sphereModel.config.backfaceCulling - 1; 
helper drawModel(&sphereModel, pos, scale, rot); 


H 
TPE Vec3 helper heightmapPointLocation(int index) 


return TRE KEEN 
f * HEIGHTMAP 3D RESOLUTION * HEIGHTMAP 3D STEPA /2* (index 96 
HEIGHTMAP 3D RESOLUTION) * HEIGHTMAP 3D STEP + HEIGHTMAP 3D STEP / 2,0, 


f * HEIGHTMAP. 3D RESOLUTION * HEIGHTMAP 3D STEP / 2 + (index / 
HEIGHTMAP 3D RESOLUTION) * HEIGHTMAP 3D STEP + HEIGHTMAP 3D STEP / 2); 


H 
void helper_setHeightmapPoint(uint16_t x, uint16_t y, TPE Unit height) 


X 96 HEIGHTMAP 3D RESOLUTION; 
y % HEIGHTMAP 3D RESOLUTION; 


x 
y 


heightmapVertices[(y * HEIGHTMAP 3D RESOLUTION + x) * 3 + 1] = height; 


void helper init(void) 
helper lightDir = TPE vec3Normalized(TPE vec3(300,200,100)); 


sdl window = 
SDL Createwindow("program",SDL WINDOWPOS UNDEFINED, SDL WINDOWPOS UNDEFINED, S3L. 
RESOLUTION X,S3L RESOLUTION Y,SDL WINDOW SHOWN); 

sdl renderer = SDL CreateRenderer(sdl window, -1,0); 

sdl texture = 
SDL CreateTexture(sdl renderer,SDL PIXELFORMAT RGBX8888,SDL TEXTUREACCESS STATI 
C,S3L RESOLUTION X,S3L RESOLUTION Y); 

sdl screenSurface - SDL GetWindowSurface(sdl window); 


sdl keyboard - SDL GetKeyboardState(NULL); 


helper/testGeneral.c 


/** A bigger testing playground, just to see that everyhing works OK. The code 
is not very nice :) */ 


helper running - 1; 
helper frame - 0; 


helper frameMsLeft - 0; 


S3L. mode tanin tt (cubever tices, PSL CUBE. VERTEX COUNT, cubeTriangles, 
S3L CUBE TRIANGLE COUNT, &cubeModel); 


S3L model3DInit(planeVerices,4,planeTriangles,2,&planeModel); 


S3L_model3DInit (sphereVertices, SPHERE VERTEX COUNT, sphereTriangleIndices, 


SPHERE TRIANGLE COUNT, &sphereModel); 


S3L model3DInit(cylinderVertices,CYLINDER VERTEX COUNT, 
cylinderTriangleIndices,CYLINDER TRIANGLE COUNT, &cylinderModel); 


S3L model3DInit(triangleVertices,3,triangleTriangles,2,&triangleModel); 
// build the heightmap 3D model: 

for (int i = 0; i < HEIGHTMAP 3D POINTS; ++i) 

t TPE_Vec3 pos = helper_heightmapPointLocation(i); 


heightmapVertices[i * 3] = pos.x; 
heightmapVertices[i * 3 + 1] = pos.y; 
heightmapVertices[i * 3 + 2] = pos.z; 


H 
int index - 0; 


for (int j 


= 0; j < HEIGHTMAP 3D RESOLUTION - 1; ++j) 
for (int i - 


0; i < HEIGHTMAP 3D RESOLUTION - 1; ++i) 


heightmapTriangles[index] = j * HEIGHTMAP 3D RESOLUTION + i; 
heightmapTriangles[index + 1] = heightmapTriangles[index] + 1; 
gdghtmap trian es[index + 2] = heightmapTriangles[index] + 


h 
HEIGHTMAP 3D RESOLUTION; 


heightmapTriang eel ander +3 


heightmapTrian es[index + 4] 
HEIGHTMAP 3D RESOLUTION; 


2s heightmapTriang es[index +5 


heightmapTriangles[index + 1]; 
heightmapTriangles[index + 1] + 


heightmapTriangles[index + 4] - 1; 


HEIGHTMAP_3D_RESOLUTION + i; 
heightmapTriang ES indes xcd; 


heightmapTriangles[index + 1 i i 
heightmapTriangles[index + 1] + 


heightm prn tan es[index + 2] 


heightmapTriang est index: =j 
ei a 
HEIGHTMAP 3D RESOLUTION; 


Wb + 


heightmapTriang eel indes + 3] heightmapTriang ES Hadr 


heightmapīrian es[index + 4 heightmapTriangles[index + 1] + 
HEIGHTMAP 3D RESOLUTION; 

heightmapTrian es[index + 5] = heightmapTriangles[index] + 
HEIGHTMAP 3D RESOLUTION; 
* 
/ 


index += 6; 


S3L model3DInit( 
hei htmapver tices. 
HEIGHTMAP_3D_POINTS * 3, 
heightma Triangles, 
((HEIGHTMAP 3D RESOLUTION - 1) * (HEIGHTMAP 3D RESOLUTION - 1) * 2), 


&heightmapModel); 
S3L sceneInit(0,1,&s3l scene); 


TPE worldInit(&tpe world,tpe bodies,0,0); 


o helper frameStart(void) 
helper frameStartTime - SDL GetTicks(); 


for (uint32 t i = 0; i « PIXELS SIZE; ++i) 
sdl pixels[i] 0; 


S3L newFrame(); 

SDL Event event; 

WIRE (SDL PollEvent(&event)) 
event type == SDL QUIT 


N 
eve ype == SDL REY oN) && (event.key.keysym.scancode == 
SDL SCANCODE ESCAPE)) 
elper running = 0; 


S3L rotationToDirections(s3l scene.camera.transform.rotation, 
CAMERA STEP, &helper cameraForw,&helper cameraRight,&helper cameraUp); 


sdl keyboard - SDL GetKeyboardState(NULL); 


if (helper debugDrawOnCountdown -- 0 && sdl keyboard[SDL SCANCODE F1]) 


helper debugDrawOn - !helper debugDrawOn; 
helper debugDrawOnCountdown - FPS / 4; 


else if (helper debugDrawOnCountdown » 0) 
helper debugDrawOnCountdown- -; 
void helper frameEnd(void) 
.SDL UpdateTexture(sdl texture,NULL,sdl pixels,S3L RESOLUTION X * 
sizeof(uint32 t)); 
SDL RenderClear(sdl renderer); 


SDL RenderCopy(sdl renderer,sdl texture, NULL, NULL); 
SDL RenderPresent(sdl renderer); 


helper_frame++; 
helper_frameMsLeft = helper_frameStartTime + MSPF - SDL_GetTicks(); 


if (helper_frameMsLeft > 9) r 
usleep(helper_frameMsLeft * 1000); // ofc this isn't accurate 


void helper_end(void) 
// TODO 


#define CAMERA STEP 200 


#include "helper.h" 
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helper lastBody. elasticity z = Bee 


TPE_Unit helper_lastBody.friction = 
rampi[6] = 5000,0, 5000,5000, 0,0 }, helper lastBody.joints[0]. casio tryTuj-s 
rampate] = { 5000,0, 5009/1509, 010 J, helper. addBall(800,290) 
impale[6] = ( 1500,0, 0,6000, -1500,0 ); TPE bod P" 


TPE_Vec3 environmentDistance(TPE_Vec3 p, TPE Unit maxD) He TperLastBode: Jointel n] velobity[o] = «800; 
Tlast ; 


TPE ENV START( TPE_envGround(p,0 
S Poe vec3(1000, 0, 0), ramp1, 5009, 2), 


TPE_ENV_NEXT ( TPE envAATriPrism(p a p) ContruTiedBadu = eneiner 1astbod 
TPE_ENV_NEXT TPE_envAATriPrism TPE_vec3(-4000,0,0), ramp2, 3500, 2 
TPE_ENV_NEXT ( TPE_envAATriPrism P’ TPE-Vec3 -7500, 0, 0), ramp ba! 3500, 33" 5 TPE bodyMoveBy (&helper . lastBody, PE. vec3(200, 2000, -3009)); 
TPE ENV NEXT TPE envAATriPrism(p,TPE vec3(8000, 6, -2400), impale, 3500, 2 , p) a; 
} TPE_ENV_END // two colliding bodies: 
A d i helper addCenterBox(700, 700, 700, 300, 509); 
uint8 t simulating - 0; TPE bodyMoveBy(&helper . tastBody, TPE vec3(-4000, 5000, -3000) ) 
helper_lastBody.elasticity = 255; 
TPE_Body *controlledBody; helper lastBody. ETT = 255; 


//helper_ last Body . flags TPE_BODY_FLAG_SOFT; 
int main(void) TPE bodyAccelera alah iper_ lastBody,TPE vec3(- “300, 0,0)); 

h init(); helper_addCenterBox( 700, 700, 700, 300, 500); 

elper-init() TPE bodyMoveBy(&helper - ipt TPE’ vec3(-8000, 5000, -3000)); 
helper_lastBody. elasticity = 2 5; 


puts("press P to start"); helper_lastBody.friction = 
helper_lastBody.flags |= TPES eB py FLAG_SOFT; 
helper debugDrawOn = 1; TPE bodyAccelerate(&helper lastBody, TPE_vec3(300,0,0)); 
tpe world.environmentFunction - environmentDistance; while (helper running) 
S3l scene.camera.transform.translation.z - -3000; helper frameStart(); 
S3l scene.camera.transform.translation.y - 2000; 


S3l scene.camera.transform.translation.X 


helper cameraFreeMovement(); 
S3l scene.camera.transform.rotation.y = TPE FE / 16; 


if (aimilati 
define addBody if (simulating) 


N 
helper ; ESAIT E 769) 700,300,500); \ TPE worldStep(&tpe world); 
TPE bod MoveBy (&helper_ lastBody, TEE | Vec3(x,y,z)); \ 
helper lastBody.elasticity = 255; for (int i = 0; i < 12; ++i 


i) 
helper_lastBody. friction = f; TPE bodyApplyGravity(&tpe world.bodies[i],5); 
// cubes on ramps: j 


if (helper debugDrawOn) 


addBody(1800, 5200, 4000, 0) he Lper_debugDraw(1) ; 


addBody( 400, 5200, 4000, 128) 


addBody( -1100, 5200, 4000, 511 
addBody( -2800, 3600, 4000, 300 if (Sdl-keyboard[SDL.SCANCODE.P]) 
addBody -4300, 3600, 4000, 10) g= 
B -6700, 2000, 4000, 300 
addBody -8400, 2000, 4000, 305) TPE_bodyMultiplyNetSpeed(controlledBody, 255) ; 
addBody(7500, 6200, -2400,10) // impaled cube IP TI at Keyboard [SDL SEANCODE E 
TPE bodyAccelerate(controlledBody,TPE vec3(0,0,ACC)); 
He riper addons (700788, 290 500); ^ else if (Sdl keyboard[SDL. SCANCODE 5] , 4 
p e ( 1 t TPE bodyAccelerate(ControlledBody, TPE_vec3(0,0,-1 * ACC)) 
TPE =bodyMoveBy &helper_las Body) TPE_ vec3(x,y,z)); \ else if (sdl_keyboard[SDL_SCANCODE 2 
helper. lastBody.elasticity = e; TPE bodyAccelerate(controlledBody, TPE_vec3(ACC, 0,0) ) 
í 3 else if (sdl keyboard[SDL SCANCODE A 
// falling bodies TPE bodyAccelerate(controlledBody,TPE vec3(-1 * ACC,0,0)) 
else if (sdl keyboard[SDL SCANCODE CR 
addBody (7000, 5000, 0,511 TPE_bodyAccelerate(controlledBody, TPE vec3(0,ACC,0)) 
addBody 8800, 5000, 9, 255 else if (sdl keyboard[SDL SCANCODE Jd 
addBody 10600, 5000, 0,0) aud IAE bo yAccelerate(controlledBody, TPE vec3(0,-1 * ACC,0)) 
unde 


helper_addBox(5000, 5000, 5000, 2000, 2000); // big box 
TPE . bodyMoveBy(&he tper_ lastBody TPE Yeb (20000, 20990 , 8000) ); } helper frameEnd(); 


TPE bodySpin(&helper lastBody, | vec3(1 200, -20 
// two colliding spheres: helper end(); 
helper addBall(800 2000); return 0; 
TPE_bodyMoveBy &helper astBody, TPE vec3(200, 4000, -4800)); 
programs/stack.c 
/** Program that drops many bodies so that they stack onto each other to test TPE_bodyMoveR y{gtpew world. bod ges CERF wor td. bodyCount - 1], TPE vec3((1 
this Kind of behavior as well as a performance during it, also applies some 96 4)) 1200,8000, Ti / 4)) * 1206)) 
basic smoothing of movement and rotation. */ } 
//#define FPS 10 while (helper_running) 
#include "helper.h" helper_frameStart(); 
[Eus environmentDistance(TPE Vec3 p, TPE Unit maxD) helper cameraFreeMovement(); 
E 155-EW- | START( TPE envHalfPlane(p, TPE. vec3(0,0,0), TPE vec3(TPE F / 2,TPE F / ir (helper_frame % 16 == 0) 
p 
> TRE ENV N NEXT ( + TPB Repyya fo Lane (p, TPE- vec3(0,0,0), TPE vec3(-1 * TPE F / printf("frame 9&d:Nn",helper frame); 
, e 
TPE ENV N PPE envHalfP lane , TPE_vec3(0,0,0), TPE vec3(-1 * TPE F / i 
2, FPEF Ba T 5-ggylaly (p ( ) (s helper printCPU() 
} TPE_ENV_END if (sdl keyboard[SDL. SCANCODE.L]) 
for (int i = 0; i < tpe world.bodyCount; ++i) 
unsigned long timeMeasure = 0; TPE bodyActivate(&tpe world.bodies[i]); 
TPE ..bodyAcce lerate(&tp pe world. bodies ij, 


TPE_Vec3 bodyPositions[16]; 


TPE_vec3(0, (500 
TPE Vec3 bodyOrientations|16]; 


30) / FPS,0)); 


// tries to smooth orientation by averaging it over 2 frames printf("world u date (us): %lu\n",timeMeasure / 16); 
TPE Unit updateOrientation(TPE Unit new, TPE Unit 514) printf("hash: %Lu\n", TPE. “wor tdHash(&tpe | world)); 
return TPE abs(new - old) < 20 ? (new + old) / 2 : new; timeMeasure - 0; 
H 
int main(void) unsigned long ti - helper getMicroSecs(); 
helper init(); TPE worldStep(&tpe world); 


tpe world.environmentFunction = environmentDistance; timeMeasure += helper getMicroSecs() - t1; 
- zy ; 


s3l_scene.camera.transform.translation.y 
s3l_scene.camera. transform. translation.z 
s3l_scene.camera.transform.rotation.x = - 


$5000; for (int i = 0; i < tpe world.bodyCount; ++i) 


9; TPE bodyApplyGravity(&tpe world.bodies[i],(5 * 30) / FPS); 


Nut 


for (int i = 0; i < 16; ++i) TPE_Joint *joints = tpe_world.bodies[i].joints; 
switch (i % 5) TPE_Vec3 pos = TPE bodyGetCenterOfMass(&tpe ! world. bodies[i]); 
TPE Vec3 right = TPE_vec3(512,0,0); 
TPE_Vec3 forw = TPE_vec3(0,0,512); 


case 0: helper_addBox(800, 800, 800, 400,700); break; 

case 1: helper_ addTriangle(1160, 200, 600); break; P A A i 

case 2: helper addBall(500, 700); break: if (196 5 != 2 && i 9$ 5 != 1) // don't mind the ugly code 
case 2: helper addRect 800, 800, 400, 809); break; 


case helper_add2Line(900, 200,600); break; if (i965 != 4) 


Gafautt: break; 
} forw = TPE_vec3Minus( eints[2]; position, Joints [ol position); 
right = TPE eset Eri J; position, joints[ ]. position]; 
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else 
forw = TPE_vec3Minus(joints[1].position, joints[0].position); 


TPE_Vec3 orient = TPE_rotationFromVecs(forw, right); 
helper set3DColor(100 + i * 5,16 - i,100 - i * 5); 


// this smoothes the movement a bit: 
Searle i] = TPE vec3KeepWithinBox(bodyPositions[i], 
E bodyGetCenterOfMass(&tpe world.bodies[1]),TPE vec3 50, 20,20)); 


bodyOrientations[i].x = 
updateOrientation(orient.x, bodyorientations[i]. x); 

bodyOrientations[i].y = 
updateOrientation(orient. y, bodyOrientations[i]. y) 

bodyOrientations[i].z 
updateOrientation(orient.z, bodyOrientations[i]. z); 


switch (i % 5) 


case 0: 
Lo ACLARA LAM CS MC ee ay 
; break; 


1: 
helper_ _drawSDTriangle(bodyPositions[i], joints[4]. position, joints[2].position); 
reak; 


case 2: 
helper drawsDsphere(bodyPositions[1], TPE_vec3(500, 500, 599), bodyOr ientations[1]) 
; break; 


programs/2d.c 


/** Demo showing how 2D physics can be implemented. */ 
#define DEBUG DRAW DIVIDE 8 
#include "helper.h" 


#define ROOM W (TPE F * 19) 
#define ROOM_H ((RES Y * RÓOM W) / RES X) 


TPE Vec3 environmentDistance(TPE Vec3 p, TPE Unit maxD) 
return TPE envAABoxInside(p, TPE vec3(0,0,0), TPE_vec3(ROOM_W, ROOM_H, ROOM W)); 


int inactiveCount - 0; 
int main(void) 
helper init(); 
tpe world.environmentFunction - environmentDistance; 
S3l scene.camera.transform.translation.z -- ROOM W / 2; 
s3l_scene.camera.focalLength = 0; // set orthographic projection 


for (int i = 0; i < 4; ++i) // add bodies 


if (i != 2) 


helper addCenterRectFull(TPE F,TPE F,TPE F / 5,TPE F / 5); 
TPE -DoGVROFAtEByAK1s(ahe. per. lastBody, TPE vec3(TPE_ F/ 3) 6, 0)); 
helper lastBody.joints[4].sizeDivided *- 3; // make center point bigger 


else 

helper addBall(6 * TPE F / 5,TPE F / 5); 
helper lastBody.friction - 4 * TPEF / 5; 
helper lastBody.elasticity = TPE F / 5; 


} TPE bodyMoveBy(&helper lastBody,TPE vec3(-2 * TPEF + i * 2 * TPE_F,0,0)); 


while (helper_running) 


helper_frameStart(); 


#define ACCELERATION TILES / 25) 
if_(sdl_keyboard[SDL_SCANCODE_LEFT] ) 
TPE_bodyAccelerate(&tpe_world.bodies g PEVega( d * ACCELERATION, 0,0)); 
else if (sdl keyboard[SDL SCANCODE RIG| ¢ 
TPE bodyAccelerate(&tpe world.bodies[O DARIN DE TIN NUM 


programs/car.c 


#define S3L NEAR CROSS STRATEGY 2 
#define S3L PERSPECTIVE CORRECTION 2 


#include "helper.h" 
#include "carArenaModel.h" 
#include "carModel.h" 


#define ACCELERATION (TPE_F / 14 
#define TURN_RATE (3 TPE_F / 4 
#define TURN_ FRICTION ü * TPE- F 


/ 4) // wheel side friction 
#define FORW FRICTION (TPE F / 14) 


// wheel forward friction 
TPE Unit rampPoits[6] = ( 0,0, 


-2400,1400, -2400,0 ); 


TPE Vec3 environmentDistance(TPE Vec3 p, TPE Unit maxD) 


TPE ENV START( TPE envGround(p,O pl 
TPE ENV NEXT( TPE saher rep, PE_vec3(0,10000,0),20000),p ) 
TPE ENV NEXT(, TPE envAABOX Pathe vec3(- 8700, 100, - 

800), TPE_Vec3(2200,1000,800)),p ) 
TPE_ENV_NEXT TPE envAATr Prism 
TPE ENV NEXT TPE-envsphere(p, TPE 
TPE ENV END 


P TPE VeC3(8709, 0, 9 ramppoits, 5000, 2),p ) 
'vec3(0, 3100.0) 9j EU 


uint8 t steering - 0; // 0: none, 1: right, 2: left 

uint8 t jointCollisions; /* bit mask of ecottiding joints (i.e. 
currently touching the ground). * 

uint8 t jointCollisionsPrev; // for averaging 


wheels that are 


TPE Body *carBody; 
TPE Vec3 carForw, carSide, carUp, carPos, carRot; 


uint8 t collisionCallback(uinti16 t bi, uinti6 t ji, uint16 t b2, uinti16 t j2, 
TPE Vec3 p) 


case 3: 
[oc ade Da MM M oe grees 
rea 


berber- - dE as SDBox (bodyPositions[i], TPE_vec3(200, 200, 1200), bodyOrientations[i]); 
default: break; 
} H 
helper . setaDColor (190, 100,100); 


he per- -grano niang Stm E yecs( 0, 0,0), TPE vec3(-5000, 5000, - 
100005, PE_vec3(-5000, 5000, 10000 
helper_set3DColor(140, 140, 140); 
he Ber draw3DTriangle(TPE vec 
5000, 5000, 10000), TPE véc3(5000, 500 

helper set30Color(80, 80, 80); 

he er -drawa triangle (ThE vec3(0, 0,0), TPE_vec3(-5000, 5000, - 
100005, PE_vec3(5000,5 8)); 


(959; o 9)» TPE vec3(- 


if (helper debugDrawOn) 
helper debugDraw(1) 


} helper frameEnd(); 


helper end(); 


return 0; 


if (sdl keyboard[SDL SCANCODE SUP) 
TPE bodyAccelerate(&tpe world.bodies[0], TPE vec3(0, ACCELERATION, 0)); 
#undef ACCELERATION 


TPE worldStep(&tpe world); 


for (int i = 0; i < tpe world.bodyCount; ++i) 
TPE bodyApplyGravity(&tpe world.bodies[i],TPE F / 100); 


/* Here we implement our own improvement of deactivation; after some time 


of 
all bodies having low speed we disable them all at once. */ 
TPE Unit speed, speedMax - 0; 
int anyActive - 0; 
for (int i = 0; i < tpe world.bodyCount; ++i) 
// as we're in 2D we'll Keep all joint Z positions and velocities at 0 
for (int j = 0; j « tpe world.bodies[i].jointCount; ++j) 
tpe world.bodies[i].joints[j].position.z = 0; 
tpe world.bodies[i].joints[j ‘Velocity{2] = = 6; 
if (L (tpe world. bodies[i].flags & TPE BODY FLAG DEACTIVATED)) 
anyActive - 1; 
speed - TPE bodyGetAverageSpeed(&tpe world.bodies[i]); 
if (speed » speedMax) 
speedMax = speed; 
if Vana AVE && speedMax « TPE F / 10) 
inactiveCount++; 
else 
inactiveCount = 0; 
if (inactiveCount > 100) 
TPE wor LdDeactivateAll(&tpe i world); 
inactiveCount - 0; 
helper debugDraw(0) 
} helper frameEnd(); 


helper end(); 


return 0; 


// here we record which wheels (joints) are currently touching the ground 


if (bi == 1 && bi == b2 && j1 < 4) 
jointCollisions |= 0x01 << j1; 


return 1; 


H 
int main(void) 


arenaModelInit(); 
carModelInit(); 


helper init(); 
carPos = TPE_vec3(0,0,0); 


tpe world.environmentFunction = environmentDistance; 
tpe world.collisionCallback - collisionCallback; 


// add an interactive body: 


helper addRect(6 * TPE F / 5,6 * TPE_F / 5,6 * TPE_F / 5,TPE_F / 2); 
TPE bodyMoveBy(&helper . lastBody TPE gvee3 (2060, 1000, , 3000) ); 
helper_lastBody.friction = E, 


// create the car body, start with a "center rect": 
helper addCenterRectFull(1000, 1800, 400, 2000); 


carBody - &helper lastBody; 

// scale and shart the middle joint a bit 
carBody->joints[4].position.y += 600; 
carBody->joints[4].sizeDivided *= 3; 
carBody->joints[4].sizeDivided /= 2: 
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// we need to reinit the body so that it recomputes its connection lengths 
TPE bodyInit(carBody,carBody-»joints,carBody-»jointCount,carBody- 
>connections, 


carBody->connectionCount, TPE_F / 2); 


TPE_bodyMoveBy(carBody, TPE_vec3(6 * TPE F,2 * TPE F,0)); 
carBody->elasticity = TPE F / 100; 

carBody->friction = FORW FRICTION; 

carBody->flags |= TPE BODY FLAG ALWAYS ACTIVE; 


S3l scene.camera.transform.rotation.x - -35; 


while (helper running) 
helper frameStart(); 


jointCollisions - 0; 


if (sdl keyboard[SDL SCANCODE RIGHT]) 
steering - 1; 

else if (Sdl kéyboard[SDL SCANCODE LEFT]) 
steering - 2; 

else 
steering - 0; 


TPE worldStep(&tpe world); 
// get and smooth the car position: 


carPos = TPE_vec3KeepWithinBox(carPos, carBody->joints[4].position, 
TPE vec3(TPE F / 50,TPE F / 50,TPE F / 50)); 


// compute the car direction vectors from positions of its joints: 


carForw = TPE vec3Normalized(TPE vec3Plus( 
TPE_vec3Minus(carBody->joints[2].position, carBody->joints[0].position 
TPE_vec3Minus(carBody->joints[3].position, carBody->joints[1].position J); 


carSide = TPE vec3Normalized(TPE vec3Plus( 
TPE_vec3Minus(carBody->joints[1].position, carBody->joints[0].position 
TPE_vec3Minus(carBody->joints[3].position, carBody->joints[2].position 5); 


carUp = TPE_vec3Cross(carForw, carSide) ; 


/* now we'll check each joint separately and if it is touching the ground, 
: .we apply directional friction (friction that's dependent on the 
direction 
of the wheel which e.g. allows turning); TPE has only non-directional 
friction programmed in so we do it ourselves */ 
for (int i = 0; i < 4; ++i) 
if (jointcollisions & (0x01 «« i)) // wheel touches the ground? 


TPE Vec3 jv = TPE vec3( // joint velocity 
carBody-»joints[i].velocity[6 
carBody-»joints[i].velocity 1 j 

i 


carBody->Joints[i].velocity 
TPE_Vec3 ja = carSide; // wheel axis of rotation 
if (i >= 2 && steering) 
í // for front wheels with turning we tilt the wheel axis 45 degrees 


if (steering == 2) i 

123 = TPE vec3Plus(TPE vecS3Times(carForw, TURN_RATE),carSide) ; 
else 

ja = TPE_vec3Minus(TPE_vec3Times(carForw, TURN_RATE),carSide); 


ja = TPE vec3Normalized(ja); 


} 


/* friction is in the direction if the axis and its magnitude is 
determined by the dot product (angle) of the axis an Nenccary ay: 
TPE_Vecs ies = TPE_vec3Times(ja, (TPE_vec3Dot(ja,jv) * TURN_FRICTION) 
TPE_F); 


jv = TPE_vec3Minus(jv,fric); // subtract the friction 


carBody->joints[i].velocity[0] = jv.x; 
carBody->joints[i].velocity[1] = jv.y; 
carBody->joints[i].velocity[2] = jv.z; 


} 


if (TPE vec3Dot(carUp, TPE_vec3Minus(carBody->joints[4].position, 
carBody->joints[0].position)) < 0) 


/* if the car falls on its roof the center joint may flip to the other 
side, here we fix it */ 


puts("car geometry flipped over, fixing..."); 


programs/heightmap.c 


/** Demo showing the heightmap environment. */ 


#define CAMERA_STEP 200 

#define HEIGHTMAP_3D_RESOLUTION 32 

#define HEIGHTMAP 3D STEP (TPE F * 2) 

#define MAP LIMIT ((HEIGHTMAP 3D RESOLUTION * HEIGHTMAP 3D STEP) / 2) 


#include "helper.h" 


/** For given heightmap node at [x,y] returns its height. Here the function 
uses 


sines/cosines to generate a simple procedural heightmap but it could also 
retrieve the heig t e.g. from an image. */ 
ee height(int32_t x, int32_t y) 


x * 

y* 
return . 1 

2); TPE sin(x + TPE cos(y * 2)) * TPE sin(y * 2 + TPE cos(x * 4)) / (TPE F / 
i 

H 

TPE Vec3 environmentDistance(TPE Vec3 p, TPE Unit maxD) 


return TPE_envHeightmap(p, TPE_vec3(0,0,0),HEIGHTMAP_3D_STEP, height, maxD) ; 


int main(void) 
helper_init(); 


helper debugDrawOn = 0; 


carBody->joints[4].position = TPE vec3Plus(TPE vec3Times(carUp, 300), 
carBody-»joints[0].position); 


for (int i = 0; i < tpe world.bodyCount; ++i) 
TPE bodyApplyGravity(&tpe world.bodies[i],5); 


if ((jointCollisions 


jointCollisionsPrev) & 0x03) // back wheels on 
ground? 


í ir (sdl_keyboard[SDL_SCANCODE_UP] ) 


carBody->joints[0].velocity[0] += (carForw.x * ACCELERATION) / TPE F; 
carBody->joints[0].velocity[1] += (carForw.y * ACCELERATION) / TPE F; 
carBody-»joints[O].velocity[2] += (carForw.z * ACCELERATION) / TPE F; 
carBody->joints[1].velocity[0] += (carForw.x * ACCELERATION) / TPE F; 
carBody->joints[1].velocity[1] += (carForw.y * ACCELERATION) / TPE F; 
} carBody->joints[1].velocity[2] += (carForw.z * ACCELERATION) / TPE F; 
eet if (sdl keyboard[SDL SCANCODE DOWN]) 
carBody->joints[0].velocity[0] carForw.x * ACCELERATION) / TPE_F; 
carBody->joints[0].velocity[1] carForw.y * ACCELERATION) / TPE. 
carBody-»joints[0].velocity[2] carForw.z * ACCELERATION) / TPE F; 
carBody-»joints[1].velocity[0] carForw.x * ACCELERATION) / TPE F; 
carBody-»joints[1].velocity[1] carForw.y * ACCELERATION) / TPE F; 
} carBody->jJoints[1].velocity[2] -= (carForw.z * ACCELERATION) / TPE F; 
3 
jointCollisionsPrev = jointCollisions; 


carRot = TPE_bodyGetRotation(carBody,0,2,1); 
// draw: 
helper_set3DColor (20,150,150); 


per_drawModel(&arenaModel, TPE_vec3(0,0,0), TPE_vec3(512 * 32,512 * 32,512 
TPE_vec3(0,0,0)); 


he 
* 32), 
helper_set3DColor (20,50, 250); 


he per_drawsDBox TPE_bodyGetCenterOfMass(&tpe_world.bodies[0]), 
TPE_vec3(1000, 00,1090), TPE bodyGetRotation(&tpe world bodies [0], 0, 2,1)); 


S3L zBufferClear(); 
helper. set3DColor(2900, 200, 200); 


helper drawModel(&carModel,TPE vec3Minus(carPos,TPE vec3Times(carUp, 409)), 
TPE_vec3(600, 600, 600), carRot); 


if (helper debugDrawOn) 
helper debugDraw(1) 


// handle camera: 
S3l scene.camera.transform.translation.y = carPos.y + 800; 


TPE Vec3 cPos - TPE vec3KeepWithinDistanceBand( 
TPE vec3( 
S3l scene.camera.transform.translation.x 
S3l scene.camera.transform.translation.y, 
s3l scene.camera.transform.translation.z 
), carBody->joints[4].position,4 * TPE F,6 * TPE F); 


s3l_scene.camera.transform.translation.x = cPos.x; 
s3l_scene.camera.transform.translation.y = cPos.y; 
S3l scene.camera.transform.translation.z = cPos.z; 


S3L_Vec4 toCar; 


toCar.x = carPos.x - s3l scene.camera.transform.translation.x; 
toCar.y = carPos.y - s3l scene.camera.transform.translation.y; 
toCar.z = carPos.z - s3l scene.camera.transform.translation.z; 
toCar.w = 0; 


TPE_Unit anglepift = s3l_scene.camera.transform.rotation.y - 
(TPE_vec2Angle(toCar.x,toCar.z) - 128); 


s3l_scene.camera.transform.rotation.y - 


(angleDiff < 100 && angleDiff > -100) ? angleDiff / 2 : angleDiff; 


helper frameEnd(); 


helper end(); 


return 0; 


// here we just set up the graphical 3D model of the heigtmap: 


for (int y = 0; y « HEIGHTMAP 3D RESOLUTION; ++y) 
for (int x = 0; x « HEIGHTMAP. 3D RESOLUTIÓN; FFX) 
he pgr-setheight apPoint(x,y,height(x - HEIGHTMAP 3D RESOLUTION / 2,y - 
HEIGHTMAP 3D RESOLUTION / 2)); 


tpe world.environmentFunction - environmentDistance; 
helper addBox(700, 700, 700, 300, 1000) ; 
TPE_bodyMoveTo(&helper_lastBody, TPE_vec3(0,5000,0)); 
s3l_scene.camera.transform.rotation.x = -1 * TPE_F / 8; 


while (helper_running) 
helper_frameStart(); 
TPE Vec3 bodyCenter = TPE bodyGetCenterOfMass(&tpe world.bodies[0]); 
s3l scene.camera.transform.translation.x 


S3l scene.camera.transform.translation.y 
s3l scene.camera.transform.translation.z 


bodyCenter.x; 
bodyCenter.y + 3000; 
bodyCenter.z - 3000; 


if (bodycenrer x < -1 * MAP LIMIT) 

TPE bodyMoveBy(&tpe world.bodies[0], TPE vec3(2 * MAP LIMIT, TPE F,98)); 
else if ( odyCenter.x » MAP LIMIT) 

TPE bodyMoveBy(&tpe world.bodies[0], TPE vec3(-2 * MAP LIMIT, TPE F,0)); 


if (bodyCenter.z « -1 * MAP LIMIT) 
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TPE DO Nep) (ened world.bodies[0], TPE vec3(0,TPE F,2 * MAP LIMIT)); if (sdl keyboard[SDL SCANCODE SUP) 
else if odyCenter.z » MAP LIMIT) TPE bodyAccelerate(&tpe world nt , TPE. vec3(0, 0, ACC) ) 
TPE bo yMoVeBy (&tpe.- world.bodies[0], TPE vec3(0, TPE F,-2 * MAP LIMIT)); else if (Sdl keyboard[SDbL SCANCODE DOW 
TPE bodyAccelerate(&tpe world. bodses[o ,TPE vec3(0,0,-1 * ACC)); 
if (helper frame % 32 == 0) 
helper printCPU(); if (ds keyboard[SDL_SCANCODE_LEFT] ) 
M E Sr CRAT LE DOS &tpe world.bodies[0], TPE vec3(-1 * ACC,0,0)); 
else i E eyboard[SDL SCANCODE RIGHT 
helper- sar autiode t{eneagntnagns aces E M. tpe_wor Ld. bodies[0], TPE. vec3(ACC, 6,0) ) 


helper drauuode li 


p del,TPE yess (- HETGHTMAP 5 3D STEP / 2,0, - TPE bo 
HEIGHTMAP 3D STEP P 


), SPE vee (512,512,512), TPE_vec3(0,0,0)); 
if (helper debugDrawOn) 


helper set3DColor(100, 100,200); helper debugDraw(1); 
helper —draw3DBox(bodyCenter,TPÉ vec3(2 * TPE F,2 * ,TPE F,2 * TPE F), #undef ACC 
E bodyGetRotation(&tpe | world. bodies[0],9, 1, 2 


helper frameEnd(); 
for (int i = 0; i < tpe world.bodyCount; ++i) 
TPE bodyApplyGravity(&tpe world.bodies[i],7); 
helper end(); 
TPE worldStep(&tpe world); 


return 0; 
#define ACC (TPE F / 50) 
programs/players.c 
/** pemo showing a simple first person movement. */ also 


additionally check directly below */ 


#define S3L NEAR CROSS STRATEGY 2 . 
#define S3L PERSPECTIVE CORRECTION 2 onGround - TPE DISTANCE( playerBody- joints[o |: - position 


TPE “castenvironmentRay layer Body -»joints[0 position, 
#include "helper.h" TPE vec3(0,-1 * » tpe. wort .environmentFunction 
sinclude "levelModel.h" n 128,512,512)) <= groundDist; 


TPE_Unit piu eighty 


TPE_Unit ramped = 1600 ,0, -500,1400, -700, od c EyevatorHeight = (1250 * (TPE_sin(helper_frame * 4) + TPE_F)) / (2 * 
TPE_Unit ramp2[6] = G 2000, -5000, 1500, 1700, -5060, -500 }; F); 
i i i s3l_scene.camera.transform.translation.x = playerBody- 

TPE Vec3 environmentDistance(TPE Vec3 p, TPE Unit maxD) »joints[0] position x; ; ptay y 

// manually created environment to match the 3D model of it set gene. camera. transform.translation.z - playerBody- 

TPE ENV START ( TPE SRYAABoXTnside( TPE_vec3(0, 2450, - >joints[0].position.z; 
2100), TPE_vec3(12600, 5000, 10800 ) p s3l_scene.camera.transform.translation.y = TPE keepInRange( 

TPE ENV NEXT( TPE -envAABox (p ae Peca- 5693,0, - s3l_scene. camera. transtorm.Franstationcyy 
6580), TPE vec3(4307, 20000, 3420) ), p 


playerBody- zomat lbosrtion yy 
TPE_ENV NEXTÉ TPE enyabbox(p TEE ees 10009, -1000, - playerBody->joints[1].position.y + 10) 
10000), TPE vec3(11085, 2500,9295)),p ) 
TPE ENV NEXT( TPE envAATriPrism( TPE vec3(-5400,0,0), ramp, 3000, Pl p) TPE bodyMultiplyNetSpeed(&tpe world.bodies[0],onGround ? 300 : 505); 
TPE_ENV_NEXT( TPE envAATriPrism(p, TPE vec3(2076, 651, 265809! ramp2,3000,0), p) 


TPE ENV NEXT(. TPE envAABOX TEEF vec3(7000, 0, - i = -1* i 
8500) TELS 55 (2405; 2000, Bo os Te ( S3l scene.camera.transform.rotation.y 1 * playerRotation; 


TPE ENV NEXT( TPE envSphere(p S vec3(2521, -100, -3799) // fake the s P 
phere rotation (since a single joint doesn't rotate itself): 
mis FNY- NENÍ TPE envAABox (p, TPE- -18581329 309 selevatorieight, TPE_Vec3 ballRoll = TPE BInreTeL pecition dag) PNTOUSPOS, 


TPE ENV NEXT( TPE envHalfPlane(p, TPE_ Re dae: 0,1802), TPE. vec3(-255,0, - tpe. wor ld. bodies[1]. joints[6].position,i 


1200),p ) 


255 
Dp) ballRot - TPE rotationRotateByAxis(ballRot,ballRoll) 
TPE ENV NEXT( TPE envInfiniteCylinder(p, TPE vec3(320,0,170),TPE vec3(0,255,0),5 
30),p ) ballPreviousPos = tpe world.bodies[1].joints[0].position; 
TPE ENV END 
fore int i= 0; tpe world.bodyCount; B3 
. i a rapp iveravi t atoe. world" bodies[i], )5? 
int jumpCountdown = 0, onGround = 0; 
TPE_Unit playerRotation = 0, Jroundbist; if (onGround) 
TPE_Vec3 ballRot, ballPreviousPos, playerDirectionvec; 
TPE_Body *playerBody = if (sdl keyboard[SDL SCANCODE SPACE] && jumpCountdown == 0) 
void updateDirection(void) // updates player direction vector playerBody->joints[0].velocity[1] = 90; 


jumpCountdown = 8; 
playerDirectionVec.x LE í 


TPE_sin(playerRotation); 
playerDirectionVec.z 


TPE cos(playerRotation); 


playerDirectionVec.y = 0; #define | D 15 // just some vector divisor to make the speed slower 
f (sdl keyboard[SDL SCANCODE UP] || sdl_keyboard[SDL_SCANCODE_Ww] ) 
int main(void) playerBody-»joints[0].velocity[0] += playerDirectionVec.x / D; 
{ playerBody->joints[0].velocity[2] += playerDirectionVec.z / D; 


helper_init() } 
TevelModelinit(); else if (sdl_keyboard[SDL_SCANCODE_DOWN] || sdl keyboard[SDL SCANCODE S]) 
updateDirection(); t 
playerBody->joint sfe]: .velocity[0] -= playerDirectionVec.x / D; 
ballRot = TPE_vec3(0,0,0); playerBody->joints velocity[2] -= playerDirectionVec.z / D; 


tpe_world.environmentFunction = environmentDistance; if (sdl keyboard[SDL. SCANCODE. A] ) 
i G — = 


/* normally player bodies are approximated with capsules -- since we don't 
have these, l use a pees consisting of two spheres: */ B 


ayerBody->joint aleve ocity[2] += playerDirectionVec.x / 
he Lper_add2Line(400, 300, 400); / 


} ayerBody->joints[0].velocity[0] -= playerDirectionVec.z 

playerBody = &(tpe world.bodies[0]); iat if (sdl keyboard[SDL SCANCODE D]) 
playerBody->joints[0].velocity[2] -= playerDirectionVec.x / D; 

TPE -bodyMoveBy (at pe world. wor td bodi TPE e oS 3 (41000, 1000, 28000), playerBody->joints[0].velocity[0] += playerDirectionVec.z / D; 

TPE_bodyRotate yards (atpe world. bodies[0], TPE_vec3(0,0, TPE / 4)); } 

playerBody->e asticity = = #undef D 

blavyerBody- >friction = 0; } 

playerBody->f lags = TPE BODY_FLAG_NONROTATING; // make it always upright 

playerBody->flags |= TPE_BODY_FLAG_ALWAYS ACTIVE; updateDirection(); 

groundDist = TPEÉ JOINT SIZE(playerBody- »joints[0|) * 30; 


if (sdl _keyboard[ Sol SCANCODE LEFT]) 
// add two interactive bodies: playerRotation -- 
else if (sdl_ keyboard (Sor SCANCODE RIGHT]) 


helper addBal ae 100 playerRotation += 8; 


TPE bodyMoveBy(&tpe wre: pep TPE_vec3(-1000,1000,0)); 
tpe_wor ld. bodies .elast icity = 

tpe world.bodies friction - 100; 

ballPreviousPos - SL inde duisi ascent helper printCPU(); 
helper printCamera(); 


if (helper frame % 64 == 0) 


helper_addCenterRect (600, 600, 400,50); 

TPE_bod d'bodies T. world. bodties[2] f TPE _vec3(-3000, 1000, 2000) ); 
tpe_wor ld. bodies -elasticity = 

tpe_world.bodies 


// draw the 3D environment 
. friction = 50; 


white (helper. running) helper_set3DColor (200, 200, 200); 


helper_frameStart(); helper- essa ve lMode l; TPE vec3(0,0,0), TPE vec3(600, 600, 600), 


E vec3(0,0 


TPE worldStep(&tpe world); helper. draw3DBox(TPE. vec3(5300, elevatorHeight, -4400), 


* A 
if (jumpCountdown > 0) TPE vec3(2000,2 elevatorHeight, 2000), TPE_vec3(0,0,0)); 


jumpCountdown- - ; helper_set3DColor (200, 50,0); 
TPE_Vec3 groundPoint = he 
per draw3DBox(TPE bodyGetCenterOfMass(&tpe world.bodies[2]), 
environmentDistance(playerBody-»joints[0].position,groundDist); TPE vec3(1200,800,1200), TPE. bodyGetRotation(&tpe world. bodies[2], 0,2,1)); 


onGround = (playerBody->flags & TPE_BODY_FLAG_DEACTIVATED) || 
(TPE | DISTANCE (player Body. zjeints[e]. position,groundPoint 
<= groundDist && groundPoint.y < playerBody- 5joints[0]. position.y - 


helper- dca (100b. 1900 169 world. bodies[1]. joints[0].position, 
groundDiSt /2); 


E vec3(1000, 1000, 1980) , ballRot); 


if (helper debugDrawOn) 


if (!onGround) helper debugDraw(1) 


/* it's possible that the closest point is e.g. was a perpend wall so helper frameEnd(); 
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} 


return 0; 
helper end(); 


programs/water.c 


#define CAMERA STEP (TPE / 2) 
SOS Une BALL SIZE (5 PEE E) 4) TPE worldInit(&tpe world,bodies,2,environmentDistance); 


#define HEIGHTMAP. 3D RESOLUTION 8 daa (helper-running) 


#define HEIGHTMAP 3D STEP (TPE F * 2) helper. frameStart() 
#include "helper.h" helper cameraFreeMovement(); 
#define ROOM SIZE (HEIGHTMAP 3D RESOLUTION * HEIGHTMAP 3D STEP + JOINT SIZE) // update the 3D model vertex positions: 
TPE_Vec3 environmentDistance(TPE Vec3 p, TPE Unit maxD) S3L Unit *v - heightmapVertices; 

return : PE E cz 2 : 
TPE envAABoxInside(p,TPE vec3(0,0,0), TPE vec3(ROOM SIZE,ROOM SIZE,ROOM SIZE)); for (int i = 8; i < WATER JOINTS; ++i) 
J 


- joints[i].position.x; 


#define WATER JOINTS (HEIGHTMAP 3D RESOLUTION * HEIGHTMAP 3D RESOLUTION) 
#define WATER CONNECTIONS (2 * ((HEIGHTMAP 3D RESOLUTION - 1) * 
HEIGHTMAP 3D RESOLUTION)) 


joints[i].position.y; 


£ joints[i].position.z; 


TPE_Joint joints[WATER_JOINTS + 1]; } 
TPE Connection connections[WATER CONNECTIONS]; 
TPE Body bodies[2]; // pin the joints at the edges of the grid: 
int main(void) for (int index = 0; index « WATER JOINTS; ++index) 
{ "n if (index % HEIGHTMAP 3D RESOLUTION == 0 m index % 
helper init(); HEIGHTMAP 3D RESOLUTION -- HEIGHTMAP 3D RESOLUTION - 1 | 
index / HEIGHTMAP 3D RESOLUTION -- || index / HEIGHTMAP 3D RESOLUTION 
puts("WSAD, XC: move the ball"); -- HEIGHTMAP 3D RESOLUTION - 1) ; . , 
TPE jointPin(&joints[index],helper heightmapPointLocation(index)); 
s3l_scene.camera.transform.translation.z = -6 * TPE F; 
S3l scene.camera.transform.translation.y - 4 * TPE F; TPE worldStep(&tpe world); 
s3l_scene.camera.transform.translation.x = 0; 
s3l_scene.camera.transform.rotation.y = TPE_F / 16; #define G ((5 * 30) / FPS) 
TPE bodyApplyGravity(&tpe world.bodies[1] 
// build the water body: bodies[1].joints[O .position.y > 0? G : (-2 * G)) 
for (int i - 0; i « HEIGHTMAP 3D POINTS; +i) Yr ate, #define ACC ((25 * 30) / FPS 
joints[i] = TPE_joint (helper heightmapPoin Location(i), JOINT_SIZE); if (sdl keyboard[SDL SCANCODE W]) 
TPE bodyAccelerate bodies alone S $09 (9/ 0, ACC); 
int index = 0; else if (Ssdl keyboard[SDL SCANCODE S]) 
j Mer yAcce crate Teor SCAN DE Diy ey * ACC)) 
for (int j = 0; j < HEIGHTMAP 3D RESOLUTION; ++j) etse IPAUSU -KeyDOaT = = 
for (int i 2/0) i < HEIGHTMAP. SD RESOLUTION - 1; ++i) mu YA eevbear TOOL SCAN DOE ATS (00/0/80); 
connectionspindex].ointi = jj" HEIGHTMAP ŞD RESOLUTION + i; eise iP (Lal kayboar $f SDL Se tope CYS ^l ACO 9)): 
connections[index].joint2 = connections[index].jointi + 1; TPE. bodyAccelerate Sbodies|1| TPE vec3(0, ACC, 0)); 
. else if (sdl keyboard[SDL SCANCODE X]) 
index++; TPE_bodyAccelerate(&bodies[1], TPE_vec3(0,-1 * ACC,9)) 
connections[index].jointi = i * HEIGHTMAP 3D RESOLUTION + j; helper. set3DColor(255,0,0) 
connections[index].joint2 = connections[index].jointi + 
HEIGHTMAP. 3D RESOLUTION; helper drawapsphere(bodies[1].joints[9].position, TPE vecS(BALL SIZE, BALL SIZE,B 
ALL SIZE), TPE_vec3(0,0,0)); 
index++; helper_set3DColor (0,100, 255); 
helper_drawModel(&heightmapModel, TPE_vec3(0,0,0), TPE_vec3(TPE_F, TPE_F, TPE_F), TP 
TPE_bodyInit (abodies [9], joints, WATER_JOINTS, connections, WATER_CONNECTIONS, E_vec3(0,0,0)); 
F); 


if (helper debugDrawOn) 
bodies[0].flags |- TPE BODY FLAG SOFT; helper debugDraw(1) 
bodies[0].flags |= TPE BODY FLAG ALWAYS ACTIVE; 

helper frameEnd(); 
// create the ball body: 
joints[WATER JOINTS] = TPE joint(TPE vec3(0,0,RO00M SIZE / 4),BALL SIZE); 
PE bodyInit(&bodies[1],joints + WATER JO NTS, 1, connections, 0, 200); helper_end(); 


bodies[1].flags |= TPE_BODY_FLAG_ALWAYS_ACTIVE; return 0; 
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T1 21st century.md ---------- 
# 21st Century 


21st century, Known. as the Age Of [Shit](shit.md), is already one of the worst centuries in history despite only being around shortly. 
T 3d modeling.md ---------- 
# 3D Modeling 


The topic of 3D modeling will be part of article about [3D models](3d_model.md). 
T 3d model.md ---------- 
# 3D Model 


TODO 

## 3D Modeling: Learning It And Doing It Right 

*WORK IN PROGRESS* 

**Do you want to start 3D modeling?** Or do you already know a bit about it and **just want some advice to get better?** Then let us share a few words of advice here. 


Nowadays, as a [Foss] (foss md) user you will most. likely do.3D modeling with [Blender](blender.md) -- we recommended it to start learning 3D mogeling as it is powerful, [free](free software.md), 
gratis, has many tutorials etc. OT use anything [proprietary] (proprietary md) no matter what anyone tells you! Once you know a bit about the art, you may play around with alternative 
programs or approaches (such as writing programs that generate 3D models etc.). However **as a beginner just start with Blender**, which is from now on in this article the software we'll suppose 
you're using. 


**Start extremely simple and learn bottop-up^*s i,e. learn about fundamentals, and low level.concepts and start with very simple models (e.g. simple untextured low-poly shape_of a house, .box with 
a roof), keep creating more complex models by Small steps. Do NOT fall into the trap of "quick and easy magic 3D modeling" such as sculpting or Some "[Snart Tener ^no) [apps](app.md)" without 
knowing what's going on at the low level, you'll end up creating extremely ugl inefficient models in bad formats, like someone wanting to create space rockets without learning anything about 
math or physics first. Remember to **practice, practice, practice** -- eventually you learn by doing, so try to make small projects and share your results on sites such as opengameart to get 
feedback and some mental satisfaction and reward for your effort. The following is an outline of possible steps you may take towards becoming an alright 3D artist: 


1. **Learn what 3D model actually is, basic technical details about how a computer represents it and roughly how [3D rendering](3d rendering.md) works**. It is EXTREMELY important to have at 
least some idea about the fundaméntals, i.e. you should learn at least the following: 

- 3D models that are used today consist of **vertices and [triangles | (triangle .md)*? (though higher polygons are usually supported in modeling software, everything is broken down to triangles 
eventually), computers usually store [arrays](array.md) of vertices and triangles a$ indices pointin o e array of vertices. Triangles have **facing** (front and back side, determined by the 
order of its vertices). These 3D models only represent the boundary (not the volume). All this is called the model's **geometry**. 

- **[Normals](normal.md)** are [vectors] (vector md "perpendicular tọ the surface", they can be explicitly modified and stored or computed automatically and they are extremely important 
becausé they say how the model interacts with light (they are used in. [shading] (shading md) of the model); i.e. which edges appear sharp or smooth. Normal maps are textures that can be used to 
modify normals to make the surface seem rough or otherwise deformed without actually modifying the geometry. You HAVE TO understand normals. 

ting vexEures](texture md)" are images (or similar images ke data) that can be mapped to the model surface to "paint it" (or give it other material properties). They are mapped to models by 
giving vertices texturing **UV coordinates**. To make textures you'll need some basics of 2D image editing (see e.g. [GIMP](gimp.md)). 

- 3D rendering, (and also modeling) works with the concept of a tilscenel (scene md)** in which a number of models reside, as well as a virtual camera for multiple ones), lights and other 
objects. These objects have **transSformations** (normally translation, rotation and scale, represented by [matrices](matrix.md)) and may form a hierarchy, so called [scene graph](scene graph.md) 
(some objects may be parents of other objects, meaning the child transformations are relative to parents) etc. 

- A 3D renderer will draw the triangles the model consists of by applying jafShading] (shading md ** to determine color of pach, [pixel] (pixel md) of the [rasterized](rasterization.md) triangle. 
Shading takes into account besides others texture(s) of the model, its material properties and light falling on the model (in which the model normals play a big role). Shading can be modified by 
creating **[shaders](shader.md)** (if you don't create custom shaders, some default one will be used). 

- Briefly learn about other concepts such as low/high poly modeling and,basic,**3D formats** such as [0BJ](obj.md) and [COLLADA](collada.md) (which features they support etc.), possible other 
models representations ([voxels](voxel.md), [point clóuds](point cloüd.md), ...) etc. 

. **Manually create a few extremely simple [ low-poly] (low. poly .md) untextured models**, e.g. that of a simple house, laptop, hammer, bottle etc, Keep the vertex and triangle count very low 
(under 100), make the model by MANUALLY creating every vertex and triangle and focus only of learning this low level’ geometry manipulation well (how to create a vertex, how to split an edge, how 
to rotate a triangle, ...), making the model conform to good practice and get familiar with tools you're using, i.e. learn the key binds, locking movement direction to principal axes, learn 
manipulating your 3D view, setting up the free/side/front/top view with reference images etc. Make the model nice! I.e. make it have correctly facing triangles (turn [backface culling] 
(backface_culling.md) on to check this), avoid intersecting triangles, unnecessary triangles and vertices, remove all duplicate vertices (don't have multiple vertices with the same position), 
Connect all that shoüld be connected, àvoid badly shaped triangles feg extremely acute/long ones) etc. Also learn about normals and make them nice! I.e. try automatic normal generation (fiddle 
e.g. with angle thresholds for sharp/smooth edges), see how they affect the model look, try manually marking some edges sharp, try out smoothing groups etc. Save your final models in OBJ format 
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fone of the simplest and most common formats supporting all you need at this stage). All this will be a lot to learn, that's why you must not try to create a complex model at this stage. You can 
eep yourself "motivated" e.g. by aiming for creating à low-poly model collection you can share at opengameart or somewhere :) 


,."*Learn texturing** -- just take the models you have and try to put a simple texture on. them by drawing a simple image, then unwrapping the UV coordinates and MANUALLY editing the UV map to 
fit on the model. Again thé goal is to get familiar with the tools and concepts now; experiment with helpérs such as unwrapping by bie dornerg from 3D view", using "smart" UV unwrap etc. Make 
e 


the UV map nice! Just as model geometry, UV maps also have good practice -- e.g. you should utilize as many. texture pixels as possil otherwise you're wasting space in the image), watch out 
for [color bleeding](color_bleeding.md), the mapping should have kind of "uniform pixel density" (9r possibly increased density on triangles where more details is supposed to be, Some pixels of 
the texture may be mapped to multiple triangles if possible (to er tacsent iy utilize them) etc. Only make a simple diffuse texture (don't do [PBR](pbr.md), material textures etc., that's too 
advanced now). Try out texture painting and manual texture creation in a 2D image program, get familiar with both. 

4. **Learn_modifiers and advanced tools**. Modifiers help you e.g. with the creation of symmetric models: you eniy model one side, and the other one gets mirrored. Subdivide modifier will j 
automatically create a higher poly version of your model (but you need to help it by telling it which sides are sharp etc.). [Boo Lean] (boot. ma) operations allow you to apply set operations like 
unification or subtraction of shapes (but usually create a messy geometry you have to repair!). There are many tools, experiment and learn about their pros and cons, try to incorporate them to 
your modeling. 

. **Learn retopology and possibly sguipting®*. Topology is an extremely important concept.-- it Says what the structure of triangles/polygons is, how they are distributed, how they are . 
connected, which curves their edges follow étc. Good topology has certain rules (e.g. ideally only being composed of quads, being denser where the shape has more detail and sparser where it's 
flat, having edges so that animation won't deform the model badly etc.). Topology is important for efficiency (you utilize your polygon budget well), texturing and especially animation (nice 
deformation of the model). Creating more complex models is almost always done in the following two steps: 

- Creating the shape while ignoring topology for example with sculpting (but also other techniques, e.g. just throwing shapes together). The goal is to just make the desired shape. 

- Retopology: creating a nice topo ogy for the shape while keeping the shape unchanged. This is done by starting modeling from the start with the "stick to surface" option, i.e. whenever you 
create or move a vertex, it sticks to e nearest surface (surface of the created shape). Here you just try to create a new "envelope" on the existing shape while focusing on making the 
envelope's topology nice. 

6. **Learn about materials and [.sgadersi (shader .md) ij- At_this peint you may learn about how to create custom shaders, how to create transparent materials, apply multiple textures, how_to make 
realistic skin, [PBR](pbr.md) shaders etc. You should at least be aware of basic shading concepts and commonly encountered techniques such as [Phong shading phóng. shading. nd) [subsurface 
scattering] (subsurface_scattering.md), [screen space](screen space.md) effects etc. because you'll encounter them in shader editors and you should e.g. know what performance penalties to expect. 

. **Learn animation**. First learn about keyframes and interpolation] (interpotation.md) and try to.animate_basic transformations of a model, e.g. animate a car driving through_a city by 
keyframing its position and rotation. Then learn about animating the model's geometry --' first the simple, old way of morphing between different Shapes (shape keys in Blender). Finally learn the 
hardest type of animation: skeletal animation. Learn about bones, armatures, rigging, inverse kinematics etc. 

7. **Now you can go crazy** and learn all the uber features such as hair, physics simulation, [NURBS](nurbs.md) surfaces, boob physics etc. 


**Don't forget to stick to FERS] (Urs md) principles!** This is important so that your models are friendly to good technology, I.e. even if "[modern](modern.md)" desktops don't really care about 
otygon count anymore, still take the effort to optimize your model so as to not use more polygons that hecesSary! Your models may potentially be uSéed on small, non-consumerist computers with 
[Software renderers] (software Tenderin .md) and low amount of RAM. [Low-poly] (tow poly md) is better than high-poly {you can still prepare your model for automatic subdivision so that obtaining 
à higher poly model from it automatically is possible): Don't use complex stuff such as PBR or skeletal animation unless necessary -- you should mostly be able to get away with a simple diffuse 
texture and simple keyframe morphing animation, just like in old games! If you do use complex stuff, make it optional (e.g. make à normal map but don't rely on it being used in the end). 

Good luck with your modeling! 

T2 3d rendering.md ---------- 

# 3D Rendering 


In [computer graphics](graphics.md) 3D rendering is concerned with computing images that represent a projected view of 3D objects through a virtual camera. 


There are many.methods and [algorithm d (abeorithmp.md) for doing.so differing in many aspects such.as computation complexity, implementation complexity, realism of the result, representation of 
So on. 


s i 
the 3D data, limitations of viéwing an yoü are just interested in the jrea teame|(realtame md) 3D rendering used in Ugaymes ] (game . md ) nowadays, you are probably interested in [GPU] 
(gpu.md)-accelerated 3D [rasterization](rasterization.md) with [APIs](api.md) such as [OpenGL](opengl.md) and [Vulkan](vulkan.md). 


[LRS](lrs.md) has a 3D rendering library called [small3dlib](small3dlib.md). 
## Methods 


As most existing 3D "frameworks" are harmful, a [LRS](lrs.md) programmer is likely to write his own 3D rendering system that suits his program best, therefore we should list some common methods 
of achieving 3D. Besides that, it's just pretty interesting to see what there is in the store. 


A table of some common 3D rendering methods follows, including the most simple, most advanced and some unconventional ones. Note that here we talk about methods and techniques rather than 
algorithms, i.e. general approaches that are often modified and combined into à specific rendering algorithm. For example the traditional triangle rasterization is sometimés combined with 
raytracing to add e.g. realistic reflections. The methods may also be further enriched with features such as [texturing](texture.md), [antialiasing](antialiasing.md) and so on. The table below 
should help you choose the base 3D rendering method for your specific program. 


The methods may be tagged with the following: 


s AARDAS primitive 3D, often called [pseudo 3D](pseudo_3d.md) or fake 3D, having significant limitations e.g. in degrees of freedom of the camera 
slow method usually used for offline (non-realtime) rendering (even though pey indeed may run in real time e.g. with the help of powerful GPUs) 
rendering by pixels) vs j 


- *off*: 


- *IO* vs *00*: [image order](image order.md) object order](object order.md) (rendering by objects) 


3D raycasting](raycasting.m o ots rays rom camera 
2D raycasting|(raycasting.md *IO 2 [Wolf3D](wolf3D.md) 
AI](ai.md) image synthesis "just let AI magic do it" 
beamtracing](beamtracing.md) *IO off* 
billboarding](billboard.md) *00* 

BSP LH (bsp.md) d) REA C [Doom] (doom.md) 
conetracing](conetracing.m IO o 

[dungeon crawler ](dungeon_crawler.md)" *00 2.5D*, e.g. Eye of the Beholder 
ellipsoid rasterization *00*, e.g. Ecstatica 

flat-shaded 1 point perspective *00 2.5D*, 9:8; Skyroads 

reverse raytracing (photon tracing) *00 off*, inefficient . 

image pesed Fenger ing) (dbr md) generating inbetween views 

mode mode7.m : e.g. F-Zero 

parallax ser tainen para ma mo) 12,802, very primitive Kir " 
pathtracin pathtracing.m IO o Monte Carlo igh realism 
portal rendering] (porta . rendering.md) 12:007, e.g. foukean | {dukesd md) 
prerendered view angles i e.g. Iridion 
raymarching](raymaching.md) *IO off*, e.g. with [SDFs](sdf.md) 
[raytracing] (raytracing.md) a et br raycasting 
Nee ree MI haare]. | afore votimet ich ap bius 
triangle fásterizatión rasterization.md) *00*; traditional in GPUs 

voxel space rendering](voxel space.md) *00 2.5D e.g. Comanche 

wireframe rendering] (wireframe. md) *00*, just lines 


TODO: Rescue On Fractalus! 

TODO: find out how build engine/slab6 voxel rendering worked and possibly add it here (from http://advsys.net/ken/voxlap.htm seems to be based on raycasting) 
TODO: VoxelQuest has some innovative voxel rendering, check it out (https://www.voxelquest.com/news/how-does-voxel-quest-work-now-august-2015-update) 

## 3D Rendering Basics For Nubs 


If you're a complete noob and are asking what the essence of 3D is or just how to, render simple 3Dish pictures, for your gane without needing a PhD, here's the very basics. Yes, you can use some 
3D éngine such às [Godot](godot.md) that has all the 3D rendering preprogrammed, but you you'll surrender to bloat](bio t.md), you won't réally know what's going on and your ability to tinker 
with the rendering. on optimizing it will be basically zero... AND you'll miss on all the {fun} (fun ma) :) So here we just foreshadow some concepts you should start with if you want to program 
your own rendering. 


The absolute basic thing in 3D is probably **[perspective](perspective.md)**, or the concept which says that "things further away look smaller". This is basically the number one thing you need 
to know and with which you can make simple 3D pictures, even though there are many more effects and concepts that "make pictures look 3D" and which you can potentially study later (lighting, 
shadows, [focus and blur](depth of field.md), [stereoscopy](stereo.md), [parallax] (parallax md), visibility/obstruction etc.). { It's probably possible to make something akin "3D" even without 
perspective, just with [orthographic](ortho.md) projection, but that's just getting to details now. Let's just suppose we need perspective. -drummyfish } 


If you don't have rotating camera and other fancy things pe t 
i.e. its Z coordinate (you may divide by some multiple of coordinate, e.g. 
by so the smaller it becomes. This sgividing by distance" ultimately applies to all distances, so in the end even the details on the object get scaled according to their individual distance, but 
as a first approximation you may pust consider scaling objects as a whole. Just keep in mind you should only draw objects whose Z coordinate is above some threshold (usually called a *near 
plane*) so that you don't divide by ©! With this "dividing by distance" trick you can make an extremely simple "3Dish" renderer that just draws [sprites] (sprite md) on the Screen and scales them 
according to the perspective rules (8-9; some space simulator where the sprites are balls representing planets). There is one more thing you'll need to handle: ro isibi ty] [visibility md) "sj 
ipei nearer objects aS to cover the further away objects -- you can do this by simply [sorting](sorting.md) the objects by distance and drawing them back-to-front ([painter m] 
painters_algorithm. mi ` 


rspective is actually mathematically very simple, you basically įst **divide the object's size by its distance from the viewer**,. 
by * Z to get different [field of view] (tov m )) -- the further away it is, the bigger number its size gets divided 


s algorit 
Here is some "Simple" [C](c.md) code that demonstrates perspective and draws a basic animated wireframe cuboid as ASCII in terminal: 


#include <stdio.h> 


#define SCREEN W 50 // ASCII screen width 

#define SCREEN H 22 // ASCII screen height 

#define LINE POINTS 64 // how many points for drawing a line 
#define FOV 8 // affects "field of view" 

#define FRAMES 30 // how many animation frames to draw 


char screen[SCREEN_W * SCREEN_H]; 
void showScreen(void) 
for (int y = 0; y < SCREEN_H; ++y) 


for (int x = 0; x < SCREEN_W; ++x 
putchar(screen[y * SCREEN_W + x]); 


putchar('\n'); 
J 
void clearScreen(void) 
for (int i = 0; i < SCREEN W * SCREEN H; ++i) 
screen[i] - E 
// Draws point to 2D ASCII screen, [0,0] means center. 
int drawPoint2D(int x, int y, char C) 


x 
y 


if (x >= 0 && x < SCREEN W && y >= 0 && y <= SCREEN H) 
screen[y * SCREEN W + X] = c; 


SCREEN W/ 2 + X; 
SCREEN H / 2 + y; 


// Divides coord. by distance taking "FOV" into account -» perspective. 
int perspective(int coord, int distance) 
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return (FOV * coord) / distance; 


void drawPoint3D(int x, int y, int z, char c) 


if (z <= 0) 
return; // at or beyond camera, don't draw 


drawPoint2D(perspective(x,z),perspective(y,z),c); 


int interpolate(int a, int b, int n) 


return a + ((b - a) * n) / LINE_POINTS; 


void drawLine3D(int x1, int yi, int zi, int x2, int y2, int z2, char c) 
for (int i = 0; i « LINE POINTS; ++i) // draw a few points to form a line 
drawPoint3D(interpolate(x1,x2,i),interpolate(y1, y2,i),interpolate(z1,z2,i),c); 
Pt main(void) 
int shiftX, shiftY, shiftZ; 


#define N 12 // side length 
#define C '*' 


// cuboid points: 
tah X 


Y Z 
#define PA -2 * N + shiftX, N + shiftY, N + shiftz 
#define PB 2 * N + shiftX, N + shiftY N + shiftz 
#define PC 2 * N + shiftX, N + shifty, 2 * N + shiftz 
#define PD -2 * N + shiftX, N + shiftY, 2 * N + shiftZ 
#define PE -2 * N + shiftX, -N + shifty, N + shiftZ 
#define PF 2 * N + shiftX, -N + shifty, N + shiftz 
#define PG 2 * N + shiftX, -N + shiftY, 2 * N + shiftz 
#define PH -2 * N + shiftX, -N + shifty, 2 * N + shiftz 


for (int i = 0; i < FRAMES; ++i) // render animation 


clearScreen(); 


shiftX = -N + (i * 4 * N) / FRAMES; // animate 
shiftY = -N / + (i * N) / FRAMES; 

shiftZ = 0; 

// bottom: 


drawLine3D(PA,PB,C); drawLine3D(PB,PC,C); drawLine3D(PC,PD,C); drawLine3D(PD,PA,C); 


// top: 
drawLine3D(PE,PF,C); drawLine3D(PF,PG,C); drawLine3D(PG,PH,C); drawLine3D(PH,PE,C); 


// sides: 
drawLine3D(PA,PE,C); drawLine3D(PB,PF,C); drawLine3D(PC,PG,C); drawLine3D(PD,PH,C); 


drawPoint3D(PA, 'A'); drawPoint3D(PB,'B'); // corners 
drawPoint3D(PC, 'C'); drawPoint3D(PD, 'D'); 
drawPoint3D(PE, 'E'); drawPoint3D(PF,'F'); 
drawPoint3D(PG,'G'); drawPoint3D(PH, 'H'); 


showScreen(); 


puts("press key to animate"); 
getchar(); 


} 


return 0; 


One frame of the animation should look like this: 
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press key to animate 


## Mainstream Realtime 3D 


You, may have come here just to learn about the typical realtime 3D rendering used in today's [games](game.md) because aside from research and niche areas this kind of 3D is what we normally deal 
with ih practice. This is what this section is about. 


Nowadays "game 3D" means a Pu] (gpu md) accelerated 3D [rasterization](rasterization md) done with rendering [AP Tel (epi. md) such as PpenGL] (opengl md n [Vulkan] (vulkan. md) [Bürectap] (d3d, md) 
or [Me au metal md) (the last two being [proprietary](proprietary.md) and therefore [shit (nit; mo» and higher level engines above them, e.g. [Gddot](godot.md), [OpenScenéGráph](osg.md) etc. 
The methods seem to be evolving to some kind of rasterization/[pathtracing](pathtracing.md) hybrid, but rasterization is still the basis. 


This,mainstream rendering uses an [object order ] (object onder.md) approach (it blits 3D objects onto the screen rather than determining each. pixel's color separately) and works on the principle 
.e. mo e e 


of **triangle rasterization**, i els aré composed of triangles (or higher polygon$ which are however eventual Ly broken down into triangles) and these trian S are projected onto t 
Screen according to the position of the virtual camera and laws of [perspective] (perspective.md) Projecting the triangles means finding the 2D screen coordinates of each of the triangle's three 
vertices -- once we have thee coordinates, we draw (rasterize) the triangle to the screen just as a "normal" 2D triangle (well, with some asterisks). 


Furthermore things such as 3) butter ing] (z_buffer md) (for determining correct overlap of triangles) and [double_buffering](double_buffering.md) are used, which makes this approach very memory 
(TRAM (ram md), RAM] (vram. a expensive -- of cour$e mainstream computers have more than enough memory but smaller computers (e.g. [embedded](embedded.md)) may suffer and be unable to handle 
thi ind of rendering. Thankfully it is possible to adapt and imitate this kind of rendering even on "Small" computers -- even those that don't have a GPU, i.e. with pure [software rendering] 
sw rendering.md). For this we e.g. replace z-buffering with [painter's algorithm](painters_algorithm.md) (triangle sorting), drop features like [perspective correction] 

perspective correction.md), [MIP mapping](mip mapping.md) etc. (of course quality of the output will go down). 

Also additionally there's a lot of [bloat](bloat.md) added in such_as complex [screen space] (screen space.md) shaders, pathtracing] (pathtracing. md) (popularly. known as *raytracing*), 
[megatexturing](megatexturing.md), [shadow rendering](shadow.md), [postprocessing](postprocessing.md), [compute shaders](compute_shader.md) etc. This may make it difficult to get into "modern" 
3D rendering. Remember to [keep it simple](kiss.md). 


On PCs the whole rendering process is hardware-accelerated witha [GPU] {gpu md) (graphics card). GPU is a special hardware capable of performing many operations in [parallel](parallelism.md) (as 
opposed to a Pcpuy (epu md] which mostly computes sequentially with low level of parallelism) -- this is ideal for graphics because we can for example pertorm mapping and drawing of many 
triangles at_once, great ly Ancreasing the speed of rendering ([FPS](fps.md)). However this hugely increases the [complexity](complexity.md) of the whole rendering system, we have to have a 
special [API](api.md) and [drivers lt river.md) for communication with the GPU and we have to upload data (3D models, textures, ...) to the GPU before we want to render them. [Debugging] 
(debugging.m gets a lot more difficult. So again, this is [bloat](bloat.md), consider avoiding GPUs. 


GPUs nowadays are_no longer just focusing on graphics, but are kind of a general device that, can be used for more than just 3D rendering (e.g. [eryptol(crypto.md mining, training [AB (gi md] 
etc.) and can no longer éven perform 3D rendering completely by themselves -- for this they have to be programmed. I.e. if we want to uSe a GPU for rendering, not only do we need a GPU but also 
some extra code. This code is provided by "systems" such as [OpenGL](opengl.md) or [Vulkan (vulkan. md) which consist of an LARTI (a i.md) (an [interface](interface.md) we use from a [programming 
language](programming_language.md)) and the under lying implementation in a form of à [driver](driver.md) (e.g. [Mesa3D](mesa3d.mi 9 Any Such rendering System has its own architecture and 
details of how it works, so we have to study it a bit if we want to use it. 


The important part of a_system such as OpenGL is its **rendering [pipeline] (pipeline .md **. Pipeline is the."path" through which data go through the rendering process. Each rendering system and 
even potential each of its version may have a slightly differént pipeline (but generally all mainstream pipelines somehow achieve raSterizing triangles, thé difference is in details of how 
they achieve it). The pipeline consists of **stages** that follow one after another (e.g. the mentioned mapping of vertices and drawing of triangles constitute separate stages). A very important 
fact is that some (not all) of these stages are programmable with so called [shaders] {shader md **. A shader is a program written in a special language (e.g. fs SL](glsl.md) for OpenGL) 
running on the GPU that processes the data in some stage of the pipeline (therefore we astinguis different types of shaders based on at which part of the pape ine they reside). In early GPUs 
stages were not programmable but they became so as to give a greater flexibility -- shaders allow us to implement all kinds of effects that would otherwise be impossible. 


Let's see what_a typical pipeline might look like, similarly, to something we might see e.g. in OpenGL. We normally simulate such a pipeline also in [software renderers](sw-rendering.md). Note 
that the details such as the coordinate system [handedness ]{handeaness-m ) and presence, Order, naming or programmability of different stages will differ in any particular pipeline, this is just 


one possible scenario: 


1. Vertex data (e.g. 3D [model space] (model Space .md) coordinates of triangle vertices of a 3D model) are taken from a vertex buffer (a GPU memory to which the data have been up Loaded) « 
2. **Stage: [vertex shader | (vertex_s ader.md)**: Each vertex is processed with a vertex shader, i.e. one vertex goes into the shader and one vertex (processed) goes out. Here the shader 
typically maps the vertex coordinates to the screen 2D coordinates (or [normalized device coordinates] (nde md) by: 

- mut taptying the vertex by a [model matrix](model_matrix.md) (transforms from [model space](model_space.md) to [world space](world_space.md), i.e. applies the model move/rotate/scale 
operations 

- multiplying by [view matrix](view_matrix.md) (transforms from [world Space] (wor Ld_space md) to [camera space](camera_space.md), i.e. takes into_account camera position and rotation) 

- multiplying by. [projection matrix](projection matrix.md) (applies perspective, transforms fr camera space](camera_space.md) to [screen space](screen_space.md) in [homogeneous coordinates] 
(homogeneous_coordinates.md) ) 
3. Possible optional.stages that follow are [tessellation](tessellation.md) and geometry processing ([tessellation shaders] (tessellation_shader .md) and [geometry shader](geometry shader.md)). 
These offer possibility of advanced vertex processing (e.g. generation of extra Vertice$ which vertex shaders are unable tò do). 
4. **Stage: vertex post processing**: Usually not.programmable {no shaders here). Here the GPU.does things such as Solapping] (clipping. md) (handling vertices outside the screen space), primitive 
perspective divide Md) (transforming from [homogeneous coordinates](homogeneous coordinates.md) to tr 


assembly and [perspective divide aditional [cartesian coordinates] 

(cartesian coordinates.md)). 

5. **Stage: [rasteracetion](rasterization md) oi Usually not programmable, the GPU here turns triangles into actual [pixels] (pixel .md) or [fragments](fragment.md)), possibl applying [backface 
culling] (bac face_culling.md), [perspective Correction {perspective correttion.md) and things like [stencil test](stencil test.md) and [depth test](dept test.md) (even though if fragment shaders 
are allowed to modify depth, this may be postpones to later). 
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6, **Stage: pixe|/fragment processing"? : Each pixel (fragment) produced by rasterization is processed here by a [pixel/fragment shader](fragment_shader.md). The shader is passed the . 
ixel/fragment along with its coordinates, depth and posSibly other attributes, and outputs a processed pixel/fragment with a specific color. Typically here we perform [shading](shading.md) and 
texturing](texture.md) (pixel/fragment shaders can access texture data which are again stored in texture buffers on the GPU). 

7. Now the pixels are written to the output buffer which will be shown on screen. This can potentially be preceded by other operations such as depth tests, as mentioned above. 


TODO: example on specific data going through the pipeline 
T 42.md ---------- 


*"HAHAHAHAHAHAHAHAHAHHHHAAA BAZINGA"* --Sheldon fan 


42 is an even integer with prime factorization of 2 * 3 * 7. This number was made kind of famous (and later overused in pop culture to the point of completely destroying the [joke] (jokes md) ) by 
Douglas Adams' book The Hitchhiker's Guide to the Galaxy in which it appears as the answer to the ultimate question of life, the Universe and everything. (the point of the joke was at this 
number was the ultimate answer computed by a giant supercomputer over millions of years, but it was ultimately useless as no one knew the question to which this number was the answer). 


If you make a 42 reference in front of a TBBT fan, he will shit himself. 
T 4chan.md ---------- 


4chan (https: //4chan ,org/ is the most famous [image board {image_board mg); As most image boards, 4chan has a nice, oldschool minimalist look, even though it contains shitty captchas for . 

al sit eis (proprietary) (p oprierery.m . The site tolerates a great amount of [free speech](free_speech.md) up to the point of being regularly labeled "right-wing extremist 
although bans for stupid reasons such as harmless pedo jokes are very common, speaking from experience). Being a "rightist paradise" it is commonly seen as a rival to [reddit](reddit.md), 
aka the [pseudoleftist](pseudoleft.md) paradise -- both forums hate_each other to death. The discussion style is pretty nice, there are many nice stories and memes (e.g. the famous [greentext] 
(greentext.md) stories) coming from 4chan but it can also be a hugely depressing place just due to the shear number of retards with incorrect opinions. 


The site consists.of multiple boards, each with given discussion topic and rules. The most (in)famous board is *random* AKA /b/ which is just a shitton of [meme](meme.md) shitposting, [porn] 
(porn.md), [toxicity](toxic.md), [fun](fun.md), [trolling](troll.md) and retardedness. 


For us the most important part of 4chan is the technology board known as far (Tor technoloGEE). Browsin {g can bring all kinds of emotion, it's a place of relative freedom and somewhat 
beautiful chaos where all peop le from absolute retards to geniuses argue about important and unimportant things, brands, tech news and memes, and constantly advise each other to kill themselves. 
Sometimes the place is pretty toxic and not good for mental health, actually it is more of a rule than an exception. 


As of 2022 /g/ became unreadable, ABANDON SHIP. The board became flooded with [ca italists](capitalism.md) 
freaks and other uber retards, it's really not worth reading anymore. You can still read good old thr E 
T1 aaron swartz.md ---------- 

# Aaron Swartz 


cryptofascists roprietar shills](shill.md roductivit roductivity_cult.md 
bn ar Ehives such’ as REtpS 27e Sai tcs (Shi Td leppe daat ylp y ) 


*"I think all censorship should be deplored."* --Aaron Swartz 


---------- _abstraction.md ---------- 
# Abstraction 


Abstraction is an.important concept in programming] (programming md), {mathematics ](math.md) and other_fields of science, philosophy and.art, which in simple words can be described as "viewing 
an issue from a distance", thinking in highér-level concepts, i.e. paying less attention to fine detail so that one can see the bigger picture. In programming for example we distinguish 
[programming languages](programming language.md) of high and low level of abstraction, depending on how close they are "to the [hardware](hardware.md)" (e.g. assembly] (assenbly -md being low 
evel, (Javascript ](js.nd) eing high level); in [art farted) high abstraction means portraying and capturing things such as ideas, feelings and emotions with shapes that may, seem "distant", 
not resembling anything concrete or familiar. We usually talk about different **levels of abstraction**, depending on the "distance" we take in vieweing the issue at hand -- this concept may 
very well be demonstrated on [sciences](science.md): particle [physics](physics.md) researches the world at the lowest level of abstraction, in extreme close-up for example by examining 
individual atoms that make up our brains, while [bio logy] (biology. md) resides at a higher level of abstraction, viewing the brain at the level of individual ce is, and finally [psychology] 
(psychology.md) shows a very high level of abstraction because it looks at the brain from great distance and just studies its behavior. 


In gaipstream, [programming] (programming, md) education it is.generally taught to "abstract as much as possible" because that's aligned with the [capitatist](capitalism md) way of technology -- 
high abstractión iš easy andle for incómpetent programming monkeys, it helps preventing them from making damage by employing Dillions of safety mechanisms, it also pérpetuates the cu of 
never stopping layering of the abstraction sandwich, creating [bloat (bloat md); ullshit jobs, it makes computers slower, constantly outdated and so drives software consumerism. **This is 
extremely wrong.** [LRS](lrs.md) advocates to employ only. as little abstraction as needed, so as to support minimalism](minimalism.md), i.e. **too much abstraction is bad.** For example a 
widely used general purpose programming. Language should basically only have as much abstraction as to allow [portability 

j i 


as [object ol i 


(portability.md), it should definitely NOT succumb high abstraction such 
sessed programming](oop.m 


n : de [logic] 
stracting is further complicated b 


In a more detailed view abstraction is not one-dimensional, we may abstract in different directions ("look at the issue from different angles"); for example [functional](functional.md 
ind of abstraction may work well for certain kinds of problems (i.e. solving these problems will become simple when applying this abstraction) 


(Logic paradigm md) and [object](object.md) paradigms are different ways of abstracting from the low level, each one in different way. So the matter of al 
trying to **choose the right abstraction** -- one 
but badly for other kinds of problems. 


betes take a look at a possible division of a [computer](computer.md) to different levels of abstraction, from lowest to highest (keep in mind it's also possible to define the individual levels 
ifferently): 

- **[physics](physics.md)**: Computer is a collection of atoms and subatomic particles such as electrons, operating with terms such as [energy](energy.md), charge, spin or quantum effects. 

= ee electronic] (electronics md) circuit**: Computer is an [ang tog] (ana Log. nd) circuit in which electricity flows through wires and electronic components, operating with terms such as [voltage] 
(voltage.md), [ .md), resistor or electronic interference. 

- **[logic Ci rcuit](logic gatg.md **: Computer, is a [Pinapy](binary.md) Gigital] (digital.md) circuit; this is abstracting electricity away, now we. are only.considering two possible values 
carried by the wires: ts and 0S. Operating with terms such as [logic gáteé](logic gaté.md), logic function, [multiplexer](multiplexer.md) of sequential circuit. 

-,**[machine code (machipe.coge.md)/[assembly](assgmbly md)": Computer is a machine with.a specific. [instrugtion architecture](isa.md), executing an Gadgorithm] (algorithm md) encoded as_simple 
binary instructions, such as "add two numbers" or "write a number to memory", in a specific format that's different for different type$ of computérs. Operating with terms such as CPU cycle, 
[opcode](opcode.md), [register](register.md), memory or [interrupt](interrupt.md). 

- **low level [Portable](pprtabilit .md) language**; Computer is a machine capable of performing algorithms written in a structured language resembling, human language and it's a 
essentially thé same as other computers, even of different types, i.e. all computers can understand the same language (programs are [portable](portability.md)), typically e.g. [ 
Operating with terms such as structured data type, procedure, signed/unsigned type, [memory management](memory management.md), [process](process.md) synchronization etc. 

- y high level language**: Computer is a machine capable of performing algorithms while handling many things buch as memory allocation or gpsuring safety) automatically and dynamically (on-the- 
go) and understanding more complex and abstract descriptions of probiéms, allowing for very. fast and comfortable programming in languages like [Python](python.md) or [JavaScript] (javascript.md). 
Operating with terms such as [objects](oop.md), dictionaries, pure functions and fpotymorp ism](polymorphism.md). 

- **very high level, [artificial intelligence](ai.md)**: Computer is a machine, capable of simulating human thinking and therefore able to lead a conversation with human, it can perform commands 
given in natural language and even reason and Create on its own. Operating with terms such as training, data sets ànd ethics. 

T acronym.md ---------- 

# Acronym 


ürrent](current.md), [transistor](transisto 


7 chine that's 


a 
c](c.md) 


Acronym is an abbreviation of a multiple word term by usually appending the starting letters of each word to form a new word. 
Here is a list of some acronyms: 


**[AA](aa.md)** (anti [aliasing](aliasing.md)) 
ac.md)** (alternating current, air conditioning) 

CID](acid.md)** (atomicity consistency isolation durability) 
ACK] (ack.md)** (acknowledgement) | ^ : 
ADSL] (adsl.md)* qas mmetric digital subscriber line) 
AF](af.md)** (as 
AFAiK](afaik.md)** (as far as I know) 
AJAX ajax md)* (asynchronous [JavaScript](js.md) and [XML](xml.md)) 
AFK](afk.md)* away from keyboard) 

alu.md)** (arithmetic logic unit) 
AM] (am.md) * 


ANCAP] (ancap.md)** (anarcho Canteatist) 
anpac.md)** (anarcho pacifist) 


uck) 


(amplitude modulation 


ANSI](ansi.md)** (american national standards institute) 

A0](ao.md)** (ambient occlusion) 

API](api.md)* application pro ramming interface 
arm.md)** (advanced [RE E ) machines 

ARPANET](arpanet.md)** (a 


vanced research projects agency network) 


atm.md)** 


B](b.md)** (byte, bit) 
B4](b4.md)* 
BAS! bash.md)** (bourne again shell) 
BASIC|(basic.md)* [beginner all purpose symbolic instruction code) 
BBS](bbs.md)** (bulletin board system) 
BC](bc.md)* (bytecode) 3 

bcd.md)* (binary coded decimal) 
BDFL|(bdfl.md)** (benevolent dictator for life) 
BF](bf.md)** (brainfuck) 

** (background, bad game) 


*.(blüe green red 
**[BIOS](bios.md)** (basic [input/output](io.md) system) 
BJ](bj.md)** (blow job) 
j (bipolar junction transistor) 

BS](bs.md)** (bullshit) 
BTFO](btfo.md)** (blown the fuck out) 
CAD](cad.md)** (computer aided design) 

CAPTCHA] (capecha md ** (completely automated public Turing test to tell computers and humans apart) 


CC](cc.md)** (creative commons ) 
(creative commons zero) 


CD](cd.md)* „(compact disc, change directory) 
ci 


ief executive officer) 
** (computer generated imagery) 

(complex instruction set computer) 
CLI](cli.md)* (command line interface) 

(complementary metal oxide semiconductor) 

(content management system 
CMYK](cmyk.md)** (cyan magenta yellow ke 
COMPSCI] compsci.md)** 
CPj(cp.md)** A x 
CPI cpu.md central processing unit 
CRC](crc.md)** (cyclic redundancy check 
crt.md)** (cathode ray tube 
CSG](csg.md)** (constructive solid geometry) 
CSS](css.md)** (cascading style sheet) 
CSV](csv.md)** (comma separated values) 
DAC](dac.md)** (digital analog converter) 
DB](db.md)* database) 

: direct current) 
DDOS](ddos.md)** (distributed denial of service) 
dr .md)* (double data rate) 
e desktop environment) . , 
** (dynamic host configuration protocol) 
.md)** (download) 


(computer science 
,(child porn, copy) 


(direct memory access) 


DMA] (dma.md)* 
**TDMCA (amca md)" (digital millennium copyright act 
**TDND nd.md)** (dungeons & dragons, do not disturb 
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**TDNS](dns.md)** (domain name system) 
**[poM](dom.md)** (document object model) 

DOS] doi: md)** (disk operating system, denial of service) 
DPI md)** (dots per inch 
DRAM Caran md) (dynamic RAM 
DRM rm.md 2) "(aig al restrictions management) 
DRY](dry.md)** (don't repeat yourself) 
DVD](dvd.md)** (digital versatile disc) 
EEE Noe tan) md)** (electronically erasable programmable ROM) 
ELF md)** (executable and linkable format tf 
EMCAS] ( emacs . md editor macros) 

C](eniac.md electronic numerical integrator and computer) 
Tw end t T. fitlel (rite: m) 

ife) 

d) 


EOF] (eof .md 
EOL](eol.md)** ine, end of l 
esr.md 
EULA] (eula. mi 
is aq. nays 
FE e.md)* reid à 
FET] (fet .md field effect transistor) 
ffs.md for fuck's sake) 
FIFO d) * (Free* in first out) 

S 


eo Steven Raymond) 
(end user license agreement) 
e een iy asked questions) 


flac.md)** (free lossless audio codec) 
(floss.md)** (free libre open source software) 
EM] (fm.md)** (frequency modulation) 
FML (fmt md)** (fuck my life) 
FORT! A Fo ran. md)** (formula translation) 
FOSH](fosh.md free ànd open source hardware 
foss.md free and open source software 
FSF is Sf. Wr. ri ree software £frec-sq sg vare: md) foundation) 
FP p.md)* oatin 


g point](float.md 
FPGAÀ fps ind nj! * (field programmable nod array) 
frames per second, first person shooter) 
frequently questioned answers) 
(file System) 
FTP (fip. md )* (file transfer protocol) 
(fuck you) 
EXAA Pu md)*" (FULL screen anti aliasing) 
(for your information) 


GB per second 


MU MR GameBoy) 
(Siu compiler co 


lection) 
GNU debugger) 


obal illumination) 


g 
GIB](gib.md d gibibyte) 

graphics interchange format) 
GIG gigo. hd) i 
GIMP](gimp.md)** 
GLUT lut.md)** 
GNOME ] ( gnome . md 
GNU] ous md)** 
GPG «md 


GNU image manipulation l rogram) 
OpenGL utility toolkit) 


[oo dn in garbage out) 


(GNU network object model environment) 
GNU's Not Unix) 

GNU privacy guard) 

GPGPU Kr "i (genera purpose GPU) 
GPL pl.m GNU General Public License) 
Tera md) Is version 2 

3 


GPS](gps.md)* 
GPU] (gpl mapa 
(grup, md 


** (GPL version 3 


gpl.md 
obal positioning system) 

(Graphics processing unit) 

MER unified boot loader) 

GSM sm md a (d Obal system for mobile communication) 

GTK+ (atin p us.md)** (GIMP toolking) 


GUI](gui.m EN MO user interface) 


gh igh. définition) 
( ard disc drive) 

HDMI (hdmi. To) HD muLtumedsa interface) 

hardware) 

HTML t .md)** INIRE SEU pra md) markup language) 


http.md)** 
HTTPS (https. m" 
HURD 


IANA](iana.md)** internet assigned number authority) 
(ianal. md )* (I am not a lawyer) 


een yet (internet control message protocol) 
IDC](idc. Fa 

IDE}(ide.md 

IEE de mda. 
IM](im.md)** (instant messaging) 

IMAP](imap.md)** (internet message access protocol) 
imho.md)** (in my honest opinion) 
IMO](imo.md)* 


I don't care) 
integrated development environment 
(institute for electrical and electronic 


n my opinion) 


I0](io.md)** (input/output) 
IOT](iot.md)* internet of things) 

ips.md)** (instructions per second) 
IP](ip.md)** (internet protocol, intellectual property) 


IPVA E mi) HE version 3} 


** 


IP version 6 
internet relay chat) 
IRL](irl.md)** (in real life) 
ISA](isa.md)** (instruction set architecture) 
ISO](iso.md)** (international organization for standardization) 
ISP](isp.md)** (internet service provider) 
ISS](iss.md)** (international space station) 
IH tT: imd) * information thehanlody 

og 


ipv6.md 
End 


T ororen an techno 

(java 2 micro edit Yn) 
JB](jb.md)** AQ al bait](jailbait, md)) 

** (java development kit 
just in time) 

"ü ust kidding) 
tels ind) ** (joint photographic expert group) 
= (Javascript) 
JSON](json.md)** (JavaScript object notation) 
K&R](K and r. md) (Kernighan and Ritchie) 
KB](kb-md)** ([ 
KBPS] (kbps. md) 
KDE] { kde . md 
KEK] (kek.md 


ilobyte/kilobit](memory unit.md)) 

* (KB per second 

K desktop environment 0 

** (a meme version of [LOL](lol.md) coming from World Of Warcraft) 
** (kilohertz) 

E ** (kibibyte) 

KILL FE {keep it [Linux](linux.md) loser) 


keep it simple stupid) 
F kilo LOC) 
KKK](Kkk.md)* ku klux Klan). 
[kill yourse TI (suicide . md) ) 
(linux apache mysql php) 
3 area network) 


liquid crystal display) 
ht emitting diode) 
esbian gay bisexual trans) 
gbt. ME (lesbian gay bisexual trans queer) 
gpl.md esser GPL) 
LIFO](lifo.md)** (last in first out) 
LISP](lisp.md)** (list processing) 
LMAO](lmao.md)** (laughing my ass off) 
ta] "Nr {taugh of code 


laughing out loud) 
,CUOw quality 

less retarded software/society) 
LSB] Vcb ind ** (least significant bit) 
LUT](lut.md)** (lookup table) 
MBR](mbr.md)** master boot record) 
MHZ] (mhz . md ) ** megahertz) 

ibyte) 
MIME ] (mime .md ) * (multipurpose internet mail extension) 
MIP] (mip. md) „mitt in parvo) 
B millions of instructions per second) 

MB per second) 
. “Umterobontrelier unit) 
MD](md.md)* (ogren) 

* my face when} 

massively multiplayer online) 
multimedia extension) 
G] (mmorpg) ** (MMO RPG) 

mosfet.md)** (metal oxide semiconductor field effect transistor) 
MPEG](mpeg.md)** (motion pictures experts group) 


ms.m 
HSB msb.md 
MSC](msc.md 
MSG](msg.md 
MUD] ( mud . mf 
NAN] ( nan . md 


NAT] (nat.md 
NC](nc.md)* 
Nob] (nOD má 

nop.md 


Nedinp p.md)* 


* 
* 


d 


| 


(ntfs. md 


f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
ge (inb4 ad) *!- (in) before) 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
k 
f 
f 
f 
f 


MERE gm md) ** mer e request) 


HM icro$oft 
eae significant bit) 
master of science) 
** (message) 
** (multi uSer dungeon) 
** (not a number) 


NASA] (nasa. md)* (national aeronautic 


(network address trans 
(non commercial) 
a not gonna lie) 
** (no operation) 
nondeterministic polynoi 
** (NT file system) 


and space administration) 
lation) 


mial) 


**TOEM](oem.md original equipment manufacturers) 
**TOGL](ogl.md)** (OpenGL) 

**TOMG](omg.md)** (oh my god) 

**[00](00.md)** (object oriented) 
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**[00P](oop.md)** (object oriented/obsessed programming) 
**ros](os.md)* (operating system, open source) 
OsS](oss.md)* open source software) 
](osi.md)** ([open source](open source.md) initiative) 
pap. ve eer to peer). 
PB](pb.md)* (pe abyte, petabit, personal best) 
PBR (pbr .md)* (physically based rendering) 
PC](pc.md)* ersonal computer, political correctness) 
Tt public domain](public domain.md)) 
portable document format) 
PCcM](pcm.md)** (pulse code modulation) 
pgp.md)** (pretty good privacy) 
PHD](phd.md)** (doctor of philosophy) 
PID](pid.md)** (process 1j 
PIN](pin.md)** (personal identification number) 
png.md)** (portable network graphics) . 
0p3 .m ost office protocol version 
POP3](pop3.md) * post off. protocol i3) 
(posix.md)** (portable operating system interface) 
PPC (ppc.md)** (power PC) 
PR](pr.md)* ull request) 
Ste ae Photoshop] (photoshop md), [Postscript](postscript.md), [PlayStation](playstation.md)) 
ps2.md)* (persona System 2) 
PTHC](pthc.md)** (preteen hardcore 
Qos os.md)* (quality of service 
n (redundant array of inexpensive discs) 
(random access [memory] (memory .md)) 
(release candidate) 
RCL|(raycastlib.md)** (raycastlib) 
REGEX] (regex qd is (regular expression) 
](rtc.md)** (request for comments) 
RGB](rgb.md re reen blue) 
RGBA] (rgba.md)* red green blue alpha) 
risc.md)** (reduced instruction set computer) 


pdf.md)* 


** 


**[RIP](rip.md)* rest in piece) 

**[RLE](rle.md)** (run length encoding) 
**[RMS](rms.md)** (Richard Matthew Stallman) 
**[RN](rn.md)* right now) À 
**[IROFL](rofl.md)** (rotting on floor laughing) 
**[ROM](rom.md)* [read-only](read only.md) memory) 
sid RPG](rpg.md)** (role playing game) 


RT](rt.md)* real time) : 
RT rtfm.md)** (read the fucking manual) 
rtos.md)** (real time operating system) 
S3L](small3dlib.md)** (small3dlib) 
SAAS](saas.md)** (software as a service) , 
S](saass.md)* {service as a software substitute) 
SAF](saf.md)** (sma fabstractrish) 
smallchesslib)** (smallchesslib) 


SD](sd.md)** (standard definition, secure digital) 
SDF] (sdf .md)* signed distance function 
SDK](sdk.md)** (software development kit 

sdl.md)** (simple directmedia layer 
SEO](seo.md)** (search engine optimization) 
SFX](sfx.md)** (sound effects) F 
SGML (sgml.md)* (standard generalized markup language) 
SHA](shà.md)* secure hash algorithm) 

sig.md)** (special interest group) 
SIM](sim.md)** (subscriber identity module) 
SIMD](simd.md)* single [instruction](instruction.md) multiple [data](data.md)) 
sloc.md)** (source lines of code 


f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 
f 


SMTP] ( smtp . md simple mail transfer protocol) 
sntp.md)** (simple network time protocol) 
SOC](soc.md)* system on chip) 
sql.md)** (structured query language) 
SRAI sram.md)* static RAM) 
ssao.md)** (screen space ambient occlusion) 
SSD 350-md ‘i solid state drive) 
ssh.m 
SSL] (ssl.md 


** (secure shell) 

secure socket layer) 

STFU (stfu.md)* (shut the fuck up) 

SvG](svg.md)** (scalable vector graphics) 

Sw](software.md)** (software) 

TAS](tas.md)** (tool assisted speedrun) 

TB](tb.md)* (terabyte, terabit 

TCC](tcc.md)* tiny [C](c.md) compiler) 

TCP](tcp.md)** (transmission control protocol) 

TFT](tft.md)** (thin filter transistor) 

TFW](tfw.md)** (that face when) 

TLA](tla.md)** (three letter acronym) 

TM](tm.md)* ([trademark] (trademar .md), [Turing machine](turing machine.md)) 

TOS](tos.md)* terms of service) 

TTY](tty.md)** (teletype) 

TUI](tui.md)** (text user interface) 

UBI](ubi.md)** (universal basic income 
** (user datagram protocol 

(user interface) 

i unified modeling language) 

** (uniform resource identifier) 

** (uniform resource locator 

** (united states of america 

** (universal serial bus 

** (coordinated universal time) 

** (unicode transformation format) 

(user experience) 

* version control system) 

voD](vod.md)** (video on demand) 

vHS](vhs.md)** (video home system) 

vIMj(vim.md)** ([vi](vi.md) qaproved) 


** 


VFX](vfx.md)** (visual effects 
VLAN] (vlan.md) * virtual LAN) 2 
vliw.md)** (very long instruction word) 
VM](vm.md)** (virtual machine) 
VPN](vpn.md)* virtual private network) 
vps.md)** (virtual private server) 
VRAI (vram.md)* (video RAM) 
E world wide web consortium) 
** (wide area network) 
wireless application protocol) 
(wireless fidelity) 
World Of Warcraft) 
** (WIFI protected access) 
wtf.md)** (what the fuck) . 2 F 
L](wtfpl)** (do what the fuck you want to public [license](license.md)) 
WYSIWYG ] Quysiuyg-md)*? (what you see is what you get) 
WM] (wm.md)** (window manager) 
WWW] (www.md)** (world wide web) _— 3 
XAML] (xaml.md) * (extensible application markup language) 
L](xhtml.md)** (extensible HTML) 
XML](xml.md)** (extensible markup language) 
**TYOLO](yolo.md)* you only live once). 2 , 
zomg.md)** (when you want to write OMG but accidentally also hit Z) 


W3C](w3c .md 
wap wan.md 


wap.md)** 
(wifi.md)* 
WOW] { wow. md ) * 
wre] wpa.md 


Artificial intelligence (At) is an area of [computer science](compsci.md) whose effort lies in making computers simulate thinking of humans and possibly other biologically living beings. This 
may include making computers play [games ] (game md such as [chess] (chéss.md) _compose music, paint pictures understand and processing audio, images and text on high level of [abstraction] 
(abstraction.md) (e.g. translation between natural languages), ma ang predictions about complex systems such as stock market or weather or even exhibit a general human-like behavior. Even though 
today's focus in AI is on [machine learning](machine_learning.md) and especially [neural networks](neural_network.md), there are many other usable approaches and models such as "hand crafted" 
state tree searching algorithms that can simulate and even outperform the behavior of humans in certain specialized areas. 


There's a concern that's still a matter of discussion about the dangers of developing a powerful AI, as that could possibly lead to a, [technological singularity](tech_sin ularity, md) in which a 
super intelligent AI might take control over the whole world without humans being able to seize the control back. Even though it's still likely a far future and many people say the danger is not 
real, the question seems to be about *when* rather than *if*. 


By about 2020, "AI" has become a [capitalist](capitalism.md) [buzzword](buzzword.md). They try to put machine learning into everything just for that AI label -- and of course, for a [bloat 
monopoly](bloat_monopoly.md) . 


By 2023 neural network AI has become extremely advanced in prpcessing visual, textual and audio information, and is rapidly marching on, Networks such as, [stable diffusion](stable diffusion.md) 
ate now able to generate images (or modify existing ones) with results mostly indistinguishable from real photos just from a short plain language textual description. Text to video AI is 
emerging and already giving nice results. AI is able to write computer programs from plain language text description. Chatbots, especially the proprietary [chatePr](chatgpt md), are scarily 
human-like and can already carry on conversation mostly indistinguishable from real human conversation while showing extraordinary knowledge and intelligence -- the chatbot can for example 
correctly reason about advanced mathematical concepts on a level much higher above average human. AI has become [mainstream] (mainstream md and is everywhere, normies are downloading "AI apps" 
on their phones that do funny stuff with their images while spying on them. In games such as [chess](chess.md) or even strategy video [games](game.md) neural AI has already been for years far 
surpassing the best of humans by miles. 

T algorithm.md ---------- 

# Algorithm 


Algorithm (from the name of Persian mathematician, Muhammad ibn Musa al-Khwarizmi) is an exact ste Yr STEP description of how to solve some type of a problem. Algorithms are basically what 
[programming] (programming md) is all about: we tell [computers](computer.md), in very exact ways [e h [programming languages] (programming: Lahguage . md) how to Solve problems -- we write 
algorithms. But algorithms don't have to be just computer programs, they are simply instruction for solving problems. 


Cooking recipes are commonly given as an example of a non-computer algorithm, though they rarely contain branching and loops, the Kev features of an algorithm. The so called wall-follower is a 
simple algorithm to get out of any maze: you just pick either a left-hand or right-hand wall and then keep following it. You may write a crazy algorithm basically for any kind of problem, e.g 
for how to clean a room or how to pick up a girl, but it has to be **precise** So that anyone can execute the algorithm just by blindly following the steps; if there is any ambiguity, it is not 
considered an algorithm. 


Interesting fact: contrary to intuition there are 


re problems that are mathematically, proven to.be unsolvable by any a gorithm, see [undecidability](undecidability.md), but for most practically 
encountered problems we can write an algorithm (tho y [slow] (til om d)). 


ugh for some problems even our best algorithms can be unu$abU lexity.m 


Algorithms are mostly (possibly [not always](declarative.md) depending on exact definition of the term) written as a **series of steps** (or instructions); these steps may be specific actions 

süch as adding two humbers or drawing a pixel to the screen) or **conüitional jumps** to other steps ("if condition X holds then jump to Step N, otherwisé continue"). At the lowest level 

{Pnschane code] (machine. code md) , [assemb yifassembly md)) computers can do just that: execute instructions (expressed as [1s and Os] (binary imd) and perform conditional jumps. These jumps can 
ra A er kno 


be used to create **[branches]( nch.md)** (in programming known as *if-then-else*) and **[loops](loop.md)* Branches and loops are toget wn as [control structures](control structure.md) 
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-- they don't express a direct action but control which steps in the algorithm will follow. All in all, **any algorithm can be written with only these three constructs**: 


- **sequence**: A series of steps, one after another. E.g. "write prompt, read number from input, store than number to memory". 

- **selection** (branches, iif-thenselsg'là Two branches (sequences of steps) preceded by a condition; the first branch is executed only if the condition holds, the second ("else") branch is 
executed only if the condition doesn't hold (e.g. "If user password is correct, log the üser in, otherwise print out an error."). 

Fire hfration”™ (loops, repetition): Sequence of steps that's repeated as long as certain condition holds (e.g. "As long as end of file is not reached, read and print out next character from the 
ile."). 

imper 


Note: in a wider sense algorithms may be expressed in other ways than, sequences of steps pon: Limperatiye] (im E 
ut we $tic 


A S n f ive.md) ways, see [declarative Languages] (dec larative.md)), even mathematical 
equations are often called algorithms because they *imply* the steps towards solving a problem. ove. 


at 
to the a) way meaning of algorithm given al 


Additional constructs can be introduced to make programming more comfortable, e.g. [subroutines/functions](function.md) (kind of small subprograms that the main program uses for solving the. 
problem), [macros](macro.md) (shorthand commands that represent multiple commandS) ör [switch](switch.md) statements (5e ection but with more than two branches). Loops are also commonly divided 
into several types such as: counted loops, loops with condition and the beginning, loops with condition at the end and infinite loops ('for', ‘while’, “do while’ and "while (1)' in [Cite md), 
respectively) -- in theory there can only be one generic type of loop but for convenience programming languages normally offer different "templates" for commonly used loops. Similarly to 
mathematica 


equations, algorithms make use of [variables](variable.md), i.e. values which can change and which have a specific name (such as *x* or *myVariable*). 


Practical programming is based on expressing algorithms via [text](text.md), but visual programming is also possible: [flowcharts](flowchart.md) are a way of visually expressing algorithms, you 
have probably seen some. [Decision trees](decision_tree.md) are special cases of algorithms that have no loops, you have probably seen some too. Even though some languages (mostly éducationa 
an as kanap] ea eee are, visual and Similar to flow charts, it is not practical to create big algorithms in this way -- serious programs are written as a text in [programming languages] 

programming_language.md) . 


## Example 


Let's write a simple algorithm that counts the number of divisors of given number *x* and checks if the number is [prime](prime.md) along the way. (Note that we'll do it in a naive, educational 
way -- it can be done better). Let's start by writing the steps in plain [English](english.md): 


1. Read the number *x* from the input. 

2. Set the *divisor counter* to 0. 

3. Set *currently checked number* to 1. 

4. While "Currently checked number* is lower or equal than *x*: 
- a: If *currently checked number* divides *x*, increase *divisor counter* by 1. 
- b: Increase *currently checked number*. 

5. Write out the *divisor counter*. 

6. If *divisor counter* is equal to 2, write out the number is a prime. 


Notice that *x*, *divisor counter* and *currently checked number* are [variables](variable.md). Step 4 is a loop (iteration) and steps *a* and 6 are branches (selection). The flowchart of this 
algorithm is: 


START 
M 
read x 


M 
set divisor count to 0 


M 
set checked number to 1 


T > 
M no 
checked number <= x ? ------ : 
yes 
checked number no 
divides x ? ------- à 
yes 
increase divisor 
count by 1 
«usus Uem Zoos 
z M 
increase checked F m 
number by 1 print divisor count 
ANE M no 
divisor count = 2 ? ----- $ 
yes 
print "number is prime" 
ER 
M 
END 


This algorithm would be written in [Python](python.md) as: 


x - int(input("enter a number: ")) 
divisors - 0 
for i in range(1,x * 1): 

if x % i == 0: # i divides x? 

divisors - divisors * 1 

print("divisors: " + str(divisors)) 
if divisors == 2: | 
..print("It is a prime!") 
and in [C](c.md) as: 


#include <stdio.h> 

int main(void) 

t int x, divisors = 0; 
scanf("%d",&x); // read a number 
for (int i= 1; i <= x; ++i 


if (x9 i 0) // i divides x? 
divisors - divisors -* 1; 


printf("number of divisors: %d\n",divisors); 


if (divisors == 2). 
puts("It is a prime!"); 


return 0; 


## Study of Algorithms 
Algorithms are the essence of [computer science](scompsci.md), there's a lot of theory and knowledge about them. 


Turing machine] (turin machine,md), a kind of mathematical bare-minimum computer, created by [Alan Turing](turing.md), is the traditional formal tool for studying algorithms, though many other 
models of compu ation} (modet ot coh utation.md) exist. From theoretical computer science we’ know not all problems are [computable] (computaba taty.md); i.e. there are problems unsolvable any 
algorithm (8:3; the [halting problem](halting problem.md)). [Computational complexity](computational complexity.md) is a theoretical study of resource consumption by algorithms, i.e. how fast 
and memory efficient algorithms are (see e.g. [P vs NP] (P-ySznp md). [Mathematical programming] (mathematical. rogramming.md) is concerned, besides others, with optimizing algorithms so that 
their time and/or space complexity is as low as possible which gives rise to algorithm design methods such as [dynamic programming] (dynamic_pro ramming.md) (practical [optimization] 
(optimization.md) is a more pragmatic approach to making algorithms more efficient). [Forma verafication] (forma Merification md] is a field that tries to mathematically (and sometimes 
automatically) prove correctness of algorithms (this is needed for critical software, e.g. in planes or medicine). [Genetic programming](generic programming.md) and some other methods of 
[artificial intelligence](ai.md) try to automatically create algorithms (*algorithms that create algorithms*). [Quantum computing](quantum.md) is concerned wit creating new kinds of algorithms 
or quantum computers (a new type of still-in-research computers). [Programming language](programming language.md) design is the art and science of creating languages that express computer 
algorithms well. 


## Specific Algorithms 


Following are some common algorithms classified into groups. 


- [graphies] (gra hics.md) 

- [DDA] (d: amd): line drawing algorithm 

- [Bresenham's algorithm](bresenham.md): another line drawing algorithm 
- [Midpoint al erathm cmi: point algorithm.md): circle drawing algorithm 
- [flood fill](flood fille.md): algorithm for coloring continuous areas 
- [FXAA](fxaa.md) 

- [Houg Epp Hass aree nd): finds shapes in pictures 

[ 


path tracin 

ray tracin 
mathi (math.m 
Boot'h algorithm] (booths algorithm md): algorithm for multiplication 
Dijkstra's algorithm] (dijks 


(path_tracing.md) 


painter's algorithm] (painters_algorithm.md) 
fepath tracingsm 


ras_algorithm.md) 


145 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


- [Euclidean algorithm] euc lidean algorithm. md): computes greatest common divisor 
- [numerical algorithms|(numerical.md): approximate mathematical functions 
- [sieve of Eratosthenes](sieve_of_eratosthenes.md): computes [prime numbers] (prime.md) 
[sorting](sorting.md) 
- bogosort] (bo josort.md) (stupid sort) . : s T 
- [bubble sort] Tbubb le sort -md : simple, kind of slow but still usable sorting algorithm 
- [heap sort](heap_sort.md) 
- [insertion Sort](insertión sort.md) 
- [merge Sort] merge_sort.md) 
- [shaker sort](shaker_sort.md) 
- [selection sort](selection sort.md) 
- [slow sort](slow sort.md) 
- [quick sort](quick_sort.md): one of the fastest sorting algorithms 
- [searching](seárching.md) 
- [binary search](binary search.md 
- [linear search 
[other](other.md . : ; 5 
- [A*](à start.md): path searching algorithm, used by [AI](ai.md) in many [games](game.md) 
- [backpropagation](backpropagation.md): training of [neural networks](neural net.md) 
- [fizz uzb](fizzbüzz md): problem/simple algorithm given in job interviews to filter out complete [noobs](noob.md) 
- Feri (eft md) : Nee converts signal (audio, image, ...) to its representation in frequencies, one of the most famous and important algorithms 


linear search.md 


Huffman coding](huffman code.md): [compression](compression.md) algorithm 

Kalman filter](kalman filter.md 

k-means](k means.md): [clustering](clustering.md) algorithm 

Hos (mdo end); hash](hash.md) function 

backtracking] (backtracking.md) 

minimax (mintmax- md) plus [alpha-beta pruning](alpha beta.md): used by many [AI](ai.md)s that play turn based games 
proof of work](proof . crypto.md 

RSA](rsa.md). f ` i n 
[Shor's algorithm](shors algorithm.md): [quantum](quantum.md) factorization algorithm 

YouTube](youtube.md) algorithm: secret algorithm YouTube uses to suggest videos to viewers, a lot of people hate it :) 


of work.md) algorithms: used by some [cryptocurrencies] 


## See Also 


- programming] (programming -md) 
design pattern] (design_pattern.md) 
recursion (recursion md) 
---------- aliasing.md ---------- 

& Aliasing 


Aliasing is a certain mostly undesirable phenomenon that distorts signals (such as sounds or images) when they are [samp led] (sampling md) [discretely] (discreto md) (captured at periodic 
intervals) -- this can happen e.g. when capturing sound with digital recorders or when [rendering](rendering.md) computer graphics. There exist [antialiasing](antialiasing.md) methods for. 
suppressing or even eliminating aliasing. Aliasing can be often seen on small checkerboard patterns as a moiré pattern (spatial aliasing), or maybe more famously on rotating wheels or helicopter 
rotor blades that in a video look like standing still or rotating the other way (temporal aliasing, caused by capturing images at intervals given by the camera's [FPS](fps.md)). 


A simple example showing how sampling at discrete points can quite dramatically alter the recorded result: 


7p EN | 


MEC EN ie 


tari 


..Qriginal image taking every 2nd taking every ist 


The following diagram shows the principle of aliasing with a mathematical function: 


^ original sampling period 
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reconstructed 
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The top signal is a [sine](sin,md) function of a certain [frequency] (frequency, md). We are sampling.this signal_at periodic intervals indicated by the_vertical fines = (this is how e.g. digital 
c 


sound recořders record soünds from the real world). Below we see t e samples we've taken make it seem às if the original signal was a sine wave of a much lower equency. It is in 
impossible to tell from the recorded samples what the original signal looked like. 


Let's note that signals can also be two and more dimensional, e.g. images can be viewed as 2D signals. These are of course affected by aliasing as well. 


The explanation above shows, why a helicopter's rotating blades look to, stand still in a video whose [FPS](fps.md) is synchronized with the rotation -- at any moment the camera captures a frame 
(i.e. takes a sample), the blades are in the same position as before, hence they appear to not be moving in the video. 


Of course this doesn't only happen with perfect sine waves. [Fourier transform](fourier transform.md) shows that any signal can be represented as a sum of different sine waves, so aliasing can 
appear anywhere. 


**Nyquist-Shannon sampling, theorem** says that aliasing can NOT appear if we sample with at.least twice as high frequency, as, that, of the highest frequency án the sampled signal. This means that 
we Càn eliminate aliasing by using a [lów pass Pitter lisu pass may before sampling which will eliminate any frequencies higher than the half of our sampling frequency. ThiS is why audio is 
normally sampled with the rate of 44100 Hz -- from such samples it is possible to correctly reconstruct frequencies up to about 22000 Hz which is about the upper limit of human hearing. 


Aliasing is also a.common problem in [computer graphics](computer-graphics.md),.Por example when rendering textured 3D models, aliasing can appear in the texture if that texture is rendered at a 
smaller size than its resolution (when the texture is enlarged by rendering, aliasing can't appear becausé enlargement decreases the frequency of the Samp tec signal and the sampling theorem 
won't allow it to happen). (Actually if we don't address aliasing somehow, having lower resolution textures can unironically have beneficial effects on the quality of graphics.) This happens 
because texture samples are normally taken at single points that are computed by the texturing algorithm. Imagine that the texture consists of high-frequency details such as small checkerboard 
patterns of black and white pixels; it may happen that when the texture is rendered at lower resolution, the texturing algorithm chooses to render only the black pixels. Then when the model 
moves a little bit it may happen the algorithm will only choose the white pixels to render. This will result in the model blinking and alternating between being completely black and completely 
white (while it should rather be rendered as gray). 


The same thing may happen in [ray tracin i raystracing,md),if we shoot a single sampling ray for, each screen pixel. Note that, [interpolation/filtering](interpolation.md) of textures won't fix 
texture aliasing. What can be used to reduce texture aliaSing are e.g. b [mipmap] (mi, .md) which store the texture along with its lower resolution versions -- during rendering a lower 
resolution of the texture is chosen if the texture is rendered as a smaller size, so that the Sampling theorem is satisfied. However this is still not a silver bullet because the texture may 
e.g. be shrink in one direction but enlarged in other dimension (this is addressed by [anisotropic filtering](anisotropic filtering.md)). However even if we sufficiently suppress aliasing in 
textures, aliasing can still appear in geometry. This can be reduced by [multisampling](multisampling.md), e.g. sending multiple rays for each pixel and then averaging their results -- by this 
we **increase our sampling frequency** ànd lower the probability of aliasing. 


**why doesn't aliasing happen in our eyes and ears?** Because our senses don't sample the world discretely, i.e. in single points -- our senses [integrate] (integration md. E.g, a rod or a cone 

in our eyes doesn't just See exactly one point in the world but rather an averaged tight over a small area (which is idéally right next to another small area seen by another cell, so there is no 
information to snige jin between them), and it also doesn't sample the world at specific moments like cameras do, its excitation by light falls off gradually which averages the light over time, 

preventing temporal aliasing. 


So all in all, **how to prevent aliasing?** As said above, we always try to satisfy the sampling theorem, i.e. make our, sampling frequency at least twice as high, as, the highest frequency in the 
signal we're Sampling, or at least get Close to this situation and lower the probability of aliasing. This can be done by either increasing sampling frequency (which can bé done smart, Some 
methods try to detect where sampling should be denser), or by preprocessing the input signal with a low pass filter or otherwise ensure there won't be too high frequencies. 

T anal bead.md ---------- 

# Anal Bead 


To most people anal beads are just sex toys they stick in their butts, however anal beads with with remotely controlled vibration can also serve as a well hideen one-way communication device. 
Use of an anal bead for cheating in [chesS](cheSs.md) has been the topic of a great cheat scandal in 2022 (Niemann vs Carlsen). 

T1 analog.md ---------- 

# Analog 


Analog is the opposite of [digital](digital.md). 
analytic geometry.md -- 
# Analytic Geometry 


Analytic geometry is part of [mathematics](math.md) that, solves [geometric](geometry.md) problems with falgebra] (algebra md); .for example instead of finding an intersection. of a line.and a ; 
circle with ruler and compass, analytic geometry finds the interSéction by sólving an equation. In other words, instead of Using pen and paper we use numbers. This is very important in computing 
as computers of course just work with numbers and aren't normally capable of drawing literal pictures and drawing results from them -- that would be laughable (or awesome?). Analytic geometry 
finds use especially in such fields as [physics simulations] (phySics_engine.md) (Teo liszon| (col Lasion.md) detections) and [computer graphics](graphics.md), in methods such as [ra tracing] 
(raytracing.md) where we need to compute intersections of rays with various mathematically defined shapes in order to render 3D images. Of course the methods are used in other fields, for 
example [rocket science](rocket science.md) and many other physics areas. Analytic geometry reflects the fact that geometric and algebraic problem are often analogous, i.e. it is also the case 
Ha any times problems we encounter in arithmetic can be seen as geometric problems and vice versa (i.e. solving an equation is the same as e.g. finding an intersection of some N-dimensional 
shapes). 


[gun] (fun md) fact: approaches in the opposite direction also exist, i.e. solving mathematical problems physically rather than by computation. For example [back in the day] (back then. md) when 
heré weren't any computers to compute very difficult Integr atel (integral md} and computing them by hand would be immensely hard, people literally cut physical function plots out of paper and 


weighted them in order to find the integral. Awesome oldschool [hacking] (hacking.md). 


Anyway, **how does it work?** Typically we work in a 2D or 3D [Euclidean space] (euclidean_space .md) with [Cartesian coordinates](cartesian coords.md) (but of course we can generalize to more 
dimensions etc.). Here, geometric shapes can be described with [equations](equation.md) (or [inequalities](inequality.md)); for éxample a zero-centefed circle in 2D with radius *r* has the 
equation *x^2 + y^2 = r^2* peytha orean theorem](pythagorean theorem.md)). This means that the circle is a set of all points *[x,y]* such that when substituted to the equation, the equation 
holds. Other shapes such as thes] (Line. md), [planes] p ane.md), [ellipses] (ellipse md) fparabo las] (parabola md) have similar equations. Now if we want to find intersections/unions/etc., we 
just solve systems of multiple equations/inequalities and find solutions (coordinates) ha satisfy a equations/inequalities at once. This allows us to do basically anything we could do with 
pen and paper such as defining helper shapes and so on. Using these tools we can compute things such as angles, distances, areas, collision points and much more. 


Analytic geometry is closely related to [linear algebra](linear_algebra.md). 
## Examples 


**Nub example**: 
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Find the intersection of two lines in 2D: one is a horizontal line with *y* position 2, the other is a 45 degree line going through the [0,0] point in the positive *x* and positive *y* 
direction, like this: 


_/ line 2 
/ 


line 1 


The equation of line 1 is just *y = 2* (it consists of all points *[x,2]* where for *x* we can plug in any number to get a valid point on the line). 
The equation of line 2 is *x = y* (all points that have the same *x* and *y* coordinate lie on this line). 


We find the intersection by finding such point *[x,y]* that satisfies both equatigns. We can.do this by plugging the first equations 2*,_to the second equation, *x = y* ge et the *x* 
coordinate of the intersection: *x - 2*. By plugging this *x* coordinate to any of the two line equations wé al&o get the attona e: 2 'I.e. the intersection lies at Lobräfn tes *[2,2]*. 


**Advanced nub example**: 
Let's say we want to find, in 2D, where a line *L* intersects a circle *C*. *L* goes through points *A - [-3,0.5]* and *B - [3,2]*. *C* has center at *[0,0]* and radius *r - 2*. 


Tpe equation for the circle *C* is *x^2 + y^2 = 2^2*, i.e. *xA2 + yA2 = 4*. This is derived from [Pythagorean theorem](pythagorean theorem.md), you can either check that or, if lazy, just trust 
this. Equations for common shapes can be looked up. 


One possible form of an equation of a 2D line is a "slope + offset" eguation: *y =_k.* x + q*, where *k* is the [tangent](tangent.md) (slope) of the line and *q* is an offset. To find the 
specific equation for our line *L* we need to first find the numbers *k* and *q*. This is done as follows. 


The tangent (slope) *k* is *(B.y - A.y) / (B.x - A.x)*. This is the definition of a [tangent](tangent.md), see that if you don't understand this. So for us *k = (2 - 0.5) / (3 - -3) = 0.25*. 


The p'umber *g* (offset) is computed by simply substituting some poinrcrh that ties on the line to the equation and solving for *q*. We can substitute either *A* or *B*, it doesn't matter. Let's go 
*A*: «aly + q*, with specific numbers this is *0. * q* from which we derive that 


Now we have computed both *k* and *q*, so we now have equations for both of our shapes: 


- circle *C*: *x^2 + y^2 = 4* 
- line *L*: *y = 0.25 * x + 1.25* 


Feel free,to gheck, she equations, substitute a few points and plot them to see they really represent the shapes (e.g. if you substitute a specific *x* shape to the line equation you will get a 
specific *y 


Now to find the _intersections.we have to solve the above system of equations, i.e. find such couples (coordinates) *[x,y]* that will satisfy both equations at once. One way to do this is to 
substitute the line equation into the circle equation. his we get 


*x^2 + (0.25 * x + 1.25)^2 = 4* 

This is a [quadratic equation](quadratic equation.md), let's get it into the standard format so that we can solve it: 
*x^2 * 0.0625 * x^2 * 0.625 * x * 1.5625 - 4* 

*1.0625 * x^2 * 0.625 * x - 2.4375 - 0* 


Note that. this makes perfect sense: a quadratic equation can have either one, two or no solution (in the realm of [real numbers](real number.md)), just as there can either be one, two or no 
intersection of a line and a circle. 


Solving quadratic equation is simple so we skip the details. Here we get two solutions: *x1 = 1.24881* oo *x2 = -1.83704*. These are the x position of our intersections. We can further find 
also the y coordinates by simply substituting these into the line equation, i.e. we get the final result 


- intersection 1: *[1.24881, 1.5622025]* 
- intersection 2: *[-1.83704, 0.79074] 


## See Also 


- [linear algebra](linear algebra.md) 
T1 anarchism.md ---------- 
# Anarchism 


Anarchism (from,Greek *an*, no and *archos*, ruler) is a socialist (socialism. ma) political philosophy estin any social hierarchy. and oppression. **Anarchism doesn't mean without rules, but 
without rulers**; despite popular misconceptions afarchism is not [Chaos](chaos.m on the contrary strives for a stable, ideàl socie Y of equal people that live in peace. It means order 
without power. The symbols of anarchism include the letter A in a circle and a bk flag that for différent branches of anarchism is diagonally split from bottom left to top right and the top 
part is filled with à color specific for that branch. 


A great many things about anarchism are explained, in the text *An Anarchist.FAQ*, which is [free Ligensed] (free_ culture.md) and can be accessed e.g. at 
https://theanarchist library.org/library/the-anarchist -faq-editorial-col lective-an-anarchist -faq-ful 


Anarchism is a wide term and engompasses many flavors.such as fanarche commune sm) (ancom: md). anarcho pacifism] (anpac, md), hagais" ayndicelisn](ansyn. md), [anareho primitivism] (anprim. md) or 
[anarcho mutualism](anmut.md me of the branches disagree on specific questions t out whether [violencé](Violence.md) is ever justifia or propose different solutions to issues such 
as organization of society, oever *all branches of anarchism are socialist** and all aim for **elimination of social hierarchy". such as_social classes created by wealth, jobs and weapons, 
i.e. anarchism opposes [state] (state. md) (e.g. police having power over citizens) and [capitalism](capitalism.md) (employers exploiting employees, corporations exploiting consumers etc.). 


There exist fake, pseudoanarchist ideologies such as ["anarcho" capitalism](ancap.md) (which includes e.g. so caleed [cr eee re ce "anarchism"](crypto_anarchism.md)) that deceive by their name despite 
pX their very definition NOT fitting the definition of anarchism (just like [Nazis] (nazi. md) called themselves {socials s](socialism.md) despite being the opposite). Also such shit as 

[panar cha: feminism] (antem. nd) are- just fascist bullshit. The propaganda also tries to deceive the public by calling various violent criminals anarchists, even though they very often can't fit 
the definition of a true anarchist 


[LRS](lrs.md) is an anarchist movement, specifically [anarcho pacifist](anpac.md) and [anarcho communist](ancom.md) one. 
IM anarch.md ---------- 
# Anarch 


Anarch is a LESS 184 ms)/[suckless](suckless. md) first person shooter game] (gai me. similar to [Doom] (doom: md), written by [drummyfish](drummyfish.md). It has been designed to follow the LRS 
principles vi osely and set an example of how games, and software in gen E and) ld be writ 


Tge repo is available at https://codeberg.org/drummyfish/Anarch 
Or https://gitlab.com/drummyfish/anarch. Some info about the game can also be found at the [libregamewiki](lgw.md): https://libregamewiki.org/Anarch. 
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*screenshot from the terminal version* 
Anarch has these features: 


H It is completely an Upybic domain](public domain.md)** [free software](free software.md)/[free culture](free culture.md) under [CCO](ccO.md), including all code and assets which were all made 

rom scratch by drummyfish 

- It has extremely low hardware demands, fitting into **256 kb** (WITH assets) and requiring only about **32 kb of [RAM](ram.md)** and **50 MHz [emu] epu: m) a [GPU](gpu.md)s need not apply. 

(e is jitten in pure [C99](c.md) without any [dependencies](dependency.md) (not even the standard library). It uses no [dynamic heap allocation](dynamic allocation.md) and no [floating point] 
oat.m 

- It is Tjextceme ly portable**, written against a.very. tiny I/O layer. As such it has been ported to many platforms such as [GNU](gnu.md)/[Linux](linux.md), [BSD](bsd.md), [Pokitto](pokitto.md), 

browser [JavaScrip ](javascript.md), [Raspberry Pi](rpi. may and mahy others. 

- It is written in a [single compilation unit](scu.md) and without any [build system](build system.md). 

- It is created with only free software. 

- It is well documented. 


Gameplay-wise Anarch offers 10 levels and multiple enemy and weapon types. It supports mouse where available. 


## Technical Details 
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Anarch's engine uses raycast Lib] (raycast Lib md). a LRS, library, for advanced 2D [ray gasting] (ray_casting. md which is often called a "pseudo 3D". This method was used by. Wolf3D, but Anarch 
improves it to allow different levels of floor and ceiling which makes it look a little cloSer to Doom (which however used a different methods called [BSP](bsp.md) rendering). 


The music in the game is [procedurally generated](procedural_generation.md) using [bytebeat](bytebeat.md). 


All images in the game (textures, sprites, ...) are 32x32 pixels, compressed by using a, 16 color subpalette of the main 256 color palette, and are stored in source code itself as simple [arrays] 
(array.md) of bytes -- this eliminates the need for using tesi (FLTe ma) and allow$ the game to run on platforms without a [file system|(file system.md). 


The game uses a tiny custom-made 4x4 bitmap [font](font.md) to render texts. 
Saving/loading is optional, in case a platform doesn't have persistent storage. Without saving all levels are simply available from the start. 


In the suckless fashion; mods are recommended to be made and distributed as [patches](patch.md). 
L2 ancap.md ---------- 
# "Anarcho" Capitali$m 


*Not to be confused with [anarchism](anarchism.md).* 


So called "anarcho capitalism" (ancap for short, not to.be confused with [anpac] (anpac . md) or any form of [anarchism] (anarchism. md)) is probably the worst, most retarded and most dangerous idea 
in the nes tory. of ever, and that is the idea of supporting [capitalism](cápitali$m.md) ab$olutely unrestricted by a ate or anything else. No one with at least 10 brain cells and/or anyone who 
has spent at least 3 seconds observing the world could come up with such a stupid, stupid idea. We, of course, completely reject this shit. 


It has to be noted that **"anarcho capitalism" is not real [anarchism](anarchism.md)**, despite its name. Great majority of anarchists strictly reject this ideology as any form of capitalism is 
completely incompatible with anarchism -- anarchism is defined as opposing any social hierarchy and oppression, while capitalism is almost purely based on many types of hierarchies (internal 
corporate hierarchies, hierarchies between companies, hierarchies of social classes of different weal etc.) and oppression (employee by employer, consumer by corporation etc.). Why do they 
call it *anarcho* capitalism then? Well, partly because they're stupid and don't know what they're talking about (otherwise they couldn't come up with such an idea in the first place) and 
Secondly, as any capitalists, they want to deceive and ride on the train of the *anarchist* brand -- this is not new, [Nazis](nazi.md) also called themselves *socialists* despite being the 
complete opposite. 


The colors on their flag are black and yellow (this symbolizes shit and piss). 
It is kind of another bullshit kind of "anarchism" just like "[anarcha feminism](anarcha feminism.md)" etc. 


## The Worst Idea In History 


As if [capitalism](capitalism.md) wasn't extremely bad already, "anarcho" capitalists want to get rid of the last mechanisms that are supposed to protect the people. from corporations -- [states] 
(state.md) - We, as anarchists ourselves, of course see states as eventually harmful, but they Cannot go before we get rid of capitalism first. Why? Well, imagine all the bad things corporations 
would want to do but can't because there are laws preventing them -- in "anarcho" capitalism they can do them. 


Firstly this means anything is allowed, any unethical, unfair business practice including slavery, physical violence, blackmailing, rape, worst psychological torture, nuclear weapons, anything 
that màkes you the winner in the jungle system. Except that this jungle is not like the old, self-regu ating jungle in which you could only reach limited power, this jungle offers, through . 
modern technology, potentially limitless power with instant worldwide communication and surveillance technology, with mass production, genetic engineering, AI and weapons capable of destroying 
the planet. 


Secondly the, idea of getting rid of a state in capitalism doesn't even make sense because **if we get rid of the state, the strongest corporation will become the state**, only with the 
difference that state is at least *supposed* to work for the people while a corporation is only by its very definition supposed to care solely about its own endless profit on the detriment of 
people: Therefore if we scratch the state, McDonalds or Coca Cola or Micro$oft -- whoever is the strongest -- hires a literal army and physically destroys all its competition, then starts ruling 
he world and making its own laws -- laws that only serve the further growth of that corporation such as that everyone is forced to work 16 hour shifts every day until he falls dead. Don't like 
it? They kill your whole family, no problem. 100% of civilization will experience the worst kind of suffering, maybe except for the CEO of McDonald's, the world corporation, until the planet's 
environment is destroyed and everyone hopefully dies, as death is what we'll wish for. 


All in all, "anarcho" capitalism is advocated mostly by children who don't know a tiny bit about anything, by children who are being brainwashed. daily in schools by capitalist propaganda, with 
no education besides an endless stream of ads from their smartphones, or capability of thinking on their own. However, these childrén are who will run the world soon. It is sad, it'$ not really 
their fault, but through them the system will probably come into existence. Sadly "anarcho" capitalism is already a real danger and a very likely future. It will likely be the beginning of our 
civilization's greatest agony. We don't know what to do against it other than provide education. 


God be with us. 
T anpac.md ---------- 
# Anarcho Pacifism 


Anarcho pacifism (anpac) is a form of [anarchism] (anarchism. md) that completely rejects any violence. Anarcho pacifists argue that since anarchism opposes hierarchy and oppression, we have to 
reject violence which i$ a tool of oppression and establishing hierarchy. This would make it the one true purest form of anarchism. Anarcho pacifists use a black ahd white flag. 


Historically anarcho pacifists such as.[Leo Tolstoy](totstoy.md) were usuall religiously motivated for rejecting violence, however this stance may.also come from 19gic and other than religious 
beliefs, e.g. the simple belief that violence will only spawn more violence ("eye for an eye will only maké the whole world blind"), or pure unconditional love of life. 


We, [LRS](lrs.md), advocate anarcho pacifism. We see how violence can be a short term solution, even to preventing a harm of many, however from the long term perspective we only see the complete 
delegitimisation of violence as leading to a truly mature society. We realize a complete, 100% non violent Society may be never achieved, but with enough education and work it will be possible 
to establish a society with absolute minimum of violence, a society in which firstly people grow up in a completely non violent environment so that they never accept violence, and secondly have 
all needs secured so that they don't even have a reason for using violence. We should at least try to get as close to this ideal as possible. 

TI antialiasing.md ---------- 

# Antialiasing 


Antialiasing (AA) means prevent ing faliasing] (aliasing. md), .i.e. distortion of signal (images, audio, video, ..,), caused by discrete sampling. Most people think antialiasing stands for "smooth 
edges in video game grap ics", however that a complétely inaccurate understanding of antialiasing: yes, one of the most noticeable effects of 3D graphics antialiasing for a common human is 
that of having smooth edges, but smooth edges are not the primary goal, they are not the only effect and they are not even the most important effect of antialisng. Understanding antialiasing 
requires understanding what aliasing is, which is not a completely trivial thing to do (it's not the most difficult thing in the world either, but most people are just afraid of mathematics, so 
they prefer to stick with "antialiasing = smooth edges" simplification). 


The basic_**sum up** is following: aliasing is a negative effect which may arise when we try to sample (capture) continuous signals.potentially containing high frequencies (the kind of 
"infinitely complex" data we encounter in real world such as images or sounds) in discrete Ynon-con inuous) way$ by capturing the signal values at specific points in time (as opposed to 
capturing [integrals](integral.md) of intervals), i.e. in ways native and natural to [computers](computer.md). Note that the aliasing effect is mathematical and is kind of a "punishment" for our 
"[cheating](cheating.md)" which we do by trying to simplify Capturing of very complex signals, 1.e. aliasing has nothing to do with noise] (noise md) or recording Squipment imperfections, and it 
may occur not only: when recording real world data but also when simulating real world, for example during 3D graphics rendering (which simulates capturing real world with a camera). A typical 
example of such aliasing effect is a video of car wheels rotating very fast (with high frequency) with a relatively low FPS camera, which then seem to be rotating very slowly and in opposite 
direction -- a high frequency signal (fast rotating wheels) caused a distortion (illusion of wheels rotating slowly in opposite direction): due to simplified discrete sam ling (recording video as 
a series of photographs taken at specific points in time in relatively low FPS). Similar undesirable effects may appear e.g. on high resolution textures when they're scaled down on a computer 
Screen (so called Moiré effect), but also in sound or any other data. Antialiasing exploits the mathematical Nyquist-Shannon sampling theorem that says that aliasing cannot occur when the 
sampling frequency is high enough relatively to the highest frequency in the sampled data, i.e. antialising tries to prevent aliasing effects typically by either preventing high frequency from 
appearing in the sampled data (e.g. blurring textures, see [MIP mapping](mipmap.md)) or by increasing the sampling frequency (e.g. [multisampling](multisampling.md)). As a side effect of better 
sampling we also get things such às smoothly rendered edges etc. 


Note that the word *anti* in antialising means that some methods may not prevent aliasing completely, they may just try to suppress it. somehow. For example the [FXAA] (?xaa md) (fast approximate 
antialiasing) method is a [postprocessing](postprocessing.md) algorithm which takes an already rendered image and tries to make it as if it was properly rendered in ways prevénting aliasing, 
however it cannot be 100% successful as it doesn't know the original signal, all it can do is try to give us a [good enough](good enough.md) [approximation](approximation.md). 


**How to do antialiasing?** There are many ways, depending on the kind of data (e.g, the number of dimensions of the signal or what frequencies you expect in it) or required quality {whether you 
want to prevent aliasing completely or just suppress it). As stated above, most methods make use of the Nyquist-Shannon sampling theorem which states that **aliasing cannot occur i he sampling 
frequency is at_least_twice as high as the highest frequency in the sampled signal**. I.e. if you can make sure your sampling frequency is high enough relatively to the highest frequency in the 
signal, you will completely prevent aliasing -- you can do this by either processing the input signal with a low pass filter (e.g. blurring an image) or by increasing your sampling frequency 
(e.g. rendering at higher resolution). Some specific antialiasing methods include: 


- **avoiding aliasing**: A pretty straightforward way :) Aliasing can be avoided e.g: simply by using low resolution textures as opposed to high resolution ones. 
-.,**[multisamplin 4(muttisamp ling .md)** (NSAA) *»[supsrgamp ling] (su ergamp Ling. md) * (SSAA) etc.: Increasing sampling frequency typically in computer graphics rendering, The, specific methods 
différ by where ai how they increasé thé number of samples (some methods incréase sam| ting uniformly everywhere, somë try to detec d pies there etc). A simple 
(but expensive) way of doing this is rendering the image at higher resolution and then scaling it back down. 
- **[FXAA](fxaa.md)**: Cheating, approximation of antialiasing by [postprocessing] (post rocessing.md), usually in [shaders](shader.md), cheap but can be imperfect. 

**[MIP mnápping](mipmap-md)*7: Way of preventing aliasing in rendering of scaled-down textures] (texture md) by having precomputed scaled-down antialiased versions of it. 
**[anisotrpic iltering](anisotropic Tiltering.md **: Improved version of MIP mapping. n i : 
**[motion blur](motion blur.md)**: Temporal antialiasing in video, basically increasing the number of samples in the time domain. 


aliasing areas an nly put more sam 


DE antivirus paradox.md ---------- 
# Antivirus Paradox 


{ I think this paradox must have had another established name even before antiviruses, but I wasn't able to find anything. If you know it, let me know. ~drummyfish } 


Antivirus paradox is the paradox of someone who's job it is. to eliminate certain undesirable phenomenon actually having an interest in keeping this phenomenon existing so as to keep his job. A 
typical example is an [antivirus](antivirus.md) company having an interest in the existence of dangerous [virusés](virüs.md) and malware so aš to keep their business running; in fact antivirus 
companies themselves secretly create and release viruses and malware. 


Cases of this behavior are common, e.g. the bind-torture-kill serial killer used to work as a seller of home security alarms who installed alarms for, people who, were afraid about being invaded 
by the bind-torture-killer, and then üsed his knowledge of the alarms to break into the houses -- a typical capitalist business. It is also a known phenomenon that many firefighters are 
passionate arsonists because society simply rewards them for [fighting](fight culture.md) fires (as opposed to rewarding them for the lack of fires). 


In [capitalism](capitalism.md and similar systems requiring people to have jobs. this paradox prevents progress, i.e. actual elimination of undesirable phenomena, hence capitalism and similar 
stems are anti-progress. And not only that, the system préssures people to artificially creating new undésirable phenomena (e.g. lack of [women](woman.md) in tech and similar [bullshit] 

(bs.md)) just to create new [bullshit Jobs] (bs Job. md) that "[fight](fight culture.md)" this phenomena. In a truly good society where people are not required to have jobs and in which people aim 

to eliminate [work](work.md) this paradox largely disappears. 

l1 apple.md ---------- 


Apple is a [terrorist ] (terrorism. md) Organization and one of the biggest [American](usa.md) computer fashion [corporations](corporation.md), infamously founded by [Steve Job$](steve_jobs.md), it 
creates and sells overpriced, abusive, highly consumerist proprietary electronic devices. 


Take a look S deant [Apple's Dark Side at Techrights](http://techrights.org/wiki/Apple*27s Dark Side). 
Ll app.md ---------- 


App is a retarded [gapitalist (capitalist software.md name for application] (application .md); it is used by fsoydeys](soydev. md), corporations and normalfaggots (similarly to how "[coding] 
(coding.md)" is uséd for [programming](programming.md)). This word is absolutely unacceptable and is only to be used to mock these retards. 


Anything called an "app" is expected to be [bloat](bloat.md), badly designed and, at best, of low quality (and, at worst, malicious). 
lI approximation.md ---------- 
& Approximation 


Approximating means calculating or representing something with lesser than best possible precision -- estimating -- purposefully allowing some margin of error in results and using. simpler 
mathematical models than the móst accurate ones: this is typically done in order to save resources (CPU cycles, memory etc.) and reduce foomplexity] (comp texity-md) so that our projects and 
analysis stay manageable. Simulating real world on a computer is always an approximation as we cannot capture the infinitely complex and fine nature of the real world with a machine of limited 
resources, but even withing this we need to consider how much, in what ways and where to simplify. 


Using approximations however doesn't have to impl decrease in precision of the final result. -- approximations very well serve. [optimizgtiong(optimization,md). E.g. approximate metrics help in 
heuristic](heuristic.md) algorithms such as [A Ja star.md). Another use of approximations in optimization is as a quick preliminary check fòr the expensive precise algorithms: e.g. using 
ounding spheres helps speed up collision detection (if bounding spheres of two objects don't collide, we know they can't possibly collide and don't have to expensively check this). 


Example of approximations: 


**[Distances](distance.md)**: instead of expensive **Euclidean** distance (`sqąrt(dx^2 + dy^2)`) we may use **Chebyshev** distance (`dx + dy’) or **Taxicab** distance (`max(dx,dy)`). 
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- **Engineering approximations** ("guesstimations"): e.g. **sin(x) - x** for "small" values of *x* or **pi - 3** (integer instead of Float) : : 

- **Physics engines**: comp Lex triangle meshes are approximated with simple analytical shapes such as **spheres**, **cuboids** and **capsules** or at least **convex hulls** which are much easier 
and faster to deal with. They also approximate **relativistic** physics with **Newtonian**. 

- **Real time graphics engines**, on the other hand, normally approximate all shapes with triangle meshes. 

- peo [R8 tracing] (ray tracing md} ** neglects indirect lighting. Computer graphics in general is about approximating the solution of the rendering equation. 

- **Real numbers are practically always approximated with [ loating poinf|(floating-pointmd) or [fixed point](fixed point.md) (rational numbers). 

- **[Numerical methods](numerical.md)** offer generality and typical y yield approximate solutions while their precision vs speed can be adjusted via parameters such as number of iterations. 

- **[Taylor series] (tay or_series.md)** approximates given mathematical function and can be used to e.g. estimate solutions of [differential equations] (differential_equation.md). 

Il arch.md ---------- 

# Arch Linux 


*"BTW I use Arch"* 
Arch Linux is a [rolling-release](rolling release.md) [Linux](linux.md) distribution for the "tech-savvy", mostly fedora-wearing weirdos. 


Areh as [shit](shit.md) at least for two reasons: it has proprietary packages (such as [discord](discord.md)) and it uses [systemd](systemd.md). [Artix](artix.md) Linux is a fork of Arch without 
systemd. 


Art is an endeavor that seeks discovery and creation of [beauty](beauty.md) and primarily relies on intuition, While the most immediate examples of art that come to mind are, for example [mugicl 
(music.md) and painting, even the most [Scientific] science md) and rigorous effort like [math](math.md) and [programming](programming.md) becomes art when pushed to the highest level, to the 
boundaries of current knowledge where intuition becomes important for further development. 


## See Also 


- [beauty](beauty.md) 
l1 ascii art.md ---------- 
# ASCII Art 


ASCII art is the fart] (art md) of manually, creating graphics and images only out of [fixed-width] (fixed width.md) [ASCII](ascii.md) characters. This means no [unicode] (unicode md) or extended 
ASCII characters are Lowe: of course. ASCII art iš also, strictly speaking separate from mere [ASCII rendering](ascii_rendering.md), i.e. automatically rendering bitmap image with ASCII 
characters in place of [pixe el (pixel md), and ASCII graphics that utilizes the same techniques as ASCII art but can't really be called art (e.g. computer generated diagrams). Pure ASCII art 
co 


should make no use of [color]( or.md). 
This kind of art used to be agreat part of the culture of earliest [Internet](internet.md) communities for a number of reasons. imposed targely by the limitations of old computers.-- it could be 
created easily with a text editor and saved in pure text format, it didn't také much space' to store or send over a network and it could be displayed on text-only displays and terminals. The 


rinciple itself predates computers, people were already making this kind of images with type writers. Nevertheless the art survives even to present day and lives on in the hacker culture, in 
Tünix] (unix: md) communities, on the [Smo Internet] (smo . internet.md) etc. ASCII diagram may very well be embedded eg; in a comment in a source code to explain some spatial concept -- that's 
pretty [KISS](kiss.md). we, [LRS](lrs.md), highly advocate use of ASCII art whenever it's [good enough](good enough.md). 


Here is a simple 16-shade ASCII [palette](palette.md) (but watch out, whether it works will depend on your font): ^£OVaxsflc/!;,.- ^. Another one can be e.g.: "WMOKXkxocl;:,'. 


: ( 
NV ) Steamer 
-- --' Duck! 


pH PH 


XX XX 
XXXX 


Wane 


SAF FTW 


## See Also 


- [ANSI art](ansi art.md) 

- [pixel art](pixel_art.md) 

- [plain text](plain_text.md) 
- [cowsay] (cowsay . md 

- [figle figle 

T2 ascii.md ---------- 


ASCII ( [American] (uga.md) standard code for information interchange) is a relatively, simple standard for digital epcoding of [text (text,md) that's one of the most basic and probably the most 
common format us for this purpose. For its simplicity and inability to represent Characters of less common alphabets it is nowadays quite often replaced with more complex encodings such as 
(ure 81 (vere md) who are however almost always backwards compatible with ASCII (interpreting UTF-8 as ASCII wil ive somewhat workable results), and ASCII itself is also normally supported 
everywhere. ASCII is the [suckless](suckless.md)/[LRS](lrs.md)/[KISS](kiss.md) character encoding, recommended and [good enough](good_enough.md) for most programs. 


The ASCII standard assigns a 7 [bit] (bit .md) code to each basic text character which gives it a room for 128 characters -- these include lowercase and uppercase fEnglish] (english. md) alphabet, 
decimal digits, other symbols such as a que$tion mark, comma or brackets, plus a few Special control characters that represent instructions such as carriage return which are however often 
obsolete nowadays. Due to most computers working with 8 bit bytes, most platforms store ASCII text with 1 byte per character; the extra bit creates a room for **extending** ASCII by another 128 
characters (or Creating a variable width encoding such as [UTI peicutre md): These extensions include unofficial ones such as VISCII (ASCII with additional Vietnamese characters) and more 
official ones, most notably [ISO 8859](iso 8859.md): a group of standards by [ISO](iso.md) for various languages, e.g. ISO 88592-1 for western European languages, ISO 8859-5 for Cyrillic 
anguages etc. 


(0000 is 0, 0001 is 1 etc.). Corresponding upper and lower case letters only differ in the 6th bit, so you can easily Convert between upper and lower case by negating it as "letter ^ 0x20`. 
e i is a fen r a A though, e.g. in not putting digits right before letters. That way it would be very easy to print hexadecimal (and all 
^putchar('0' + x)^. -drummyfis 


The ordering of characters has been kind of cleverly designed to make working with the encoding easier, for example digits start with 011 and the rest of the bits correspond to the digit itself 


ases up to a lot) simply as 


ASCII was approved as an [ANSI](ansi.md) standard in 1963 and since then underwent many revisions every few years. The current one is summed up by the following table: 


000 00 000 |0000000 null 

001 01 001 |0000001 start of heading 
002 02 002 |0000010 start of text 
003 03 003 |0000011 end of text 

004 04 | 004 |0000100 end of stream 


005 05 005 |0000101 enquiry 

006 06 006 |0000110 acknowledge 
007 07 007 |0000111 e BELL 

008 08 010 |0001000 : backspace 


009 09 | O11 |0001001 tab (horizontal) 
010 0a 012 |0001010| LF: new line 

011 Ob 013 |0001011| VT: tab (vertical) 
012 Oc 014 |0001100| FF: new page 

013 Od 015 |0001101| CR: carriage return 
014 0e 016 |0001110| SO: shift out 

015 of 017 |0001111| SI: shift in 

016 10 020 |0010000| DLE: data link escape 
017 11 | 021 |0010001| DC1: device control 1 
018 12 | 022 |0010010| DC2: device control 2 
019 13 | 023 |0010011| DC3: device control 3 
020 14 | 024 |0010100| DC4: device control 4 
021 15 025 |0010101| NAK: not acknowledge 
022 16 026 |0010110| SYN: sync idle 

023 17 027 |0010111| ETB: end of block 
024 18 030 |0011000| CAN: cancel 

025 19 | 031 |0011001| EM: end of medium 
026 1a 032 |0011010| SUB: substitute 

027 1b 033 |0011011| ESC: escape 

028 1c 034 |0011100| FS: file separator 
029 1d 035 |0011101| GS: group separator 
030 1e 036 |0011110| RS: record separator 
031 if 037 |0011111| US: unit separator 
032 20 040 |0100000| ` `: space 

033 21 041 |0100001 : 
034 22 042 [0100010 
035 23 043 [0100011 
036 24 044 [0100100 
037 25 045 [0100101 
038 26 046 |0100110 
039 27 047 |0100111 
040 28 050 |0101000 
041 29 051 |0101001 
042 2a 052 |0101010| ^*^ 
043 2b 053 |0101011| `+` 
044 2c 054 |0101100| `,` 
045 2d 055 |0101101| `-` 
046 2e 056 |0101110| ` 
047 2f 057 [0101111 
048 30 060 |0110000 
049 31 061 |0110001 
050 32 062 |0110010 
051 33 063 |0110011 
052 34 064 [0110100 
053 35 065 [0110101 
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TRWNRON: 


054 36 | 066 |0110110 
055 37 | 067 |0110111 
056 38 | 070 |0111000 
057 39 | 071 |0111001 
058 3a | 072 |0111010 
059 3b | 073 |0111011 
060 3c | 074 |0111100 
061 3d | 075 |0111101 
062 3e | 076 |0111110 
063 3f | 077 |0111111 
064 40 | 100 |1000000 
065 41 | 101 |1000001 
066 42 102 |1000010 
067 43 103 |1000011 
068 44 | 104 |1000100 
069 45 105 |1000101 
070 46 106 |1000110 
071 47 107 |1000111 
072 48 110 |1001000 
073 49 111 |1001001 
074 4a | 112 |1001010 
075 4b 113 |1001011 
076 4c 114 |1001100 
077 4d 115 |1001101 
078 4e 116 |1001110 
079 4f 117 |1001111 
080 50 | 120 |1010000 
081 51 | 121 |1010001 
082 52 122 |1010010 
083 53 123 |1010011 
084 54 | 124 |1010100 
085 55 125 |1010101 
086 56 126 |1010110 
087 57 127 |1010111 
088 58 130 |1011000 
089 59 131 |1011001 
090 5a | 132 |1011010 
091 5b 133 |1011011 
092 5c 134 |1011100 
093 5d 135 |1011101 
094 5e 136 |1011110 
095 5f 137 |1011111 
096 60 | 140 |1100000| `` ` ~~: backtick 
097 61 | 141 |1100001 
098 62 142 |1100010 
099 63 143 |1100011 
100 64 | 144 |1100100 
101 65 145 |1100101 
102 66 146 |1100110 
103 67 147 |1100111 
104 68 150 |1101000 
105 69 151 |1101001 
106 6a | 152 |1101010 
107 6b 153 |1101011 
108 6c 154 |1101100 
109 6d 155 |1101101 
110 6e 156 |1101110 
111 ef 157 |1101111 
112 70 | 160 |1110000 
113 71 | 161 |1110001 
114 72 162 |1110010 
115 73 163 |1110011 
116 74 | 164 |1110100 
117 75 165 |1110101 
118 76 166 |1110110 
119 7 167 |1110111 
120 78 170 |1111000 
121 79 171 |1111001 
122 7a | 172 |1111010 
123 7b 173 |1111011 
124 7c 174 |1111100 
125 7d 175 |1111101 
126 7e 176 |1111110 
127 7f 177 |1111111| D 
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## See Also 


PETSCII](petscii.md 


- [Unicode] (unicode .md 
- [ATASCII](atascii.md 


ASCII art](ascii art.md) 
base64] (base64.md) 
l1 assembly.md ---------- 
& Assembly 


Assembly (also ASM) is, for any given hardware computing platform ([ISA] (isa.md), basically a [ceu] cpu.md) architecture), the lowest, level [nregrammio language (ppgeramming language.md) that 
expresses typically a linear, unStructured sequence of CPU instructions -- it maps (mostly) 1:1 to [machiné code](machiné code.md) (the actu [ inary] (binaby Md PU instruction$) and basically 
on differs from the actual machine code by utilizing a more human readable form (it gives human friendly nicknames, or mnemonics, to different combinations of 1s and 0s). Assembly is converted 
by laSsemb ler] (assembler md) into the the machine code. Assembly is similar to [bytecode](bytecode.md), but bytecode is meant to be fanterpreted | (inter pretermd} or used as_an intermediate 
representation in [compilers](compiler.md) while assembly represents actual native code run by hardware. In ancient times when there were no higher level languages {like [C](c.md) or [Fortran] 
(fortran.md)) assembly was used to write computer programs -- nowadays most programmers no longer write in assembly (majority of zoomer "[ceders](coding.md)" probably never even touch anything 
Close to it) because it's hard (takes a long time) and not [portable](portability.md), however programs written in assembly are known to be extremely fast às the programmer has absolute control 
over every Single instruction (of course that is not to say you can't fuck up and write a slow program in assembly). 


**Assembly is NOT a single language**, it differs for every architecture, i.e, every model of CPU has potentially different architecture, understands a different machine code and hence has a 
different’ assembly (thotigh there are Some standardized families of assembly like x86 that work on wide range of CPUs); therefore **assembly is not [portable](portability.md)** (i.e. the program 
won't generally work on à different type of CPU or under a different [OS](os.md))! And even the same kind of assembly language may have several different [syntax] (syntax md formats which may 
differ in comment style, order of writing arguments and even instruction abbreviations (e.g. x86 can be written in [Inter] intet ma) and [AT&T] (at and-t.m ) syntax). For the reason of non- 
portability (and also for the fact that "assembly is hard’) you shouldn't write your programs directly in assembly but rather in a bit higher level language such as [C](c.md) (which can be 
compiled to any CPU's assembly). However you should know a east the very basics of programming in assembly as a good programmer will come in contact with it sometimes, for example during 
hardcore [optimization](optimization.md) (many languages offer an option to embed inline assembly in specific places), debugging, reverse engineering, when writing a C compiler for a completely 
new platform or even when designing one's own new platform. **You should write at least one program in assembly** -- it gives you a great insight into how a computer actually works and you'll 
get a better idea of how your high level programs translate to machine code (which may help you write better [optimized] lostin zation md) code) and WHY your high level language looks the way it 
oes. 


e.g. 


The most common assembly KON you'll encounter nowadays are suse ed (x26 md) (used by most desktop [CPU d)) and **[ARM](arm.md)** (used by most mobile CPUs) -- both are used ay 
T 
bit 


s](cpu.m 
{proprietar (proprietary.md) hardware and though an assembly language self cannot (as o yet) be [copy Sghtdej copy? daft cma) thé associated architectures may be "protected" (restricted 
y [patents](patent.md). **[ nos] A duino md)] on the other hand is an "[open](open.md)" a h not yet so wide spread. Other assembly languages include e.g. [AVR](avr.md) ( 


ternative, thoug 
CPUs used e.g. by some [Arduinos](arduino.md)) and [PowerPC](ppc.md). 


To be precise 
preprobessor), pseudoinstructions (commands that look like instructions but actually translate to e.g. multiple instructions), [comments] (commen 
writing literal jump addresses would be extremely tedious) etc. 


a typical assembly language is actually more than a set of nicknames for machine code instructions, it may offer helpers such as [agros (macro; mo (something, aking the C ( 
.md), directives, named labéls for jumps (as 


Assembly is extremely low level, sọ yoy get no handholding.or much programming "safety" (apart from HTR CPU operation modes], you have to do gverything yourself =: you'll be dealing with things 
such as function [call conventions] (cal l_convention.md), Pinterrupe 8] (incerrupe md), syScalls](syscall.md) and their conventions, how many CPU cycles different instructions take, memory 
segments, [endianness](endianness.md), raw addresses/[goto](goto.md) jumps, [call frames](call_frame.md) etc. 


ote that just replacing assembly mnemonics with binary machine code instructions is not yet enough to make an_executable 
libraries] (tbrary.md) and converting the result to some [executable format](executable_format.md) such as [elf](elf.md) 
c 


N ram! More things have to be done such as linking] (linking, md) 

L h contains things like header with metainformation about the program 
e 

## Typical Assembly Language 


Assembly languages are usually unstructured, i.e. there are no control structures such as 'if' or_`while` statements: these have to be manually implemented using labels and jump (Lgoto] 
(goto. md) instructions. There may exist macros that mimic control structures. The typical look of an assembly program is however still a single column of instructions with arguments, One per 
ine, each representing one machine instruction. 


The working of the language reflects the actual [hardware ] Chardware-md) architecture -- most architectures are based on [registers](register.md) so usually there is a small number {something 
like 16) of registers which may be called something like to R15, or A, B, C etc. Sometimes registers may even be subdivided (8-9. in x86 there is an *eax* 32bit register and half of it can be 
used as the *ax* 16bit register). These registers are the fastest available memory (faster than the main RAM memory) and are used to perform calculations. Some registers are general purpose and 
some are special: typically there will be e.g. the FLAGS register which holds various ibit results of performed operations (e.g. [overflow](overflow.md), zero result ete.) Some instructions may 
only work with some registers (e.g. there may be kind of a "[pointer](pointer.md)" register used to hold addresses along with instructions that work with this register, which is meant to 
implement [arrays](array.md)). Values can be moved between registers and the main memory (with instructions called something like *move*, *load* or *store*). 


Writing instructions works similarly to how you call a [function](runction md) in high level language: you write its name and then its [argumenta] (argument md), but in assembly things are more 
complicated because an instruction may for example only allow certain kinds of arguments -- it may @.g. allow a register and immediate Constant (Kind of a number literal/constant), but not e.g. 
two registers. You have to read the documentation for each instruction. While in high level language you may write general [expressions](expression.md) as arguments (like ^"myFunc(x + 2 * 
y,myFunc2())^), here you can only pass specific values. 


There are.also no complex.[data types] (data_type.md), assembly only.works with numbers of different size, e.g, 16 bit integer, 32. bit integer etc. Strings are just sequences of numbers 
representing [ASCII](ascii.md) values, it is up to you whether you implement null terminated strings or Pascal style strings.’ [Pointers](pointer.md) are’ just numbers representing addresses. It 
is up to you whether you interpret a number as signed or unsigned (some instructions treat numbers as unsigned, some as signed 


Instructions are typically written as_three-letter abbreviations and follow some unwritten naming conventions so that different assembly languages at least look similar. Common instructions 
found in most assembly languages are for example: 


**MOV** (move): move a number between registers and/or main memory (RAM). 
**JMP** jump : unconditional jump to far away instruction. 

**BEQ** ranch if equal): jump i 

**ADD** (add): add two numbers. 

**NOP** (no operation): do nothing (used e.g. for delays or as placeholders). 

**CMP** (compare): compare two numbers and set relevant flags (typically for a subsequent conditional jump). 


result of previous comparison was equality. 


## How To 
On. Unices](unix.pd) the Lobidump] (obj dump md) utility from GNU binutils can be used to **disassemble** compiled programs, i.e view the instructions of the program in assembly (other tools like 
ndisasm can also be used). U$e it é.g. as: 


objdump -d my compiled program 
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Let's now write a simple Unix program in [x86](x86.md) assembly (AT&T syntax). Write the following source code into a file named e.g. '"program.s': 


.global . start 4 include the symbol in object file 


str: 

.ascii "it worksNn" 4 the string data 

.text 

—start: # execution starts here 
mov 5, %rbx # store loop counter in rbx 

. loop: 


# make a Linux "write" syscall: 


# args to syscall will be passed in regs. 
mov do 9érax 4 says syscalls type (1 = write) 
mov Ee %rdi # says file to write to (1 = stdout) 
mov str, %rsi # says the address of the string to write 
mov 9, %rdx # says how many bytes to write 
syscall # makes the syscall 
sub p %rbx # decrement loop counter 
cmp 0, 9érbx # compare it to 0 
jne . loop # if not equal, jump to start of the loop 
# make an "exit" syscall to properly terminate: 
mov 60, %rax 4 says syscall type (60 exit) 
mov 0, %rdi 4 says return value (0 = success) 
.Syscall 4 makes the syscall 


The program just writes out,'it works' five times: it uses a simple loop and a [Unix](unix.md) [system call](syscall.md) for writing a string to standard output (i.e. it won't work on [Windows] 
(windowS.md) and similar shit). 


NOW. assembly source code can be manually assembled into executable by running,assemblers, like ‘as’ or `nasm` to obtain the intermediate [object file](obj.md) and then [linking](linking.md) it 
with '"ld', but to assemble the above written code simply we may just use the 'gcc ^ compiler which does everything for us: 


m -nostdlib -no-pie -o program program.s 
Now we can run the program with 

grügram 

And we should see 


it works 
it works 
it works 
it works 
it works 


As aņ exercise you can objdump the final executable and see that the output basically matches the original source code. Furthermore try to disassemble some primitive C programs and see how a 
compiler e.g. makes if statements or functions into assembly. 


## Example 


Let's take the following [C](c.md) code: 


#include <stdio.h> 


char incrementDigit(char d) 


return // remember this is basically an if statement 
d >= '0' && d < '9' ? 
d*1: 
19. 
?'; 


H 
int main(void) 
char c - getchar(); 


putchar (incrementbigit (c) s 
return 0; 


We will now, compile it to different assembly languages (you can do this $49: with “gcc -S my | rogram.c p This assembly will be pretty long as it will contain [boilerplate] (boilerplate. md) and 
implementations of `getchar` and 'putchar rom Standard library, but we'll only be looking at the assembly corresponding to the above written code. Also note that the generated assembly will 
probably differ between compilers, their versions, flags such as [optimization] optimization md) level etc. The code will be manually commented. 


{ I used this online tool: https://godbolt.org. ~drummyfish } 
The [x86](x86.md) assembly may look like this: 


incrementDigit: 


pushq %rbp # save base pointer 
movq %rsp, %rbp # move base pointer to stack top 
movi %edi, %eax # move argument to eax 
movb %al, -4(%rbp # and move it to local var. 
cmpb 47, -4(%rbp # compare it to '0' 
jte .L2 4 if «-, jump to .L2 
cmpb 56, -4(%rbp) # else compare to '9' 
jg .L2 4 if », jump to .L4 
movzbl -4(%rbp), %eax # else get the argument 
addl 1, %eax 4 add 1 to it 
jm .L4 # jump to .L4 
movl 63, %eax # move '?' to eax (return val.) 
.L4: 
popq %rbp # restore base pointer 
re 
main 
pushq %rbp # save base pointer 
movq %rsp, %rbp # move base pointer to stack top 
subq 16, %rsp # make space on stack 
call getchar 4 push ret. addr. and jump to func. 
movb %al, -1(%rbp) # store return val. to local var. 
movsbl -1(%rbp), %eax # move with sign extension 
movl %eax, %edi # arg. will be passed in edi 
call incrementDigit 
movsbl %al, %eax._ # sign extend return val. 
movl %eax, %edi # pass arg. in edi again 
call putchar 
movl $0, %eax # values are returned in eax 
Teave 
re 


The [ARM](arm.md) assembly may look like this: 


incrementDigit: 


sub sp, sp, #16 // make room on stack 
strb wọ, [sp, 15 // load argument from wO to local var. 
ldrb wọ, [sp, 15 // load back to w0 
cmp wO, // compare to '0' 
bls .E2 // branch to .L2 if « 
ldrb wọ, [sp, 15] // load argument again to wO 
cmp wO, 56 // compare to '9' 
bhi  .L2 // branch to .L2 if »- 
ldrb w0, [sp, 15] // load argument again to wO 
add wO, wO, 1 // add 1 to it 
and wO, w0, 255 // mask out lowest byte 
b .L8 // branch to .L3 
.L2: 
mov  w0, 63 // set wO (ret. value) to '?' 
.L3: 
add Sp, sp, 16 // shift stack pointer back 
ret 
main 
stp x29, x30, [sp, -32]! // shift stack and store x regs 
mov x29, sp 
bl getchar 
strb wọ, [sp, 31 // store wO (ret. val.) to local var. 
ldrb w0, [sp, 31 // load it back to wO 
bl incrementDigit 
and wO, wO, 255 // mask out lowest byte 
bl putchar 
mov  w0, 0 // set ret. val. to 0 
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ld x29, x30, [sp], 32 // restore x regs 
re 


The [RISC-V](risc v.md) assembly may look like this: 


incrementDigit: 


addi sp, sp, -32 # shift stack (make room) 
SW s0,28(sp) 4 save frame pointer 
addi s0,sp,32 4 shift frame pointer 
mv 85, at 4 get arg. from a0 to a5 
sb a5,-17(s0 # save to to local var. 
lbu a4, -17(s0 4 get it to a4 
li 85,47 4 load 'O' to a4 
bleu a4,a5, .L2 # branch to .L2 if a4 <= a5 
lbu a4, -17 (s0) # load arg. again 
li 85,56 4 load '9' to a5 
bgtu a4,a5,.L2 4 branch to .L2 if a4 » a5 
Lbu a5, -17(s0) # load arg. again 
addi a5,a5,1 # add 1 to it 
andi a5,a5, Oxff # mask out the lowest byte 
d .L3 # jump to .L3 
li a5,63 # load '?' 
.L3: 
mv a0,a5 4 move result to ret. val. 
lw s0,28(sp) 4 restore frame pointer 
addi sp,sp,32 # pop stack 
jr ra 4 jump to addr in ra 
main: 
addi Sp, Sp, -32 # shift stack (make room) 
SW ra, 28(sp 4 store ret. addr on stack 
sw s0,24(s 4 store stack frame pointer on stack 
addi Sorsha # shift frame pointer 
call getchai 
mv ab,a0 4 copy return val. to a5 
sb 85,-17(s0 4 move a5 to local var 
lbu a5, -17 (s0 # load it again to a5 
mv a0,a5 4 move it to a0 (func. arg.) 
call incrementDigit 
mv a5,a0 # copy return val. to a5 
mv ad, a5 4 get it back to a0 (func. arg.) 
call putchar 
li 85,0 4 load 0 to a5 
mv a0,a5 4 move it to a0 (ret. val.) 
lw ra,28(sp 4 restore return addr. 
lw s0,24(sp 4 restore frame pointer 
addi Sp, Sp, 32 # pop stack 
air ra # jump to addr in ra 


---------- assertiveness.md ---------- 
# Assertiveness 


Assertiveness is an [euphemism](euphemism.md) for being a [dick](dick.md). 
T atan.md ---------- 
# Arcus Tangent 


Arcus tangent, written as *atan* or *tan^-1*, is the inverse [function](function.md) to the [tangent](tan.md) function. For given argument *x* (any real number) it returns a number *y* (from - 
[pi](pi.md)/2 to pi/2) such that *tan(y) = x*. 


ro Br oximationt^: Near 0 *atan(x)* can very rougly be approximated. Simpl by. *x*, For a, large argument *atan(x)* can be approximated by *pi/2.- 1/x* (as *atan*'s [limit](limit.md) is pi/2). The 
following formula { created by me -drummyfiSh } approximates atan with à ¥po¥tnamial} (polynomial Rd) for non-negative argument with error smaller than 2%: 
*atan(x) ~= (x * (2.96088 + 4.9348 * x))/(3.2 + 3.88496 * x + pi * x^2)* 
ly 
pi/2 T fisia 
re E 
-------- E AEE SEET AE NET See reg x 


OTe 2) Sr 4. 5 


-pi/2 T 


*plot of atan(x)* 
T atheism.md ---------- 
# Atheism 


*"In this moment I am euphoric ..."* --some retarded atheist 
An atheist is someone who doesn't believe in god or any other similar supernatural beings. 


An especially annoying kind is the ** reddit) (reddit md) atheist** who will. DESTROY YOU WITH. FACTS AND LOGICA(TM). These atheists.are 14 year old children who think they've discovered the secret 
of the universe and have to let the whole world know they're atheists who will destroy you with their 200 pe ses] 
(cognitive_bias.md) and argument fallacies, while in fact they reside at the mount stupid] (mount_stupid.m 
cringe. They masturbate to [Richard Dawkins](richard dawkins.md), love to read [soyentific Soyence md) studiiiiiies about how race has no biological meaning and think that religion is literally 
Hit er (nat terme) They like to pick easy targets such as hf latearthers] flat Garth md) and cyberbully them on [YouTube](youtube.md) with the power of SCIENCE and their enormously large i 
hesaurus (they will never use a word that's among the 100000 most common English words). They are so [Cringe](cringe.md) you want to [kill yourself](kys.md), but their discussions are Sometimes 
entertaining to read with a bowl of popcorn. 


Such a specimen of atheist is one of the best quality examples of a [pseudosceptic](pseudoscepticism.md). See also this: https://www.debunkingskeptics.com/Contents.htm. 


On a bit more serious note: we've all been there, most people in their teens think they're literal [Einsteins] (einstein. md) and then later_in life cringe back on themselves. However, some don't 
grow out of it and stay arrogant, ignorant fucks for their whole lives. The principal mistake of the stance they retain is they try to apply "science" (or whatever it means in their world) to 
VERYTHING and reject any other approach to solving problems -- of course, [Science](science.md) (the real one) is great, but it's just a tool, and just like you can't fix every problem with a 
hammer, you can't approach every problem with science. In your daily life you make a million of unscientific decisions and it would be bad to try to apply science to them; you cross the street 
not because you've read a peer-reviewed paper about it being the most scientifically correct thing to do, but because you feel like doing it, because you believe the drivers will stop and won't 
run you over. Beliefs, intuition, emotion, non-rationality and even spirituality are and have to be part of life, and it's extremely stupid to oppose these concepts just out of principle. With 
that said, there's nothing wrong about being a well behaved man who just doesn't feel a belief in any god in his heart, just you know, don't be an idiot. 


Among the greatest minds it is hard to find true atheists, even though they typically have a personal, and not easy to describe faith. [Newton] (newton md) was a Christian. [Einstein](einstein.md) 
often used the word "[God](god.md)" instead of "nature" or "universe"; even though hé said he didn't believe in the traditional personal God, he also said that the laws of physics were like 
books in a library which must have obviously been written by someone or something we can't comprehend. [Nikola Tesla](tesla.md) said he was "deeply religious, though not in the orthodox sense". 
There are also very hardcore religious people such as [Larry Wall](larry wall md), the inventor of [Per (pertum) language, who even planned to be a Christian missionary. The "true atheists" 
are mostly second grade "scientists" who make career out of the pose and make living by writing books about atheism rather than being Scientists. 


## See Also 


- [stupidity](stupidity.md) 
T1 audiophilia.md ---------- 
# Audiophilia 


Audiophilia is a mental disorder, similar to other diseases such as [gistrohopping](distrohopping md) and chronic pricing] (rice md) that makes one scared of low or normal quality audio. 
Audiophiles are scared of loser compression](compression.md) and so harm society Dy wasting storage space. Audiophilia, similarly to e.g. the business with [mechanical Keyloards | 
(mechanical keyboard.md), is the [as rology] astrology md) of technology, it is an arbitrarily invented bullshit business creating an artificial need that makes people wanna buy golden cables 
and similar shit in belief that it will make their life 

T autoupdate.md ---------- 

# Autoupdate 


happier, perpetuation consumerism and [capitalism](capitalism.md). 


Autoupdate is a malicious [software] (software md) [feature](feature.md) that frequently remotely modifies software on the user's device without asking, sometimes silently and many times in a 
forced manner without the possibili to refuse this modification (typical l in proprietary] (proprietary md) poftware); This is a manifestation of [update culture](update_culture.md). These 
remote software modifications are called "updates" to make the user ink they are a good thing, but in fact they usually introduce more [bugs] (bug md). [bloat] (bloat. md), security 
vulnerabilities, annoyance (forced reboots etc.) and [malware](malware.md) (even in "[open source](open_source.md)", see e.g. the many projects on [GitHub](github.md) that introduced intentional 
malware targeted at Russian users during the Russia-Ukraine war). 

T1 avpd.md ---------- 

# Avoidant Personality Disorder 


TODO 


In many cases avoiding the problem really is the objectively best solution. 
T1 axiom of choice.md ---------- 
# Axiom Of Choice 


In mathematics] (math md) (specifically [set theory] (set_theory md) axiom of choice is a possible [axiom] (axiom md) which basically states we can arbitrarily choose elements of sets and which 
is famous for being controversial and problematic because it causes trouble both when we accept or reject it. Note that this topic Can go to a great depth and lead to philosophical debates, 
there is a huge rabbit hole and mathematicians can talk about this for hours; here we'll only state the very basic and quite simplified things, mostly for those who aren't professional 
mathematicians but need some overview of mathematics (e.g. programmers). 


Indeed, **what really IS the axiom of choice?** It is an [axiom] (axiom md), .i.e. something that we.can't,prove but can either accept or reject as a basic fact so that we can use it to prove 
things. Informally it says that given any collection of séts (evén an infinite collection of infinitely large sets), we can make an arbitrary selection of one element from each set. More 
mathematically it says: if we have a collection of sets, there always exists a [function](function.md) *f* such that for any set *S* from the collection *f(S)* is an element of *S*. 


This doesn't sound weird, does it? Well, in many normal situations it isn't. For example if we have finitely many sets, we can Simply write out each element of the set, we don't need to define 
any selection function, So we don't need axiom of choice to make our choice of elements here. But also if we have infinitely many Sets that are well ordered (we can compare elements); for 
example infinitely many sets of [natural numbered (natural: nümber. md); we can simply define a function that takes eig: the smallest number from each set -- here we don't need axiom of choice 
either. The issues start if we hāve e.g. infinitely many sets of [real numbers](real_number.md) (which can't be well ordered without the axiom of choice, consider that e.g. open intervals don't 
have lowest number) -- here we can't say how a function should select one element from each set, so we have to either accept axiom of choice (we say it simply can be done "somehow", e.g. by 
writing each element out on an infinitely large paper) or reject it (we say it can't be done). Here it is again the case that what's normally completely non-problematic starts to get very weird 
once you involve [infinity](infinity.md). 


**why is it problematic?** Once you learn about axiom of choice, your first question will probably be why should it pose any problems if it iust seems like an obvious fact. Well, it turns out it 
leads to strange things. If we accept axiom of choice, then some weird things happen, most famously e.g. the pBanach. Tarski paradox](banach tarski.md) which uses the axiom of choice to prove 
that you can disassemble a sphere into finitely many pieces, then move and rotate them so that they create TW 


new spheres, each one identical to the original (i.e. you duplicate the original 
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sphere). But if we reject the axiom of choice, other weird things happen, for example we can't prove that every vector Space has a basis -- it seems quite elementary, that every vector space 
should have a basis, but this can't be proven without the axiom of choice and in fact accepting this implies the axiom of choice is true. Besides this great many number of proofs simply don't 
work without axiom of choice. So essentially either way things get weird, whether we accept axiom of choice or not. 


**So what do mathematicians do?** How.do.they deal with this and why don't they kill themselves? Well, in reality most of.them are pretty chill and don't really care, they try avoid it if they 
can (their proof is kind of stronger if it relies on fewer axioms) but they accept it if they really need it for' a specific proof. Many elementary things in mathematics actually rely on axiom of 
choice, so there's no fuzz when someone uses it, it's very normal. Turns out axiom of choice is more of something they argue over a beer, they usually disagree about whether it is INTUITIVELY 
true or false, but that doesn't really affect their work. 

---------- backpropagation.md ---------- 

# Backpropagation 


{ Dunno if this is completely correct, I'm learning this as I'm writing it. There may be errors. ~drummyfish } 


Backpropagation, or backprop, is an [algorithm] (algorithm. md), based on the chain rule of derivation, used in training [ngurat networks](neural network .md) ; it computes the partial derivative 
(or gredent] (gradient hat) of the funčtion of t network'$ error so that we can perform a [gradient descent (gradien __descent.md), i.e. update the weights towards lowering the network's 
error. It computes the analytical derivative (theoretically you could estimate a derivative numerically, but that's not so accurate and can be too computationally expensive). Backpropagation is 


one of the most common methods for training neural networks but it is NOT the only possible one -- there are many more such as [evolutionary programming](evolutionary programming.md). It is 
called backpropagation because it works backwards and propagates the error from the output towards the input, due to how the chain rule works, and it's efficient by reusing already computed 
values. 

## Details 


Consider the following neural network: 


\/w010 \/wi10 VE 
ANOOI /Nw101 ri 


X1------ yi------ zi 
w011 w111 


It has an input layer (neurons *xO*, *x1*), a hidden layer (neurons *yO*, *yi*) and an output layer (neurons *zO*, *z1*). For simplicity.there are no biases (biases can easily be added as input 
neurons that are always on). At the'end there is a total error *E* computed from the networks's output against the desifed output (training data). 


Let's say the total error is computed as the squared error: *E = squared error(z0) + squared error(zi1) = 1/2 * (z0 - z0O desired)^2 + 1/2 * (z1 - zi desired)^2*. 
We can see each non-input neuron as a function. E.g. the neuron *z0* is a function *zO(x) = z0(a(z0s(x)))* where: 


- *z0s* is the sum of inputs to the neuron, in this case *zOs(x) = w100 * yepo + *110 * y1(x)* 
*a* is the activation function, let's suppose the normally used [logistic function](logistic function.md) *a(x) = 1/(1 + e^x)*. 


If you don't know what the fuck is going on see [neural networks](neural network.md) first. 


What is our goal now? To find the **[partial derivative] (partial derivative.md) of the whole network's total error function** (at the current point defined by the weights), or in other words the 

**gradient** at the current point. I.e. from the point view of the total erfor (which is just a number output by this system), the network is a function of 8 variables (weights *w000*, 

*w001*, Be} and we want to find a derivative of this function in respect to each of these variables (that's what_a partial derivative is) at the current point (i.e. with current values of the 

weights). This will, for each of these variables, tell us how much (at what rate and in which direction the total error changes if we change that variable by certain amount. Why do we need to 

know this? So that we can do a [gradient descent (gradient descent md), i.e. this information is kind of a direction in which we want to move (change the weights and biases) towards lowering the 

total error (making the network compute results which are closer to the training data). So all in all the goal is to find derivatives (just numbers, slopes) with respect to *w000*, *w001*, 
w111*. 


*w010*, ... 
Could we do this without backpropagation? Yes -- we can use [pumerical| (numerical, md algorithms to estimate derivatives, the simplest one would be to just, try to change each weight, one by one, 
by some small number, let's say *dw*, and see how much such Change changes the output error. I.e. we would sample the error function in all directions which could give' us an idea of the slope in 


each direction. However this would be pretty slow, we would have to reevaluate the whole neural network as many times as there are weights. Backpropagation can do this much more efficiently. 


Backpropagation is based on the **[chain rule](chain rule.md)**, a rule of derivation that equates the derivative of a function composition (functions inside other functions) to a product of 
derivatives. This is important because by converting the derivatives to a product we will be able to **reuse** the individual factors and so compute very efficiently and quickly. 


Let's write derivative of *f(x)* with respect to *x* as *D{f(x),x}*. The chain rule says that: 
*D(f(g(x)),x3 = D{f(g(x)),g(x)} * D{g(x),x}* 
Notice that this can be applied to any number of composed functions, the product chain just becomes longer. 


Let's get to the computation. Backpropagation work by going "backwards" from the output towards the input. So, let's start by computing the derivative against the weight *w100*. It will be a 
specific number; let's call it *'w100*. Derivative of à sum is equal to the sum of derivatives: 


*'w100 = D{E,w100} = D(squared error(z0),w100) + D{squared_error(z0),w100} = D(squared error(z0),w100) + 0* 

(The second part of this sum became © because with respect to *w100* it is a constant.) 

Now we can continue and utilize the chain rule: 

*'w100 = D{E,w100} = D(squared error(z0),w100) = D(squared error(z0(a(z0s))),w100) = D(squared error(z0),z0) * D(a(z0s),zOs) * d(z0s,w100)* 

We'll now skip the intermediate steps, they should be easy if you can do derivatives. The final results is: 

*'w100 = (zO desired - z0) * (zOs * (1 - z0s)) * yo* 

**Now we have computed the derivative against w100**. In the same way can compute *'w101*, *'w110* and *'w111* (weights leading to the output layer). 


Now let's compute the derivative in respect to *w000*, i.e. the number *'w9000*. We will proceed similarly but the computation will be different because the weight *w000* affects both output 
neurons ('zO' and 'z1'). Again, we'll use the chain rule. 


*w000 = D(E,w000) = D(E,y0) * D(a(y0s),y0s) * D(yOs,w000)* 

*D(E,y0) = D(squared error(z0),y0) + D{squared_error(z1),y0}* 

Let's compute the first part of the sum: 

*D{squared_error(z0),y0} = D(squared error(z0),z0s) * D(squared error(z0s), yO}* 
*D(squared error(z0),z0s) = D(squared error(z0),z0) * D(a(z0s)),z0s)* 

Note that this last equation uses already computed values which we can reuse. Finally: 
*D(squared error(z0s),y0) = D(squared error(w100 * yO + w110 * y1),y0} = w100* 

And we get: 

*D{squared_error(z0),y0} = D(squared error(z0),z0) * D(a(z0s)),z0s) * w100* 

And so on until we get all the derivatives. 


Once we have them, we multiply them all by some value (**learning rate**, a distance by which we move in the computed direction) and subtract them from the current weights by which we perform 
the gradient descent and lower the total error. 


Note that here we've only used one training sample, i.e. the error *E* was computed from the network against a single desired output. If more example are used in a single update step, they are 
usually somehow averaged. 


{ I am too young to remember this shit so I'm just writing what I've read on the web. -drummyfish } 


Bulletin board system (BBS) is, or rather used to be, a kind of (server ] (server .md) that hosts a community of users who connect to it via [terminal](terminal.md), who exchange messages, files, 
play [games] (game md) and Otherwise interact -- BBSeS were mainly popul: before the invention of [web](www.md), i.e. from about 1978 to mid 1990s, however some still exist today. BBSes are 


powered by special BBS [software](software.md) and the people who run them are called sysops. 


Back then people connected to BBSes via dial-up [modems] (modem md) and connecting was much more complicated than connecting to a server today: yoy. had to literally dial the number of the BBS and 
you could only connect if the BBS had a free line. **Early BBSes weren't normally connected through Internet** but rather through other networks like [UUCP](uucp.md) working through phone lines. 
I.e. a BBS would have a certain number of modems that defined how many people could connect at once. It was also expensive to make calls into other countries so BBSes were more of a local thing, 
people would connect to their local BBSes. Furthermore these things ran often on non-[multitasking](multitasking.md) systems like [DOS](dos.md) so allowing multiple users meant the need for 
aving multiple computers. The boomers who used BBSes talk about great adventure and a sense of intimacy, connecting to a BBS meant the sysop would see you connecting, he might start chatting 
with you etc. Nowadays the few existing BBSes use protocols such as [telnet](telnet.md), nevertheless there are apparently about 20 known dial-up ones in north America. Some BBSes evolved into 
more modern communities based e.g. on [public access Unix](pubnix.md) systems -- for example [SDF](sdf.md). 


A BBS was usually focused on a certain topic such as technology, fantasy [roleplay](rolaplay.md), dating, [warez](warez.md) etc., they would typically greet the users with a custom themed [ANSI 
artj(anei_art md} welcome page upon login -- it was pretty cool. 


{ There's some documentary on BBS that's upposed to give you an insight into this shit, called literally *BBS: The documentary*. It's about 5 hours long tho. ~drummyfish } 


The first BBS was CBBS {computerized bulletin board system) created by Ward Christensen and Randy Suess in 1978 during a blizzard storm -- it was pretty primitive, e.g. it only allowed one user 
to be connected at the time. After publication of their invention, BBSes became quite popular and the number of them grew to many thousands -- later there was even a magazine Solely focused on 
BBSes (BBS Magazine*). BBSes would later group into larger networks that allowed e.g. interchange of mail. The biggest such network was [FidoNet](fidonet.md) which at its peak hosted about 
35000 nodes. 


{ Found some list of BBSes at http://www.synchro.net/sbbslist.html. ~drummyfish } 
## See Also 


public_access Unix](pubnix.md) 
Usenet] (usenet .md) 

modem world] (modem_wor ld.md) 
tildeverse](tildeverse.md) 
T beauty.md ---------- 
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Beauty is.the quality of being_extremely appealing and pleasing. Though the word will likely invoke association with traditional [art](art.md), in [technology] (technology -md) , [engineering] 
(engineering .m Fs [mathematics] (mach md) and other [science |(s aence md) beauty is, despite it's relative vagueness and subjectivity, an important aspect of désign, and in fact this 
tesenenati(al De E ad] lots of times some clearly defined shapes -- for example [simplicity](kiss.md) is mostly considered beautiful. Beauty is similar to and many times synonymous with 
elegance](elegance.md). 


Beauty can perhaps be seen as a heuristic] (heuristic md) a touch of intuition that guides the expert in exploration of previously unknown fields, as we have come to learn that the greatest 
discoveries tend to be very beautiful (however there is also an opposite side: some people, such as Sabine Hossenfelder, criticize UR the pursuit of beautiful theories in modern physics as 
this approach seems to be have led to stagnation). Indeed, beginners and [noobs](noob.md) are mostly concerned with learning hard facts, learning standards and getting familiar with already 
known ways of solving known problems, they often aren't able to recognize what's beautiful and what's ugly. But as one gets more and more experienced and finds himself near the borders of 
current knowledge, there is suddenly no guidance but intuition, beauty, to suggest ways forward, and here one starts to get the feel for beauty. At this point the field, even if highly exact and 
rigorous, has become an [art](art.md). 


What is beautiful then? As stated, there is a lot of subjectivity, but generally the following attributes are correlated with beauty: 


- **[simplicity](minimalism.md)**, typically finding pimplicity in complexity, e.g. a very, short formula or algerithm that describes an ipfinitely complex [fractal](fractal.md 
but valuable equation in physics (*e =m * C^2*), a short computer program that yields rich results ([demoscené](demoscene.md), [code golfingl(go f^md), [suckless](Suckless.md 
- x qengrality"s, i.e. if a simple equation can describe many problems, not quse a specific case. 

- **lack of exceptions**, i.e. when our equation works without having to deal with special cases (in programming represented by 'if-then' branches). 


- ** [symmetry] (symmetry .md)** i.e. when we can e.g. swap variables in the equation and eeu some kind of opposite result. 


shape, a simple 
es Ls 


E j«Unificgtion" T4586. Xf multiple nice things meet, for example the [Euler's identity](eulers identity.m brings together into one equation the most important numbers in mathematics: *i*, 
pi and 9. 
- aesthetics**, either of the equation itself or the generated thing (fractals, attractors, ...). 
** 
- TODO 


Examples of beautiful things include: 


**Euler's identity**, an equation often cited as the most beautiful in mathematics: *e^[i*pi) + 1 = 0*. It is simple and contains many of the most important numbers: *e*, *pi*, *i* 1 and 0. 
** [minimalist software](suckless.md)**, **[Unix philosophy](unix philosophy.md)** 

fractals](fractal.md) TODO 

bytebeat](bytebeat.md) 

- -- bilinear .md 
Bilinear Interpolation 


dE rrr 


Bilinear interpolation (also bilinear filtering) is,a simple way of creating a smooth transition ({interpolation (interpolation.md)). between discrete] discrete.md) samples (values) in 2D, it is 
a [generalization](generalization.md) of [linear interpolation {ver p-nd) to 2 dimensions. It is used in many places, popularly e.g. in 3D [computer gr pass] (graphics md for [texture 

texture- md) filtering; bilinear interpolation allows to upscale textures to higher resolutions (i.e. compute new pixels between existing pixels) while keeping their look smooth and "non-blocky" 
even though blurry). On the scale of quality vs simplicity it is kind of a middle way between a simpler [nearest neighbour](nearest neigh our md) interpolation (which creates the "blocky" look) 
and more complex [bicubic qnrerpolation]ibicubic md) (which uses yet smoother curves but also requires more samples). Bilinear interpolation can further be generalized to [trilinear 
interpolation](trilinear.md) (in computer graphics trilinear interpolation is used to also adda tionally interpolate between different levels of a texture's fmlpamap] (mipamp-md)) and perhaps even 
bilinear [extrapolation](extrapolation.md). Many frameworks/libraries/engines have bilinear filtering built-in (e.g. 'GL LINEAR^ in [OpenGL](ogl.md)). 
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*The above image is constructed by applying bilinear interpolation to the four corner values.* 


The principle is simple: first linearly interpolate in one direction (e.g. horizontal), then in the other (vertical). Mathematically the order in which we take the dimensions doesn't matter (but 
it mày matter practically due to rounding errors etc.). 


Example: let's say we want to compute the value *x* between the four following given corner values: 


T. ME 5 
Dx 
8 Pu 3 
Let's say we first interpolate horizontally: we'll compute one value, *a*, on the top (between 1 and.5)_and_one value, *b*, at the bottom (betyeen 8 and 3). When computing, *a* we, interpolate 
between and 5 by the horizontal position of *x* (4/ 5 So we get *a = 1 + 4/7 * (5 - 1) = 23/7*. Similartly *b = 8 + 4/7 * (3 - 8) = 36/7*. Now we interpolate between *a* and *b* vertically 
value *x = 23/7 + 5/7 * (36/7 - 23/7) = 226/49 ~= 4.6*. If we first interpolate vertically and then horizontally, we'd get the same result 


by the_ vertical position of *x*, 5/7) to get_the fina 2 
the value between 1 and 8 would be 6, the value between 5 and 3 would be 25/7 and the final value 226/49 again). 


Here is a [C](c.md) code to compute all the inbetween values in the above, using [fixed point](fixed_point.md) (no [float](float.md)): 


#include <stdio.h> 

#define GRID_RESOLUTION 8 

int interpolateLinear(int a, int b, int t) 
return a + (t * (b - a)) / (GRID_RESOLUTION - 1); 

int interpolateBilinear(int topLeft, int topRight, int bottomLeft, int bottomRight, 
int x, int y) 

fietine FPP 16 // we'll use fixed point to prevent rounding errors 


#if 1 // switch between the two versions, should give same results: 
// horizontal first, then vertical 


int a = interpolateLinear(topLeft * FPP topRight * FPP,x); 
int b interpolateLinear(bottomLeft * FPP, bo tomRight * FPP, x); 
return interpolateLinear(a,b,y) / FPP; 


#else 
// vertical first, then horizontal 
int a= interpolateLinear topLeft * FPP,bottomLeft * FPP,y); 
int b = interpolateLinear(topRight * FPP,bottomRight * FPP,y); 
return interpolateLinear(a,b,x) / FPP; 

#endif 

} 

int main(void) 
for (int y = 0; y < GRID_RESOLUTION; ++y) 


for (int x = 0; x < GRID RESOLUTION; ++x) 
printf("9d ",interpolateBilinear(1,5,8,3,x,y)); 
} putchar('\n'); 


return 0; 


The program outputs: 


ONO RWNE 
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---------- billboard.md ---------- 
# Billboard 


In [3D](3d.md) [computer graphics 
of [aen t nba rey e385 EL nd 
tro gam g 


J'arapráes ama) billboard is a flat image placed in the scene that rotates so that it's always facing the camera. Billboards used to be greatly utilized instead 
and even outside re es, e. 


in old [games] (game -md) ; thanks to being faster to render (and possibly also easier to create than full 3D models), but we can still encounter them even toda 
[partic icle system.md) are normally rendered with billboards (each particle is one billboard). Billboards are also commonly called *[sprites 


e systems](par 
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(sprite.md)*, even though that's not exactly accurate. 
There are two main types of billboards: 


- Ones **rotating only about vertical axis**, i,e. billboards, that change only their [yaw] (yaw. md), they only face the camera in a top-down view.of the.scene. Such sprite may deform on the 
screen (when the camera is at different height level) just like 3D models do and when viewed completely from above will disappear completely. This may in some situations look better than other 
options (e.g. in [games](game.md) enemies won't appear lying on their back when seen from above). 

- **Freely rotating** ones, i.e. ones that change all three [Euler angles] (euler-angle mdp so that they ALWAYS face the camera from any possible angle. There may further be other two subtypes: 
billboards that align themselves with the camera's projection plane (they simply rotate themselves in the same way as the camera) which always end up on the screen as an undeformed and unrotated 
image, and billboards that face themselves towards the camera's position and copy the camera's [roll](roll.md) (though these may seem like two same things, they are not, for the latter we need 
to now the camera and billboard's positions, for the former we only need the camera's rotation). The former is simpler to implement and may also look better, So we normally don't even consider 
the latter. 


Some billboards also choose their image based on from what angle they're viewed (ta an enemy in a fane viewed from the front will use.a different image than when viewed from the side, as seen 
e.g. in [Doom](doom.md)). Also some billboards intentionally don't scale and keep the same size on the screen, for example health bars in some games. 


In older software billboards were implemented simply as image [blitting] (blit md), „i.e. the billboard's scaled image would literally be copied to the.screen.at the appropriate position, (this 
would implement the freely rotating billboard). Nowadays when ender ing D models is no longer really considered harmful to performance and drawing pixels directly is less convenient, billboards 
are more and more implemented as so called [textured](texture.md) [quads](quad.md), i.e. they are really a flat square 3D model that may pass the same pipeline as other 3D models (even though in 
Some frameworks they may gewuatly have different [vertex shaders (vertex_shader .md] etc.) and that's simply rotated to face the camera in each frame (in Pmodern] (modern .md) frameworks there are 
specific functions for this). 


Fun] (fun md) fact: in the old games such as [Doom](doom.md) the billboard images were made from photographs of actual physical models from clay. It was easier and better looking than using the 
rimitive 3D'software that existed back then. 


## Implementation Details 
The following are some possibly useful things for implementing billboards. 


The billboard's position.on the screen can be computed by projecting its center point in [world coordinates](world space.md) with [modelview](modelview.md) and [projection](projection.md) 
matrices, just aS we project vertices of 3D models. 


The.billboard's size on the screen shall due to Jperspective](perspective.md) be multiplied by *1 / (tan(FOV / 2) * z)* where *FOV* is the camera's [field of view] (fov md and *z* is the 
billboard's distance from camera's projection plane (which i OT equal to the mere distance from the camera's pósitión, that would create a [fisheyé](fisheye.md) tens effect -- the distance 
from the projection plane can be obtained from the above mentioned [projection matrix](projection.md)). (If the camera's FOV is different in horizontal and vertical directions, then also the 
billboard's size will change differently in these directions.) 


For billboards whose. images. depends on ylewing angle we naturally need to compute the angle. We may do this either in 2D or 3D -- most games resort to the simpler 2D case (only considering 
viewing angie in a singlé plane parallel to the floor), in which case we may Simply use the combination of [dot product] (dot product maf and [cross product](cross product.md) between the 
[normalized](normalization.md) billboard's direction vector and a normalized vector pointing from the billboard's position towards the camera's position (dot product gives the [cosine](cos.md) 
of the angle, the sign of cross product's vertical component will give the rest of the information needed for determining the exact angle). Once we have the angle, we [quantize](quantization.md) 
divide) it, i.e. drop its precision depending on how many directional images we have, and then e.g. with a [switch](switch.md) statement pick the correct image to display. For the 3D case 
possible different images from different 3D positions) we may first transform the sprite's 3D facing vector to [camera space](camera space.md) with appropriate matrix, just like we transform 3D 
models, then this transformed vector will (again after quantization) directly determine the image we should use. 


When implementing the free rotating billboard.as a 3D quad. that's aligning with the camera Projection plane, we can construct the [model matrix](mogdel matrix md) for the rotation from the 
camera's normalized directional vectors: *R* is camera's right vector, *U* is its up vector and *F* is its forward vector. The matrix simply transforms the quad's vertices to the coordinate 
system with bases *R*, *U* and *F*, i.e. rotates the quad in the same way as the camera. When using [row vectors](row vector.md), the matrix is following: 


T bill gates.md ---------- 
# Bill Gate$ 


William "Bill" Gates (28.10,1955 -- TODO) is a [mass murderer and rapist](entre reneur.md) (i.e. [capitalist ](ca italism.md)) who established and. led the.terrorist organization [Micro$oft 
(microsoft.md). He is one of the most rich and évil individuals in nastoly who took over the world by force establishing the’ [malware] (malware.md Operating system Teancows | (win ows.md) as the 
common operating system, nowada S being. dan erous especially by hiding behind his "charity organization" (see [charitywashing[(charitywashing.md)) which has been widely criticized (even by such 
mainstream media as [wikipedia] (wikipe ia.md)) but which nevertheless makes him look as someone doing "public good" in the eyes of the naive brainless NPC masses. 


He is really dumb, only speaks one language and didn't even finish university. He also has no moral values, but that goes without saying for any rich businessman. He was owned pretty hard in 
[chess](chess.md) by Magnus Carlsen on some shitty TV show. 


When Bill was born, his father was just busy counting dollar,bills, so he named him Bill. Bill was mentally [retarded](retard.md) as a child and as such had tọ attend a private school. He never 
really understood programming but with a below average intelligence he had a good shot at succeeding in [business](capitalism.md). Thanks to his family connections he got to Harvard where he met 
[Steve Ballmer](steve_ballmer.md) -- later he dropped out of the school due to his low intelligence. 


In 1975 he founded {Microsoft ] (microsoft md), a Gmalware] (malware md) company named after his dick. By a sequence of extremely lucky events combined with a few dick moves by Bill the company 
then became successful: when ound the year 1980 [IBM](ibm.md) was Creating the [IBM PC](ibm_pc.md), they came to Bill because they needed an [operating System] (os md}: He lied to them that he 
had one and sold them a license even though at the time he didn't have any OS (lo li After that he went to a programmer named Tim Paterson and basically stole (bought for some penny) his OS 
named QDOS and gave it to IBM, while stil keeping ownership of the OS (he only sold IBM a license to use it, not exclusive rights for it). He basically fucked everyone for money and got away 
with it, the [American](usa.md) way. For this he is admired by Americans. 

T1 binary.md ---------- 

& Binary 


The word binary in general refers to having two choices; in {computer science] (compsci.md) binary refers to the base 2 numeral system, i.e. a,system of writing numbers with only two symbols, . 
usually [1](oné.md)S8 and [0](zero.md)s. We can write any number in binary just as we can with our everyday [decimal](decimal.md) system, but binary is more convenient for computers because this 
system is easy to implement in electronics] electronics me) (a switch can be on or off, i.e. 1 or 0; systems with more digits were tried but unsuccessful, they failed miserably in reliability). 
The word *binary* is also by extension used for non-textual computer [files](file.md) such as native [executable](executable.md) programs or asset files for games. 


One binary, digit can be,used to s 


d n S tore exactly 1 [bit](bit.md) of rmation](information.md). So the number of places we have for writing.a binary number (e.g. in computer memory) is called a 
number of bitS or bit **width**. A 6 ànd 11). 


e info ui 
bit width *N* allóws for iced 2^N values (e.g. with 2 bits we can store 4 values: 0, 1, 2 and 3, in Binary 00, 01, 


At the basic, level binary works just like the [decimal](decimal.md) (base 10) system we're used to. While the decimal system uses powers of 10, binary uses powers of 2. Here is a table showing a 
few numbers in decimal ahd binary: 


decimal binary 


* O-MOUBRONHÍ|O 
H 
o 
© 


Let's have a number that's written as 10135 


**Conversion to decimal**: let's see an, example that utilizes the, facts, mentione bove. : nbe in d 
E (105); the third digit (1) says the number of 10^(2 
15), the )s $ 


3 d 
number of 10^(0)s (1s) in the number, the second digit (3) says the number of 10^( 
**100101** in binary, the first digit from the rignt (1) says the number of 2^(0)s 
etc. Therefore this binary number can be converted to decimal by simply computing 


imal. The first digit from the right (5) says the 
(100s) etc. Similarly if we now have ‘a’ number 
second digit (0) says the number of 2^(1 " 


the third digit (1) says the number of 2^(2)s (4s) 
AO + O * 2A1 + 1 * 242 + O * 243 +O * 24441 


1+ 4+ 32 = **37**, 


To **convert from decimal** to binary we can use a.simple [glgoritbm|(algorithm md) that's again derived from the above, Let's say we have a number *X* we. want to write in binary. We will write 
digits from right to left. The first (rightmost) digit is the remainder after integer division of *X* by 2. Then we divide the number by 2. The second digit is again the remainder after division 
by 2. Then we divide the number by 2 again. This continues until the number is 0. For example let's convert the number 22 to binary: first digit = 22 % 2 = **0**; 2 


2 = 11, second digit = 11 
% 2 = **1**; 11 / 2 = 5; third digit = 5 % 2 = **1**; 5/2=2; 2% 2 = **0**; 2/2=1; 1% 2 = **1**; 1 / 2 = 0. The result is **10110**. : 


TODO: operations in binary 


In binary it is very simple.and fast to divide and gultiply by.powers of 2 (1, 2, 4, 8, 16, ...), just as it is simply to divide and multiple by powers of 10 (1, 10, 
(we just shift the radix point, e.g. the binary number 1011 multiplied by 4' iS 101100, we just áüdéd two zeros at the end). This is why as a programmer **you should 
two** (your programs can be faster if the computer can perform basic operations faster). 


Q, 00, ...).in decimal 
prefer working with powers of 


**Binary can be very easily converted to and from [hexadecimal] (hexadeciaml.md) and. focfal] (octal .md)** because_1 hexadecimal (octal) digit always maps to exactly 4 (3) binary digits. E.g. the 
hexadeciaml number FO is 11110000 in binary (1111 is always equaivalent to F, 0000 is always equivalent to 0). This doesn't hold for’ the decimal base, hence programmers often tend to avoid base 
10. 


We can work with the pinary representation the same way as with decimal, i.e. we can e.g. write negative numbers such as -110101 or [rational numbers](rational number.md) (or even [real numbers] 
(real number.md)) such as 1011.001101. However in a computer memory there are no other Symbols thah 1 and ©, so we can't use extra symbols such as *-* or *.* to represent Such valués. So if we 
want to represent more numbers than non-negative integers, we literally have to only use 1s and Os and choose a specific **representation**/**format**/encoding of numbers -- there are several 
formats for representing e.g. [signed](signed.md) (potentially negative) or rational (fractional) numbers, each with pros and cons. The following are the most common number representations: 


- **[two's complement](twos complement.md)**: Allows storing integers, both positive negative and zero. It is **probably the most common representation** of integers because of its great 
advantages: basic operations (+, -, *) are performed exactly the Same as wit “normat. binary numbers, and there is no negative zero (which would be an inconvenience and waste of memory). 
Inverting a number (from negative to positive and vice versa) is done simply by inverting all the bits and adding 1. The leftmost bit signifies the number's sign (0 = +, 1 - -). 

2 [st namggnitude](sign magnitude.md)**: Allows storing integers, both positive, negative and zero. It's pretty straightforward: the. leftmost bit, in a number, serves as a, sign.(0, means, +, 1 
mean = and the re of the number is the distance from zero in "normal" representation. So e.g. a 4 bit number 0011 iS 3 while 1011 is -3 (note that we have to know the bit width of the number 
here, e.g. on 8 bits -3 would be 10000011). The disadvantage is there are two values for zero (positive, 0000 and [negative](negative zero.md), 1000) which wastes a value and presents a 
computational inconvenience, and operations with these numbers are more complicated and slower (checking the sign requires extrà code). 

- **[one's gonpigment](ones-complement md)"*: Allows storing integers, both positive, negative and zero, The leftmost bit signifies a sign, in the same way as with sign-magnitude, but numbers 
are inverted differently: a positive numbér is turned into negative (and vice versa) by inverting all bits. So e.g. 0011 is while 1100°is -3 (again, bit width matters). The disadvantage is 
nere are two values for zero (positive, 0000 and [negative](negative zero.md), 1111) which wastes a value and presents a computational inconvenience, and some operations with these numbers may 
e more complex. 

- "e [rixed Point](fixed point md)'^: „Allows storing [rational numbers](rational number.md) (fractions),.i.e. numbers with a radix point (such as 191,011), which can also be positive, negative 
or zéro. It works by amagining a radix point at some fixed position in the binary representation, e.g. if we have an 8 bit number, we may consider 5 leftmost bits to represent the whole part and 
3 rightmost bits to be the fractional part (so e.g the number 11010110 represents 11010 110) - The advantage here is extreme simplicity (we can use normal integer numbers as fixed point simply by 
imagining a radix point). The disadvantage may be low precision and small range of representable values. 

-,**[floating point](float.md)**:; Allows storing {rational numbers](rational number.md) in great ranges, .both positive, negative and zero, plus some additional values such as, [infinity] 

infinity md] and *[hot a numDer](nan.md)*. It áltows the radix point to be shifted which gives a potential for storing extremely big and extremely small numbers at the same time. The 
isadvantage is that float is extreme ly complex, [bloated] (bloat md), wastes some values and for fast execution requires a special hardware unit (which most "normal" computers nowadays have, but 
are missing e.g. in some [embedded systems] (embedded.md) ). 


AS anything can be represented with numbers, binary can be used to store any kind of information such as text, images, sounds and videos. See [data structures](data_structure.md) and [file 
formats](file_format.md). 


## See Also 


- [bit](bit.md 
- [hexadecimal (hexadeciam b: md) 

- [De Morgan's aws | (de-morgans.- Laws md) 
- [data structure](data structure.md) 

- [data type](dataà type.md) 

T----- bit hack.md ---------- 

# Bit Hack 
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Bit [hacks](hacking.md) or bit tricks are simple clever formulas for performing useful operations with [binar (binary md) numbers. Some operations, such as checking if a number is power of two 
or reversing bits in a number, can be done very efficiently with these hacks, Without using loops [branchin i branchless.md) and other undesirably slow operations, potentially increasing speed 
and/or decreasing size and/or memory usage of Code -- this can help us [optimize] (optimiza ion.md). Many of ese can be found on the [web](www.md) and there are also books such as *Hacker's 
Delight* which document such hacks. 


## Basics 


Basic bit manipulation techniques.are common and part of general knowledge so they won't be listed under hacks, but for sake of completeness and beginners reading this we should mention them 
here. Let's see the basic bit manipulation operators in [C](c.md): 


- ali (bitwise JOR] (or. md): Performs the logical OR on all corresponding bits of two operands, Eag: "0b0110 0b1100' gives 1110 (14 in decimal). This is used to set bits and combine flags 
(options) into single numeric value that can easily be passed to function etc. For example to set the lowest bit of a number to just do "myNümber | 1°. Now consider e.g. ‘#define OPTION_A 
60b0001', “#define OPTION B 0b0010' and “#define OPTION C 0b0100', now we can make a single number that represents a set of selected options e.g. as “OPTION_C | OPTION B' (the value will be 
^0101' and says that options B and C have been selected). 

- "'& (bitwise TANDI (and mdp) : Performs the logical AND on all corresponding bits of two operands, e.g. '0b0110 & 0b1100" ,giveg 0100 (4 in decimal). This may be used to mask out specifig bits, 
to check if specific bits afé set (useful to check the set flags as mentionéd above) or to clear (set to zero) specific bits. Consider the flag example from above, if we want to check if value 
*x* has e.g. the option B set, we simply do `x & OPTION B' which results in non-zero value if the option is set. Another example may be "myNumber & 0b00001111' (in practice you'll see 
hexadecimal values, i.e. ~“myNumber & OxOF') which masks out the lowest 4 bits of *myNumber* (which is equivalent to the operation [modulo](mod.md) 16). 

- `~` (bitwise [NOT](not.md)): Flips every bit of the number -- pretty straightforward. This is used e.g. for clearing bits as "x & -(1 << 3)' (clear 3rd bit of *x*). 

- `^` (bitwise [XOR](xor.md Performs the logical XOR on all corresponding bits of two operands, EN ^0b0110 ^ 0b1100' gives 1010 (10 in decimal). This is used to e.g. flip specific bits. 

- "«« and `>>` (binary shi left/right): Performs bitwise shift left or right (WATCH OUT: shifting by data tyi e width or more is undefined behavior in E This is typically used to perform 
fast mutiiplicatron (left) and division (right) by powers of two (2, 4, 8, 16, ...), just as we can quickly multiply/divide by 10 in decimal by shifting the decimal point. E.g. “5 << is the 
same as = = 40. 


## Specific Bit Hacks 
{ Work in progress. I'm taking these from various sources such as the *Hacker's Delight* book or web and rewriting them a bit, always testing. Some of these are my own. ~drummyfish } 


Unless noted otherwise we suppose [ed (cmd) syntax and semantics and integer [data types] (data type md). Keep in.mind all potential dangers, for example it may sometimes be better to write an 
acromatic code and tet compi er do thé optimization that's best for given platform, also òf course readability will worsen etc. Neverthéless as a hacker you should know about these tricks, it's 
useful for low level code etc. 


**2AN**; ^1 << NC 
**[absolute value](abs.md) of x ([two's complement](twos complement.md))**: 
int t - x »» (sizeof(x) * 8 - 1); 
S(t ty at; 
**average x and y without overflow**: ^(x & y) + ((x ^ y) >> 1)° { TODO: works with unsigned, not sure about signed. ~drummyfish } 
**clear (to 0) Nth bit of x**: ^x & ~(1 << N)' 
**clear (to 0) rightmost 1 bit of x**: `x & (x - 1) 


opconditionatly add (subtract etc.) x and y based on condition c (c is © or 1)**: ^x + ((0 - c) & y), this avoids branches AND ALSO multiplication by c, of course you may replace + by another 
operators. 


**count © bits of x**: Count 1 bits and subtract from data type width. 


**count 1 bits of x (8 bit)**: We add neighboring bits in parallel, then neighboring groups of 2 bits, then neighboring groups of 4 bits. 


* ((x »» 2) & 0x33 
+ (x >> 4); 


7 


Xxx 
now 
Xxx 
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zi * s >> 3} & esal; 


**count 1 bits of x (32 bit)**: Analogous to 8 bit version. 


X & 0x55555555) + x >> 1) & 0x55555555); 
x & 0x33333333) + x >> 2) & 0x33333333 
x & OxOfOfOfOf) + x >> 4) & OxOfofofof); 
x & OxOOffOOff) + x >> 8) & OxOOffOOff); 
x & 0x0000ffff) + (x >> 16); 


PEELE 
nonn 


**count leading © bits in x (8 bit)**: 
: i 


**count leading 0 bits in x (32 bit)**: Analogous to 8 bit version. 


r = (x == 0); 
if (x <= oxooooffff r ;X <<= 16; } 
if (x Oxooffffff r 8; x <<= 8; 
if (x OxOfffffff P 7X <<= 4; 
if (x Ox3fffffff r x <<= 2; 
Af (x <= oxrfffffff) {r 


**divide x by 2^N**: `x >> N^ 


**divide x by 3 (unsigned at least 16 bit, x « 256)**: X + 1) * 85) >> 8°, we use kind of a [fixed poiptl(fixed point md) multiplication by reciprocal 12s on some platforms this may be 
faster than using the divide instruction, but not always also Compilérs often do this for you). checked this particular trick and it gives exact results for any x « 256, however this may 
generally not be the case for other constants than 3. Still even if not 100% accurate this can be used to approximate division. -drummyfish } 


**divide x by 5 (unsigned at least 16 bit, x < 256)**: `((x + 1) * 51) >> 8°, analogous to divide by 3. 
**get Nth bit of x**: “(x >> N) & 0x01` 

**is x a power of 2?**: ^x && ((x & (x - 1)) == 0)" 

**is x even?**: "(x & 0x01) == 0" 

**is x odd?**: ^(x & 0x01)" 

**isolate rightmost 0 bit of x**: ^-x & (x + 1)^ 

**isolate rightmost 1 bit of x**: "x & (~x + 1)' (in [two's complement](twos complement.md) equivalent to `x & -x`) 
**log base 2 of x**: Count leading O bits, subtract from data type width - 1. 

**maximum of x and y**: "x ^ ((0 - (x< y)) & (x ^ y))> 

**minimum of x and y**: ^x ^ ((0 - (x > y)) & (x ^ y) 

**multiply x by 2^N**: "x << N` 

**multiply by 7 (and other numbers close to 2^N)**: “(x << 3) - x^ 


**next higher or equal power of 2 from x (32 bit)**: 


(x == 6); 
**[parity](parity.md) of x (8 bit)**: 


x A= x >> 1; 
x ^= X >> 2; 
.X 7 (X ^ (x >> 4)) & 0x01; 


**reverse bits of x (8 bit)**: We switch neighboring bits, then switch neighboring groups of 2 bits, then neighboring groups of 4 bits. 


x >> 1) & 0x55 
x >> 2) & 0x33 
x >> 4) & OxOf 


x & 0x33) «« 2 
X << 4); 


; 


Xxx 
"na 


s & prea << 2 


**reverse bits of x (32 bit)**: Analogous to the 8 bit version. 


Xx >> 2) & 0x33333333 
x >> 4) & OxOfOfOfOf 


X & 0x33333333) << 2 
x & OxOfOfOfOf) << 4 


i 
; 


xxx 
"oaa 


(ls >> 2} & ot | 


{i & odd) «« an 
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x» 8) & oxooffooff) | ((x & Oxooffooff) << 8); 
x >> 16) & Ox0000ffff) | (x << 16); 


**rotate x left by N (8 bit)**: "(x << N) | (x >> (8 - N))' (watch out, in C: N < 8, if storing in wider type also do `& Oxff'^) 
**rotate x right by N (8 bit)**: analogous to left rotation, "(x >> N) | (x << (8 - N))' 

**set (to 1) Nth bit of x**: ^x | (1 << N)' 

**set (to 1) the rightmost © bit of x**: ^x | (x + 1)^ 

**set or clear Nth bit of x to b**: “(x & ~(1 << N)) | (b << N)` 

**sign of x (returns 1, 0 or -1)**: “(x > 9) - (x < 0)" 

**swap x and y (without tmp var.)**: `x ^= y; y ^= X; X A= y; or `x -= y; y +=X; X = y - Xj^ 

**toggle Nth bit of x**: ^x ^ (1 << N)' 

**toggle x between A and B**: “(x ^ A) ^ B^ 

**x and y have different signs?**: “(x > 0) == (y > 0)^, "(x <= 0) == (y <= 0)` etc. (differs on 0:0 behavior) 
TODO: the ugly hacks that use conversion to/from float? 

## See Also 


- [Fs Morgan's laws](de morgans Llaws.md) 


# Black 

Black, a color whose [politically correct](political correctness.md) name is *afroamerican*, is a color that we see in absence of any light. 

Blanden. blender.md ---------- 
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proprietary] (proprietary . 
, 


impressive achievement in itse owever Blender is also a [capitalist](capitalist.md) software suffering From many not-so-nice features such as [bloat](bloat.md). 


After version. 2,76 Blender started REQUIRING openee] gogo td) 2.1 due to its "[modern](modern,md)" EEVEE] (eevee md) renderer, deprecating old machines and iving a huge fuck you to all users 
with incompatible hardware (for example the users of [R Eryt. d) software). This new version also stopped working with the [free](free software.md) [Nouveau tnouv a.md) driver, forcing the 
users to use NVidia's proprietary drivers. Blender of course doesn't at all care about this. { I've been forced to use the extremely low FPS [software](sw_rendering.md) GL version of Blender 
after 2.8. ~drummyfish } 

lI bloat.md ---------- 


Bloat is a very wide term that in the context of Software] (software md) and technology means overcomplication, unnecessary complexity and/or extreme growth in terms of source code,size, overall 
complexity, number of [dependencies](dependency.m y pregu aney] redundancy.md), unnéCessary and/or useless features (e.g. [feature Creep](feature créep.md)) and resource usage, all of which 
lead to inefficient, badly designed technology wit i ugs] (bug. m (e.g. [security] (security md) vulnerabilities or crashes), as well as great obscurity, ugliness, **loss of [freedom] 
(free_software.md)** and waste of human effort. Sim put bloat is burdening [bullshit](bullshit.md). Bloat is extremely bad and one of the greatest technological issues of today. Creating 
bloat is bad engineering at its worst and unfortunately it is what's absolutely taking Over all technology nowadays, mostly due to [capitalism](capitalism.md) causing commercialization, 
consumerism and incompetent people trying to take on jobs they are in no way qualified to do. 


FERS] (lrs md) [suck less] (suck Less md) and some others rather small groups are trying to_address the issue and write software that is good, {minimal (minimalism md), safe, efficient and well 
unctioning. Nevertheless our numbers are very small and in this endéavor we are basically standing against the whole world and the mošt powerful te corporations. 


The issue of bloat may of course appear outside of the strict, boundaries of computer technology, nowadays we may already observe.e.g., **[science bloat | (sgience bloat.md)**.-- science is becoming 
so overcomplicated (many times on purpose 2g by means of [bullshit](bullshit.md) science) at 99% people cah NOT understand it, they have to BELIE' "scientific authorities", which does not 
at all differ from the dangerous blind religious ehavior. Any time a new paper comes out, chances are that not even SCIENTISTS from the same field but with a different specialization will 
understand it in depth and have to simply trust its results. This combined with self-interest obsessed society gives rise to [soyence](soyence.md) and large scale brainwashing and spread of 
"science approved" propaganda. 


Back to technology though, one of a very, frequent questions you may hear a noob ask is.**"How can bloat limit software freedom if such software has a [free] (free_software.md) license?"** Bloat 
[de-facto | (de_ra o.md) limits some of the four essential freedoms’ (to use, study, modify and share) required for a software to be free. A free license grants these freedoms tega tiy, but if some 
Of those freedoms are subsequently limited by other circumstances, the software becomes effectively less free. It is important to realize that **complexity itself goes against freedom** because 
a more complex system will inevitably reduce the number of people being able to execute freedoms such as modifying the software (the number of programmers being able to understand and modify a 
trivial program is much greater than the number of programmers being able to understand and modify a highly complex million [LOC](loc.md) program). As the number of people being able to execute 
the basic freedom drops, we're approaching the scenario in which the software is de-facto controlled by a small number of people who can (e.g. due to the cost) effectively study, modify and 
maintain the program -- and a program that is controlled by a small group of people (e.g. a corporation) is by definition [proprietary] (pro Fietary-md)- If there is a web browser that has a free 
license but you, a lone programmer, can't afford to study it, modify it significantly and maintain it, and your friends aren't able to do that either, when the only one who can practically do 
this is the developer of the browser himself and perhaps a few other rich corporations that can pay dozens of full time programmers, then such browser cannot be considered free as it won't be 
shaped to benefit you, the user, but rather the developer, a corporation. 


## Typical Bloat 


The following is a list of software usually considered a good, typical example of bloat. However Keep in mind that bloat is a relative term, for example [vim] im md) can be seen as a minimalist 
suckless editor when compared to mainstream software ([IDEs](ide.md)), but at the same time it's pretty bloated when compared to strictly [suckless](suckless.md) programs. 


- Web] (web. md) since the onset of "web 2.0" has been steadily becoming more and more bloated with things such as Adobe Flash.and [JavaScript |( javascript md) and billions of its web z 
frameworks). By today the situation about web bloat is reaching almost unbearable levels, especially in [modern](modern.md) sites Such as [YouTube](youtube.md). For a great read see [The Website 
Obesity Crisis](https://idlewords.com/talks/website obesity.htm). 
- Ads, [spyware](spyware.md), [DRM](drm.md), anti-cheats, anti-viruses, anti-sharing, anti-repair and other anti-user "features" are bloat. 
- Desktop environments such as [KDE (kde.md) and [GNOME](gnome.md). The concept of a [desktop environment] (de.md) itself is often considered bloat. 

Blender] (btender md]: one of the best examples of how software should NOT be done. 


[Blender](blender.md): quite useful [FOSS](foss.md) 3D editor which however integrates things like a whole video editor, game engine, several renderers, scripting language with text editor and 
o On. 

CMake](cmake.md): gigantic build system that currently sits on top of a sandwich of other build systems. 

Electron](electron.md): [Gut] (gui md) [Framework] (Framework md) infamous for its huge resource consumption. 

flatpak latpak.md Absolutely horrible "application distribution/execution platform with pakcage Management, [sandboxes](sandbox.md) and all that kind of shit. 

Systemd](systemd.md): Huge anti-[unix](unix philosophy.md) do-it-all system taking over [GNU](gnu.md)/[Linux](linux.md). 

Virtual machines](vm.md)/environments/sandboxes, big abstraction sandwiches (e.g. program running in an interpreter running in a sandbox inside web browser that's running in a virtual machine 
hát's running on an operating system). 


Firefox](firefox.md) [chromium] (chromium, mda. and other mainstream web browsers. 
Java](java.md), [Python] (python: md) and similar languages. 

IDEs](ide.md) such as [VSCode](vscode.md) or [NetBeans](netbeans.md). , X 
ig [game engines](game engine.md) such as [Unreal](unreal_engine.md), [Unity](unity.md) or [Godot] (godot md). 

Practically all commercial [games james.md) made in the [21st century](21st_century.md) such as [World of Warcraft](wow.md), Call of Duty etc. 
Neural networks](neural_network.m aka "AI" that is forced into everything nowadays. 


CM 


## Small Bloat 


Besides the typical big programs that even normies admit are bloated there exists also 


S t r a X S maller bloat which many people don't see as such but which is nevertheless considered unnecessarily 
complex by some experts and/or idealists and/or hardcore minimalists, including [us](lr 


a sma 
s.md). 


Small bloat is a subject of po ular [jokes] (joke md) such as "OMG he uses a unicode font -- BLOAT!!!". These are good jokes, it's nice to make fun out of one's own idealism. But watch out, this 
doesn't mean small bloat is on Y a joke concept at all, it plays an cmpor tant role in designing good technology. hen we identify something as *small bloat*, we don't necessarily have to 
completely avoid and reject tha concept: we may just try to for example make it optional. In context of today's PCs using a Unicode font is not really an issue for performance, memory 
consumption or anything else, but we should keep in mind it may not be so on much weaker computers or for example post-[collapse](collapse.md) computers, so we should try to design systems that 
don't depend] (dependency .md) on Unicode. 


Small bloat includes for example: 


oatin oint oat.m complex standard wit esign issues, requires specia ardware for acceleration ixe oint ixed point.m is better 
floating poi fl d pl dard with design i i pecial hard f l ion, [fixed poi fixed, poi d) is b 
config files (and other unnecessary file I/O that requires a file I/O library, not all computers have file systems, configs should be part of source code) 
library [linking](linking.md) ([header only] (header only md) libraries are better) 
any [GPU](gpu.md), [OpenGL](opengl.md) (complex hardware and specifications, not all computers have complex GPUs, [software rendering](software rendering.md) is better) 
Unicode unicode: mdy: (big specification requiring special libraries and big fonts, [ASCII](ascii.md) is better) 

antialiasing] (antia iasing.md) (just ignore [aliasing] (aliasing md) use low resolution textures etc.) 

4 bit architectures (they only exist to allow ungodly amounts of R; Uu 

roportional Font | ropor tional font std } (fixed width font is better 

[lin ing] (Linking md), uild ay bens SG apts, Lneker2 Les] (máke me), directories and multiple source code files (single file, [header only](header only.md) libraries and [single compilation 


32 bits completely suffice for àny computation, many times even 16 or 8 bits are enough) 


nit](singlé compilatión unit.md) programs are better 
infix notation](infix notation.md) ([postfix notation](postfix notation.md) is better) 

any [GUI](gui.md) window managers](wm.md) (pure text mode is better) 

[operating system](0s.md) ([pare metal](bare metal.md) is better) 
multithreading](multithreading.md), [ araltelism] ¢ arallelism.md) eraa memory](virtual memory.md), ... nl . r : 
sncrype sony (encryption md), Security] (security m jh [memory safety (memory_safery.md) (just don't care and/or don't handle sensitive data with computers connected to the internet, don't live 
a shitty society 


[database](database.md) software (plain files are better) 
Cg m) something in between C and [brainfuck] (brainfuck md) would is likely ideal, e.g. [ h 
glibc](glibc.md) gcc](gcc.md), [clang] te Lang m ) etc. (better alternatives are E E [musl] (musl.md), [ucli 


comun](comun.md) or [Forth (Forth: md) 
etter accents/diacritics {can normally be ignored in most languages that use them 
or [farbfeld](farbfeld.md) is better) 


c] stipa) etc.) 


jpg](jpg.md), [png](png.md), [svg](svg.md) and similar formats (e.g. [ppm](ppm.md 

[syntax Rights t ynta han Ey tmd] and just [colors] (color md) anywhere they aren't absolutely necessary 

[html] (htm markdown](md.md) ([plain text |(plaintext md) is better) 

x86] xes md) instruction set (e.g. [ARM](arm.md) is probably better, { Not completely sure how bloated ARM really is. -drummyfish }) 
any non-[public-domain](public domain.md) license (any legal burden introduced by a license is unnecessary bloat) 

dynamic inking](linking:md) (static Unking is better) ? 

web](web.md) 1. er](gopher.md) or [FTP](ftp.md) is better) 


mouse] (mouse.md)' 


eyboar 


gemini | (gemini md ( [gop! 
is better 
ly better) 


TCP](tcp.md UDP](udp.md) is probal 
vim] (vim.md things like [ed](ed.md) are probably better?) 
sound (picture is usually enough) 


high resolution (640x480 is probably the maximum you'll ever need, lower resolution takes less RAM and makes rendering faster) 
[true color |(true_cotor md) (256 colo og. 332](332.md) palette, is better) 
GNU] (gnu. m Unix utils (things like [busy ox[|(busybox.md) or [sbase](sbase.md) are probably better) 

data types](data type.md) (untyped or single type is better, everything can be just à [number] (number md)) 

[package managers](package manager.md) (just don't use them, install just a few programs manually, or at least make package managers as simple as possible) 
computers](computer.md) (pen and paper or counting with [rocks](rock.md) is better 


FO a dod do dod do dod Godd God od d dor dod ded dor d d Cor rr rr rr d 
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## Non-Computer Bloat 


The concept of bloat can be applied even outside the computing world, e.g. to non-computer technology, [art](art.md), [euLture] (culture.md), [law](law.md) etc. Here it becomes kind of synonymous 
with [bullshit](bullshit.md), but using the word *bloat* says we're approaching the issue as computer programmers. Examples include: 
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- [clothes] (clothes -md) 
- house decoration 

- [cars](car.md) 

- using languages other than [English](english.md) 
- TODO: more 

T bloat monopoly.md ---------- 

& Bloat Monopoly 


Bloat monopoly is an exclusive control, over or [de-facto] (de facto.md) ownership. of [software] (software md) or even a whole area_of technology not by legal means but by means of _ [bloat T 
(bloat.md), or generally just abusing bloat in ways that lead to gaining monopolies, e.g. by Stab lishing Standards or even legal requirements (such as the EU mandatory content filters) which 
only the richest may conform to. Even if given sofware is [FOSS](foss.m ) (that is its source code is public and everyone has basic legal rights to it), it can be malicious due to bloat, for 
example it can still be made **practically** controlled exclusivély by the developer because the developer is the only one with sufficient resources and/or know-how to be able to execute the 
basic rights such as meaningful modifications of the software, which goes against the very basic principle of [free software](free software.md). 


**Example**: take a look at the [vet] (www. md) and how [google] (google md) is gaining control over it_by getting the search engine monopoly. It is very.clear web along with web browsers has been 
becoming bloated to ridiculous lévels -- thi$ is not a coincidence, bloat is pushed by [corporations](Ccorporation.md) such as Google to eliminate possible emerging competition. If practically 
all websites require [JavaSeript] (is.md), fess] (ess. mo). [HTTPS](https.md) and similar nonsense, it is becoming much more difficult to crawl them and create a web index, leaving the possibility 
to crawl the web mostly to the rich, i.e. those who have enough money, time and know-how to do this. Alongside this there is the web browser bloat -- as websites have become extremely complex, 
it is also extremely complex to make and maintain a web browser, which is why there is only a few of them, all controlled (despite FOSS licenses) by corporations and malicious groups, one of 
whichis Google itself. For these reasons Google loves bloat and encourages it, e.g. simply by ranking bloated webpages better in their search results, and of course by other means (sponsoring, 
obbying, advertising, 


Bloat monopoly is [gapitalism] (capitalism.md)'s circumyention of [tree] free.md) license 
license to their software, get an automatic approval (**[openwashing](ópenwashing.md)**) of 
the same degree as with [proprietary](proprietary.md) software. 


S and taking advantagg of their popularity. With bloat monopoly capitalists can stick a Foss] (fogs md) 
most "open-sourcé" fanbois aS well as their free work time, while really staying in Contr almost to 


Examples of bloat monopoly include mainstream web browsers ([furryfox](firefox.md) [ghromium] (chromium md), sal L roi 
software is characteristic by its difficulty to be even compiled, yet alone under$toód, maintained and ae iy modifie 


(maintenance.md) cost that is hard to pay for volunteers, and by aggressive [update culture](update culture.m 
T body shaming.md ---------- 
# Body Shaming 


Andreid|(gndroid.md), Linux](linux.md), [Blender](blender.md) etc. This 
by a lone average programmer, by its astronomical’ [maintenance] 


*Your body sucks.* 
T1 brainfuck.md ---------- 
# Brainfuck 


Brainfuck is an extremely simple, untyped fesogeric programming hanguage|(esotand md}; pimple RES specification (consisting only of 8 commands) but intentionally very hard to program in. It 
eal eau y 


works similarly to a pure [Turing machine](turing machine.md). In a way it is kind o utifu y.md) by its [simplicity](minimalism.md). is very easy to write your own brainfuck 
[interpreter](interpreter.md). 


There exist [self-hosted](self hosting.md) brainfuck interpreters which is pretty fucked up. 
The language is based on a 1964 language P'' which was published in a mathematical paper; it is very similar to brainfuck except for having no [I/0](io.md). 


Brainfuck has seen tremendous success in, the [esolang] (esolang .md) community as the **lowest common denominator. language**: just as mathematicians use Turing machines] (turing machine md) in 
proofs, esolang programmers use brainfuck in similar ways -- many esolangs just compile to brainfuck or use brainfuck in proofs of [Turing completeness](turing_completé.md) etc. This is thanks 
to brainfuck being an actual, implemented and working language reflecting real computers, not just a highly abstract mathematical model with many different variants. For example if one wants to 
encode a program as an integer number, we can simply take the binary representation of the program's brainfuck implementation. 


In [LRS](lrs.md) programs brainfuck may be seriously used as a super simple [scripting language](script.md). 
## Specification 
The "vanilla" brainfuck operates as follows: 


We have a linear memory of **cells** and a **data pointer** which initially points to the Oth cell. The size and count of the cells is implementation-defined, but usually a cell is 8 bits wide 
and there is at least 30000 cells. 


A program consists of these possible commands: 


increment the data cell under data pointer 

decrement the data cell under data pointer 

move the data pointer to the right 

move the data pointer to the left 

jump after corresponding `] if value under data pointer is zero 
jump after corresponding '|' if value under data pointer is not zero 
output value under data pointer as an ASCII character 

read value and store it to the cell under data pointer 


## Implementation 


This is a very simple [C](c.md) implementation of brainfuck: 


#include <stdio.h> 
#define CELLS 30000 
const char program[] = ",[.-]"; // your program here 
int main(void) 
char tape[CELLS]; 
unsigned iae = 0; 
const char *i = program; 
int bDir, bCount; 
while (*i != 0) 


switch (*i) 
€ 


case '>': cell**; break; 
case '<': cell--; break; 
case '*': tape[cell]++; break; 
case '-': tape[cell]--; break; 
case ' putci ar(tape[cell]); fflush(stdout); break; 
case ' scanf("%c", tape + cell); break; 
case '[' 
case 'J': 
if ((tape[cell] == 0) == (*i == ']')) 
break; 
bir = (*i == '[')?1 : -1; 
bCount - 0; 
while (1) 
if (ect 
bCount += bDir; 
else if (*i == ']') 


bCount -- bDir? 


if (bCount == 0) 
break; 


i += bDir; 
break; 


default: break; 
itt; 
J 

J 
## Programs 
Here are some simple programs in brainfuck. 
Print "HI': 
EERBRRRERPRERRERERERERERE/REREEREREERRERERPRERERERPRERERPRERRERERERRRERRERRERRPRRRERPRERRERERRRERRERRRERERRRRRRRS . + 
Read two 0-9 numbers (as ASCII digits) and add them: 


> [$+>-]<------------------------------------------------ à 


TODO: more 

## Variants 

T0 brain software.md ---------- 
# Brain Software 


Brain [software](software.md), also brainware, is, kind of a (fun) (fun md) idea of software that runs on.the human brain as opposed.to a typical,electronic [oqmputer] (computer md) « This removes 
the [dependency] (dependency.md) on computers and highly incréases freedom. Of course, this also comes with a huge drop of computational power :) However, aside from eing a fun idea to explore, 
this kind of software and "architectures" may become interesting from the perspective of [freedom](free software.md) and [primitivism](primitivism.md) (especially when the technological 
[collapse](collapse.md) seems like a real danger). 
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Primitive tools helping the brain compute, such as pen and paper or printed out mathematical tables, may be allowed. 


Example of brain, software can be, the [game] (game html) of [chess](chess,md). Chess. masters can easily play the game without a physical chess board, only in their head, and they can play games 
with each other by just saying the moves oüt loud. They may even just play games with themselves, which makes chess a deep, entertaining game that can be 100% contained in one's brain. Süch game 
can never be taken away from the person, it can't be altered by corporations, it can't become unplayable on new [hardware](hardware.md) etc., making it free to the greatest extent. 


One may, think of a.pen and paper computer with its own simple instruction set that allows general 
it may be accompanied by tables printed out on paper for quick lookup of operation results -- e.g. 
would help the person execute the multiplication instruction within mere seconds. 


purpose programming. This instruction set may be designed to be well interpretable by human and 
a 4 bit computer might provide a 16x16 table with précomputed multiplication results which 


Yet another idea is to make a computer with architecture similar to the typical electronic computers but powered by human brains, --, let's call this, a, [human computer | (human-com uter.md) (not to 
be confused with people whose job was to perform computations!). Imagine at after a societal collapse we lose our computer technology (i.e. the ability to manufacture transistors and similar 
key components), ut we retain our knowledge of computer architecture, algorithms and the usefulness of computers. As a temporary solution for performing computations we may create a "computer 
made of humans", a room with several men, each one performing a_role of some computer component, for example an [ALU](alu.md) [tache] (cache md) and_ memory controller. Again, a special 
instruction set and a set of tools (such as physical lookup tables for results of instructions) could be made to make such a human computer relatively fast. It might not run [Doom](doom.md), but 
it could possibly eu compute some mathematical constants to a high precision or perhaps help find optimal structure of cities, compute stresses in big building etc. In such conditions even a 
Slow calculator could be immensely useful. 

T2 bs.md ---------- 


[Bullshit](bullshit.md). 
T bullshit.md ---------- 
# Bullshit 
T2 bytebeat.md ---------- 
# Bytebeat 


Bytebeat is a fproceduratl fprocgen md) [ehiptune] (chiptune md)/8bit style music generated by a short expression in a [Programming hanguage | (progranming language.md); it was 
: al 


discovered/highlighted in 1 By [Viznut](Viznut.md) (author of [countercomplex](countercomplex.md) blog) and others, and the téchnique c. é of producing quite impressive music by single- 


line code has since caught the attention of many programmers, especially in [demoscene](demoscene.md). There has even been a [paper] (https ://arxivsorg/abs/ 1212-1368) written about bytebeat. 
Bytebeat can produce music similar (though a lot simpler) to that created e.g. with [music trackers](music_tracker.md) but with a lot less complexity and effort. 


This is a [beautiful] (beauty md) [hack] (hacking, md) for [URS] (trs md)/[sucktess] (suckless .md) programmers because it takes quite a tiny amount of code, space and effort to produce nice music, 
e.g. for [games](gamé.md) (done e.g. by [Anarch] (aharch.md))-. 


8bit samples corresponding to ‘unsigned char? are typically used with. bytebeat. The formulas take advantage of [overt lows | (overflow md) that create rhythmical patterns with potential other 
operations such as multiplication, division, addition, squaring, bitwise/logical operators and conditions adding more interesting effects. 


Bytebeat also looks kind of cool when rendered as an image (outputting pixels instead of audio samples). 
## How To 
Quick experiments with bytebeat can be performed with online tools that are easy to find on the [web](www.md), these usually use [JavaScript](javascript.md). 


Nevertheless, traditionally we use [C](c.md) for bytebeat. We simply create a loop with a *time* variable (^i^) and inside the loop body we create our bytebeat expression with the variable to 
compute a char that we output. 


A simple "workflow" for bytebeat "development" can be set up as follows. Firstly write a C program: 


#include <stdio.h> 
int main(void) 


for (int i = 0; i < 10000; ++i) 
putchar ( 
i / 3 // < bytebeat formula here 


i 


return 0; 


Now compile the program and play its output e.g. like this: 
gcc program.c && ./a.out | aplay 


Now we can just start experimenting and invent new music by fiddling with the formula indicated by the comment. 
General tips/tricks and observations are these: 


Outputting the variable `i`ò creates a periodical saw-shaped beat, **multiplication/division decreases/increases the speed, addition/subtraction shifts the phase backward/forward**. 
Squaring land other powers) create a **wah-wah effect**. 

Crazier patterns can be achieved by **using the variable in places of numerical constants**, e.g. “i << ((i / 512) % 8)' (shifting by a value that depends on the variable). 

Modulo ( 74) increases the frequency and **decreases volume** (limits the wave peak). ` 

So called **Sierpinski harmonies** are often used melodic expressions of the form “1*N &i >> M`. 

Bitwise and (`&`) can add distortion (Create steps in the wave). 
- A **macro structure** of the son silent/louds parts, verse/chorus, ,.,) C 
faster beat: “int cond = (i & 0x8000 0;', cond * (i / 16) + !cond * (i/ 
**Extra variables** can add more complexity (e.g. precompute some variable ` 


aga be achieved by combining multiple patterns with some low-frequency pattern, e.g. this alternates a slower and 
a^ which will subsequently be used multiple times in the final formula). 


## Copyright 


It is not exactly clear whether, how and.to what extent [copyright](copyright) can ap 
pecearaaye on the other hand we have music, an artistic éxpression. Many authors of bytebeat 


ply, to bytebeat: on one hand we have a short formula that's uggopyrà htable (just like mathematica 
ii 
by-sa.md), but such licenses are of course not applicable if copyright can't even arise. 


T 
release" their creations under [free](free culture.md) icénses](license.md) such as [CC-BY-SA](cc- 
We believe copyright doesn't and SHOULDN'T apply to bytebeat. To ensure this, it is good to stick [CCO](ccO.md) to any released bytebeat just in case. 
## Examples 
A super-simple example can be just a simple: 
-^i/416 


Theo ou] gwino more complex examples come from the [LRS](lrs.md) game [Anarch](anarch.md) (these are legally safe even in case copyright can apply to bytebeat as Anarch is released under [CC0] 
ccO.md)): 


- distortion guitar rhythmical beat: ~~((((i >> ((i >> 2) % 32)) (i >> ((i >> 5) % 32))) & 0x12) << 1) | (i >> 11)' 
- electronic/techno: ~((0x47 >> ((i >> ral % us zu 96 Ay hy (951 >> (Qi >> 3} % 32)) | (0x06 >> fü >> qi 
? RH 


i (i * 11) »» 14) & Ox0e) * 32) % 32))" 
- main theme, uses an extra variable: “(((i) & à & ((( >> 16) & 0x09)) : -a)', where "uint32 t a = 7 i>> 9 ~i << | i) 


i7)|t( Ie i 
## See Also 


- [music tracker](music tracker.md) 
- [MIDI](midi.md 
l1 cancer.md ---------- 

# Cancer 


Cancer is similar to [shit](shit.md) but is even worse because it spreads itself and infects anything else it touches (it is a subset of shit). 
## See Also 
- [shit](shit.md) 


capitalism.md 
# $$$Capitalism$$$ 


*Capitalism is how you enslave people with their approval.* 


Capitali$m is the worst socioeconomic system we've yet seen in [history](history.md),^[source](logic.md) based on pure greed, culture of slavery and artificially sustained conflict between . 
everyone in society (so called [competition](competition.md)), abandoning all morals and putting Money and profit (so called [gapital](gapital md)) above everything else including preservation 
of life itself, capitalism fuels the worst in people and forces them to compete and suffer for basic resources, even in a world where abundance of resources is already possible to achieve. 
Capitalism goes against progress (see ed; [antivirus paradox](antivirus paradox.md)), [good technolo Waites ma) and freedom, it Supports immense waste of resources, wars, abuse of people and 
animals, destruction of environment, decline of morals, deterioration of art, invention of [buttsnie] ullshit.md) (bullshit jobs ullshit laws, ...), utilizing and perfecting methods of 
[£orture] (marketing md), brainwashing, censorship and so on. In a sense capitalism can be seen as **slavery 2.0** or *universal slavery*, a more sophisticated form of slavery, one which denies, 
he labe by calling itself the polar opposite ("freedom") and manipulates people into them approving and voluntarily parttaking in their own enslavement. However wage and consumption slavery is 
only a small part of capitalist dystopia -- capitalism brings on destruction basically to every part of civilization. It it also often likened to a [cancer](cancer.md) of society; one that is 
ever expanding, destroying everything with commercialism, materialism, waste and destruction, growing uncontrollably with the sole goal of just never stop an ever accelerating growth. 
Nevertheless, it's been truthfully stated that "it is now easier to imagine the end of all life than any substantial Change in capitalism." Another famous quote is that "capitalism is the belief 
that the worst of men driven by the nastiest motives will somehow work for the benefit of everyone", which is describes its principle quite well. 


{ Some web bashing capitalism I just found: http://digdeeper.club/articles/capitalismcancer.xhtml, read only briefly, seems to contain some nice gems capturing the rape of people. -drummyfish } 


**Capitalism is fundamentally flawed and CANNOT be fixed** -- capitalists build on the idea that competition will drive society, that market will be self sustaining, however capitalism itself 
works for instating the rule of the winners who eliminate their competition, capitalism is self destabilizing, i.e. the driving force of capitalism is completely unsustainable and leads to 
catastrophic results as those who get ahead in working competition are also in advantage -- as it's said: money makes money, therefore money flow from the poor to the rich and create a huge 
imbalance in which competition has to be highly force eventually completely arbitrarily and in very harmful ways (invention of bullshit jobs, creating artificial needs and hugely complex state 
control and laws). It's as if we set up a race in which those who get ahead start to also go faster, and those become the ones who oversee and start to create the rules of the race -- expecting 
a sustained balance in such a race is just insanity. Society tries to "[fight](fight culture.md)" this emerging imbalance with various laws and rules of market, but this effort is like trying to 
fight math itself -- the system is mathematically destined to be unstable, pretending we can win over laws of nature themselves is just pure madness. 


**Capitalism produces the [worst imaginable, technolog (capitalist software,md)** and rewards.people for [being cruel to each other] (entre reneur.md). It peints the direction of society towards 
a [collapse](collapse.md) and may very likely be the [great filter](great_filtér.md) of civilizations; in capitalism people [de-facto](de_facto.md) Own nothing and become wholly dependent on 
corporations which exploit this fact to abuse them as much as possible. This is achieved by [slowly boiling the Frog] (slowly bod Ling-the_ frog md). No one owns anything, products become 
[services] (Saas. md) (your car won't drive without Internet connection and permission from its manufacturer), all independency and decentralization is lost in favor of a highly fragile and 
ancergepen b economy ang infrastructure of services, each one controlled by the monopoly corporation. Then only a slight break in the chain is enough to bring the whole civilization down in a 
spectacular domino effe 


**The underlying issue of capitalism is [competition](competition.md)** and conflict -- competition is the root of all evil in any social system, however capitalism is the absolute glorification 
of competition, amplification of this evil to maximum. It is implemented by setting and Supporting a very. stupid idea that **everyone's primary and only goal is to be self-benefit**, i.e. 
maximization of capital. This is combined with the fact that the environment of [free market](free_market.md) is a system with revolutionary system](evolution.md)** which through natural 
selection extremely effectively and quickly optimizes the organisms (corporations) for achieving this given goal, i.e. generating maximum profit, on the detriment of all other values such as 
wellbeing of people, sustainability or morality. In other words capitalism has never promised a good society, it literally only states that everyone should try to benefit oneself as much as 
possible, i.e. defines the fitness function] (ritness function md) purely as the ability to seize as many resources as possible, and then selects and rewards those who best implement this 
function, i.e. those we would call sociopaths or "dicks", and to those iS given the power in society. Yes, this is how nature works, but it must NOT be how a technologically advanced 
civilization with unlimited power of destruction should work. In other words we simply get what we Set to achieve: find entities that are best at making profit at any cost. The inevitable 
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decline of society can, not possibly be prevented by laws any effort of tryin to stop evolution by inventing artificial rules on the go is a_battle against nature itself and is extremely naive, 
the immense power of the evolutionary system that's constantly at work to find ways to bypass or cancel Laws in the way of profit and abuse of others will prevails just as life will always find 
its way to survive and thrive even in the worst conditions on Earth. Trying to stop corporations with laws is like trying to stop a train by throwing sticks in its path. The problem is not that 
"people are dicks", it is that we choose to put in place a system that rewards the dicks, a system that fuels the worst in people and smothers the best in them. 


Even though nowadays quite a lot of time has passed since times of [Marx] (marx. md) and capitalism has_evolved to a stage with countless disastrous issues Marx couldn't even foresee, it is useful 
to mention one of the basic and earliest issues identified by Marx, which is that economically capitalism is based on **stealing the {surplus ](surptus md) value**, i.e. abuse of workers ani 
consumers by owners of the means of production (factories, tools, machines etc.) -- a capitalist basically takes money for doing nothing, just for letting workers use tools he proclaims to own 
a capitalist will proclaim to "own" land that he never even visited, machines he didn't make as they were developed over centuries, nowadays he even claims to own [information and ideas] 
intellectual property.md)) -- as [Kropotkin {kropotkin.md) put it: the working man cannot purchase with his wage the wealth he has produced. This allows a capitalist oppressor to make 
exponentially more money for nothing and enables existence of monstrously rich and powerful individuals -- consider for example that nowadays there are people who own hundreds of buildings and 
cars plus a handful of private planes and a few private islands. It is not possible for any single human to work an equivalent of effort that's needed to produce what such an individual owns, 
even if he worked 24 hours a day for his whole life, he wouldn't get even close to matching the kind of effort that's needed to build the hundreds of buildings he owns -- any such great wealth 
is always stolen from countless workers whose salary is less than what's adequate for their work and also from consumers who pay more than it really costs to manufacture the goods they buy. 
Millions of people are giving their money (resources) for free to someone who just proclaims to "own" tools and even natural resources that have been there for billions of years. The difference 
in wealth and privileges this wealth provides divides society into antagonist Classes that are constantly at war -- traditionally these classes are said to be the **[bourgeoisie] 
(bourgeoisie.md)** (business owners, the upper class) and the silprolstariat](proletariar.md)'s (workers, the lower class), though under modern capitalism the division of society is not so 
simple anymore -- there are more classes (for example small businesses work for larger businesses) but they are still all at war. 


Nowadays ucSapitatism is NOT JUST an economic system** anymore. Technically perhaps, however in reality it takes over society to such a degree that it starts to redefine very basic social and 
moral values to the point of taking the role of a [retigion](retigionmd), or better said a brainwashing cult in which people are since childhood taught (e.g. by constant daily exposure to . 
private media) to worship economy, brands, engage in cults of personalities (see myths about godlike entrepreneurs) and [productivity |(productiyit .md) (i.e. not usefulness, morality, efficiency 
or similar va ues, just the pure ability to produce something for its own sake): Close minded people will try to counter argue in shallow ways such as "but religion has to have some supernatura 
entity called God" etc. Again, technically speaking this may be correct, but if we don't limit our views by arbitrary definitions of words, we see that the effects of capitalism on society are 
[de facto (de-facto:md) of the same or even greater scale than those of religion, and they are certainly more negative. Capitalism itself works towards suppressing traditional religions (showing 
it is really Competing with them and therefore aspiring for the same role) and their values and tryin o replace them with worship of money, success and self interest, it permeates society to 
the deepest levels by making every single area of society a subject of business and acting on the minds of all people in the society every single day which is an enormously strong pressure that 
e ers 


strongly shapes mentality of people, again mostly negatively towards a war mentality (constant competition with ot ), egoism, materialism, fascism, pure pursuit of profit etc. 


From a_certain point of view capitalism is not really.a traditional, socioeconomic system, it is **the failure to establish one** -- capitalism is the failure_to prevent, the establishment of 
capitalism, and it is also the punishment for this failure. It is the continuation of the Jungle to the age when technology for mass production, mass surveillance etc. has sufficiently advanced 
-- capitalism will arise with technological progress unless we prevent it, just as cancer will grow unless we treat it in very early stages. This is what people mean when they say that 
capitalism [simply works](just werks.md) or that it's *natural* -- it's the least effort option, one that simply lets people behave like animals, except that these animals are now eguipped with 
weapons of mass destruction, tools for implementing slavery, world wide surveillance etc. It is natural in the Same way in which wars, murders, bullying and deadly diseases are. It is e most 
primitive system imaginable, it is uncontrolled, leads to suffering and self-destruction. 


Under capitalism you are not a human being, you arẹ a resource, at best a machine that's useful for some time but becomes obsolete and undesired once it outlives its usefulness and potential to 
n exploited. Under capitalism you are a Stave that's forced to live the life of 3 Cs: **conform, consume, compete**. Or, as [Encyclopedia dramatica](dramatica.md) puts it: work, buy, consume, 
ie. 


## Attributes Of Capitalism 


The following is a list of just SOME attributes of capitalism -- note that not all of them are present in initial stages but capitalism will always converge towards them. 
- **[slavery](slavery.md), oppression, loss of freedom**: In capitalism people are slaves firstly as workers -- in work time, so called [wage slavery] (vage-stavery md) -- and secondly as 
consumers -- in "free" time anks create inflation to devalue money people save so that they have to work constantly for their whole lives as produc 


: n sS are getting progressively more expensive. 
More and more gssentialty unnecessary spending purchases are forced on people -- new smartphone every year, mortgages, gas and maintenance of cars, new clothes according to fashion, insurance 
etc. Practically no one has a truly free time anymore. 

- **extreme waste**: Bullshit products, [bullshit jobs] (bullshit job.md) and the need for constant dynamics of the market force to waste energy, material and human work just to keeping : 
everything in motion, even if purely arbitrarily. Corporations keep reinventing and resetting slightly modified version of already existing products, one group of people is creating something 
while another group is destroying it, just to keep everyone occupied. Byproduct physical waste such aS plastics and chemicals are dumped in the environment and pollute it for decades, even 
centuries to come. At the moment we are already drowning in physical waste, we just export it to third world and hope they will have infinite space to store more. 

- **[antivirus paradox](antivirus paradox.md)**: Sustaining and artificially creating undesirable phenomena so as to build a business in [fighting](fight.md) it, to keep and create jobs 
("firefighters starting fires"). 

- **[artificial scarcity](artificial scarcity.md)**: In order, to be able to sell sopething, that something has to be scarce, an abundant resource such as air cannot be sold. Once technology 
emerges to make some resource abundant, it threatens those who have a business in selling that resource. This creates the huge interest in keeping resources scarce, sometimes by force. 
Corporations are known to routinely destroy food that can still be eaten, and other goods as well. Corporations indirectly conspire on keeping resources scarce by artificial obsolescence, 
out lawing old products as "unsafe", using lcopyright](copyright.md) to prevent people from recycling old intellectual works etc. 

- **[artificial obsolescence] (artificial obsolescence.md)**: To keep, businesses running companies have an interest in making people consume even things that could otherwise last, them.even 
whole tives, so we see phenomena like people being forced to buy new phones every every year. There used to be the famous Light bulb cartel ([Phoebus cartel] (phoebus_cartel.md)) that fined any 
bulb manufacturer that made long lastin ight bulbs, bulbs were forcefully made to last for a short time. [Apple](apple.md) has remotely decreased the performance of older [iPhones] (iphone.md) 
when new ones came out. There are countless examples. 

-.**artificial crippling, of technology? ?: It is nowadays the norm to create a high tier product, such as a CPU or a car, and then artificially cripple some of the manufactured units (limit car 
engine power by software, burn parts of the CPU, ...) so as to sell them as a lower tier of that product. It is cheaper than to separately invent several tiers of the product. So it costs the 
same (actually less) to create a high end CPU as the low end one -- we could all be using high end CPUs, but the poorer of us are forced to use the forcefully crippled versions, because 
"capitalism". 

- **purposeful incompatibility in technology**: In market competition products of one company will, often, be incompatible with products of the competition on purpose, so as to discourage 
consumers from buying it. Technology corporations create their own "ecosystems" for consumers into which they are trying to lock them. 

- **[bullshit,jobs](bullshit job.md), invention of bullshit products/needs**: As automatization takes people's jobs, people try to keep jobs by creating artificial bullshit, e.g. "lack of 
women in tech" leads to creation of "diversity departments", politicians try to *create more jobs* by increasing bureaucracy etc. This is Of course in direct conflict with the base goal of 
civilization itself of eliminating the need for human work. One online company even successfully sold literal excrement (which had no actual use, it was just marketed as "funny and cool"). 

- **preventing progress. sustaining status quo**: Capitalism is extremely hostile towards social rogress more leisure time, more social security, ...), i.e. the main kind of progress (all 
progress should eventually serve well being of people, otherwise it's just artificial self-serving burden). It is also, contrary to popular belief, against technological progress -- the 
established corporations want to perpetuate their established businesses and will attack and destroy new ideas that endanger it (i.e. electric cars vs fuel powered cars, food corporations vs the 
solution of world hunger etc.). Capitalism prevents realization of any idea that's physically possible but which is **economically impossible**, ruling out e.g. many solutions to global heating 
etc. 

- enbiqeeismi(fascism. md)" Capitalism is based on fascism, i.e. extreme hierarchy and "tribes" of which each fights to death for its own self interest. This fight happens between companies 
themSelves étween state and companies, different departments inside companies, between workers and employers, between brands on the market etc. Capitalism is a constant war against everyone 
else -- not even jungle has this much conflict. 

= **no long term planning, irresponsibility**: Companies need to make immediate profit, managers hired to new positions are expected to immediately increase profits and they don't come to stay 
for long, they have no responsibility, so they simply do whatever it takes to create immediate profit without considering any long term consequence such as pollution etc. 

- **extreme lowering of quality of Rr ogucts, deterioration of erel tart md rs Despite. capitalist propaganda, capitalism doesn't lead. to increased quality of products -- on the contrary it seeks 
to find the MINIMUM quality that will be accepted by the consumer. In seeking to minimize manufacturing cost of a single unit, companies save money wherever they can and rather invest in 
marketing etc. -- for example instead of paying several experts to produce a good, well fact-checked documentary, only one man will be paid to create the documentary with the focus on it being 
"fun and engaging" rather than factually correct. Art is hasted, scheduled, produced on short deadlines, littered with product placement etc. 

nowo Biutocrecy] (plutocrac .md), i.e. loss of (grue) [democracy] (democracy. md) ^^; In capitalism only illusion of democracy is sustained, there is no rule of the people, there is rule of the rich 
THROUGH people, às the rich aré' those who make the laws and actually take the ruling positions and who have a tremendous power to manipulate masses via private media. State is becoming more and 
more the tool of corporations rather than a protection against them. [USA](usa.md), the worst case of capitalism, is infamous for having no voting freedom, there exists just a laughable choice 
of two parties which are exactly the same. 

= ** monopolies | (monopoly .md) with unlimited power, degeneration of competition**: The naive ideas of capitalists that markets will_magically regulate themselves quickly falls apart, basically 
no one even tries to believe it anymore. In a competitive market monopolies arise in a short time who will prevent any competition from even ariSing. Can a tiny starting company compete with an 
established corporations with billions of dollars and thousand lawyers? No. The corporation can defeat them by gigantic marketing, unfair practices (unfair prices etc.) despite fines, by simply 
buying them, legal trolling, media trolling (negative internet reviews, ...), even physical attacks if necessary (ust anonymously pay a bunch of hackers to DDOS competition's servers ete): 
Once a monopoly without competition exists, the Tew advantages of competition disappear completely. A corporation doesn't respond to demand, it creates the demand. It can do whatever it likes, 
it can set arbitrarily high prices, create arbitrarily shitty products and so on, no competition is pressuring it to do otherwise, people have no choice than to subvert. 

Pdl poverty] (poverty md)" "i Despite, capitalist ropgganda, not everyone can be successful in capitalism (if everyone could retire at.20, why doesn't everyone just do it?), and it is a fact that 
because [money makes iioney ] (money makes money md] hé gap between the poor and the rich is gecoming wider and wider (as of 2020, 8 richest people owned aS much wealth as the whole poorer half 
of the population). Poor people are pushed into loans, getting into debts, trapping themselves, working multiple jobs, while their health deteriorates increasing their debt on medical bills, 
decreasing their ability to work more etc. 

**torture and killing of people**: The poorest, mostly in third world countries, including children, are forced to.hard labor that destroys their lives. Whole cities live off of processing 
waste coming from first world countries, e.g. disintegrating used ships with primitive toolS, no work safety, breathing cancerous fumes etc. 

**materialism: there exists pothing but money**: By definition capitalism advises ONLY to maximize one's profit, any other values such as human well being, peace, preservation of life 
environment or progress are subverted to the goal of profit. As other values are often in conflict with profit, profit wins and people suffer. 

- **[ fight gulture] (fight culture.md), [fasgism](faseism md), extreme hostility between people, disappearance of morality**: The very basis of capitalism,-- competition -- nurtures_ people. 
towards self interest, self centeredness and hostility towards others while suppressing good attributes such as sharing, love for others and [altruism](altruism.md). With this morals decline and 
fascist groups arise. Furthermore the system of overcomplicated laws are starting to replace morals pgopls ask "is it legal?" rather than "is it a goo thing to do?". This creates a society of 
dicks an ps chopaths who are additionally rewarded for their immoral behavior by becoming "successful" and wealthy. In Tong term this serves as a natural selection in Darwinian evolution, 
immorally behaving people are actually more likely to survive and reproduce, which leads to genes of psychopathic behavior becoming more and more common in society -- under capitalism good 
people quite literally become extinct in the long run. 

- **[fear culture] (fear culture md)": To keep people consuming and constantly engaged a tension has.to be kept, comfortable people are undesirable in capitalism. So there is constantly a 
propaganda of somé threat, be it viruses, terrorism, pedophiles on the internet, Computer viruses, killing bees etc. 

UE consumerism] (consumerism.md **: To keep businesses running people need to consume everything, even things that shouldn't be consumed and that could last for very long such as computers and 
cars. This leads to creation of hasted low quality products (even art such as TV series) that arë meant to bé used and thrown away, repairing is no longer considered. 

- **commerce infects absolutely everything®* In advanced capitalism there is no such thing as a commerce free zone, everything is privatized eventually and serves selfish interests. Nowadays 
even such areas as health care, wellfare or education of children is permeated by money, ads and corporate propaganda. Even nonprofits have to make money. Educational videos in schools are 
preceded with ads (as they are played on [YouTube] (youtube .md)), propagandists even legally go to sc! 

children that they should e.g. create bank accounts in the propagandist's specific bank). 

- **destruction of life environment**: This is nowadays already pretty clear, {g}obal heating] (global _warming.md) is attributed mainly to capitalism and is seen as maybe the most likely doom 3 
that's probably already unavoidable. Lack of long term planning and any concern for anything but money, along with consumerism and extreme waste (of energy, physical waste such as plastic, toxic 
chemicals etc.) lead to building bullshit factories and performing unnecessary activity for economic reasons (e.g. transporting materials over the globe for assembly, then transporting it back), 
Leading to extreme pollution of air (visible air smog already makes it hard to breathe in many cities), water (it is no longer safe to drink rain water as it used to be); and food (microplastic 
articles are already basically EVERYWHERE, eating them can't be avoided). Forests that are necessary for cleaning air, host many precious life forms and are overall a key part of ecosystem are 
eing destroyed rapidly, entire species are disappearing very quickly. And that's just a quick sum up. 

- **loss of ethical behavior**; Ethical behavior is a.disadvantage in a competitive environment of the market, it is a limitation. Those trying to behave ethically (e.g. fair prices or good 
treatment of employees) will simply lose to the unethically behaving ones and be eliminated from the market. Eventually there only remain uhethically behaving entities, which is exactly what we 
are seeing nowadays -- there basically doesn't exist a single ethically behaving corporation in the world (which has however already been normalized and is no longer seen as an issue). 

- reer mAR Tea Le design**: By definition in capitalism technology is not to serve people, it is to serve companies to make profit and abuse people, so technology spies on its users, refuses to 
work ([DRM](drm.md), ...) shows [ads](ad.md), forces children into purchases (predatory [games](game.md)), breaks on purpose so as to enforce a paid repair etc. 

- reLcensorship]teensorship. md) One kind of capitalist censorship is so called [intellectual property (intellectual property md) (allowing "ownership" of ideas, art etc.), but there are many 
more, e.g. so called [moderation](moderation.md) of social media which censors specific political views eemed "politically incorrect" and hence "dangerous" for the advertising potential or 
brand of the platform) or sharing of certain facts (e.g. those revealing unethical practice of the platform itself, negative reviews of its products etc.). Privately owned media 

and manipulate information so as to manipulate peop e in whichever way they see will bring them most profit. While "intellectual property- is marketed as "protecting intellectual workers", in 
practice it serves corporations and states to do whatever they want, from political censorship, deception and implementing surveillance (justified by "anti[piracy](piracy.md)") to legal bullying 
and implementing artificial scarcity ("no, you can't grow this type of food on your field as the plant is patented; only we can grow it and you have to buy it from us in order to live"). 

- wy seg ved tlance] (surveil lance:mg)?:: Companies want to analyze behavior of .people, manipulate them, target ads, spam, train neural networks on their data etc.,.so there is a huge interest in 
applying surveillance. Indeed, this is exactly what we see in practice -- this iS not even a conspiracy theory, cases of revealed mass surveillance are almost daily news. 

- **extreme [brainwashing] (brainwashing .md) and propaganda" [Marketing](marketing md) reaches extreme levels in capitalism, utilizing advanced psychological tricks and repetition to the point 
of becoming à torture, with the goal of teaching peop e brand loyalty, Consumerist behavior etc. Application of this brainwashing even on children has already been normalized. Entrepreneurs 
create cults of personalities. There is now even a "legit" job called an Tinriuencer ](influencer mi) whose sole purpose is in spreading corporate propaganda on the Internet. 

- **criminality**: This is a direct consequence, of poverty, horrible working conditions [fight culture](fight culture.md), and overall diminishing morality. Poor people (the absolute majority in 
the system) become desperate and do desperate things -- of course, all blamé is put on them, not on those who are responsible for their poverty. 

- **instability**; Lack of long, term planning, extreme interdependence, monopolies over essential resources, fragility of the market, increasing wealth gap, pushing workers to poverty while 
taking away social security, eliminating self sufficiency, extreme waste and other phenomena pose great dangers Of market collapses, violent strikes and revolutions’, running out of resources, 
destruction of living environment and other disasters and even societal [collapse](collapse.md) . 

**need for extremely complex market control and laws, burdening society**: As corporations are absolutely unethical and pursue evil goals such as enslaving workers and abuse of consumers, 
there have to be an extremely complex set of constantly evolving laws and bureaucracy isst to somehow "make corporations behave". However laws are imperfect and corporations work 24/7 on 
bypassing them as_ well as on attacking and eliminating the laws themselves via lobbyist etc. This creates a constant, extremely expensive legal war-like game in which everyone has to take part, 
which is completely arbitrary and unnecessary and which eventually corporations will likely win. 

- **uncontrolled growth**: Capitalism is likened to [cancer](cancer.md) as it requires a constant uncontrolled growth which on a planet of limited resources inevitably leads to a catastrophic 
scenario. 


ool and brainwash little children (they call it "education in financial literacy" and teach 
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- **hyperspecialization, loss of self sufficiency**: Entities (people, cities, companies, states, ...) lose self sufficiency as they hyperspecialize in some task and in everything else rely on, 
someone else. This complete dependence creates siavery and danger -- in an event of a blackout for example people cannot survive as they cannot make their own food, they can't repair their basic 
tools etc. 


- **loss of humanity**: In capitalism humans are just consumers, machines for production and "resources" -- corporations now routinely use these terms (*human resources department* etc.). People 
are brainwashed to ho longer even see it as concerningto be called such terms. People's worth is only in how much they can work or consume. 

- **abuse of animals**: In Capitalism animals are, just products and resources, they are kept in very bad conditions just to be killed for meat or other purpose. They are slaughtered by millions 
just so we can overeat to morbid obesity. Maximizing profit dictates no money should be spent on animal comfort. 

- si roductivity cult] (productivity cult md **: People are brainwashed and forced into becoming robots whose sole purpose is to produce. Working overtimes, skipping lunch, minimizing sleep etc. 
has ready become part of the work culture for example in USA and Japan. 

- **everything is fake**: Everything is rotten and corrupted on the inside with an extreme effort towards putting up a misleading good looking facade. TV shows, including "news", are all gtaged 
(even those swearing not to be, no producer is going to invest money in something depending on pure luck), smiles and emotion of péople you méet in workplace or see on ads, women's tits, butts 


and faces, men's muscles, photos on social media, food that has basically no food in it, even news and facts, everything is fake. Investigating any area (government working conditions, . . 
technolo y, healthcare, education; charities, academia and "[science](soyence.md)", ...) a bit in depth practically always leads to unrevealing how corrupt it actually is despite it looking nice 
and ideal at the first look. 


- **loss of ownership**: Even that which is most saint to a capitalist -- property and the ability to own things -- is greatly lost under capitalism. This happens with the trend of everything 
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becoming a service, a typical example of which is,so called "[software as a service] (saas md). While in the past one would puy a physical copy of a program that he would at least physically own 
forever, nowadays many programs become a subscription service, eg; games, movies and music are no longer something you buy but just buy a one time ticket for. But this trend is everywhere, 
artificial obsolescence tries to limit durability of physical goods Such electronic devices so that one has to keep consuming them like a service. 

- **[rape effect](rape effect.md)**: The mechanisms of capitalism work in such ways that everyone gets progressively more raped with any further advance of capitalism. 

- **endangering.existence of all life**: The mentioned destruction of environment, lack of long term planning, irresponsibility and instability, along with creating a dangerous overdependence on 
technology and interconnections of self insufficient states and cities is just waiting for a disaster such aS [CME (pme. md) that immediately collapsés the civilization and consequently endangers 
all life on Earth e.g. by meltdowns in nuclear plants or possible nuclear wars as a consequence of panic. The absolute preference of immediate profit is hostile towards investments in future and 
precautions. A 


## How It Works 


The "old" capitalism, or perhaps its basic forms, that socialist writers have analyzed very well is characterized mainly by abuse of workers by capitalists who declare to "own" means of 
production such as factories, land and machines -- as e.g. Kropotkin has written in *The Conquest of Bread*, it is **poverty** that drives capitalism because only a poor man who just needs ANY 
salary for himself and his family will accept horrible working conditions and low pay, simply because he has no other choice -- a capitalist exploits this, "employs" (enslaves) the poor and then 
only pays them as much as to keep the barely alive and working for him, and he further has the audacity of calling himself an "altruist" who "feeds" people and "gives them a [work](work.md)"; a 
capitalist employs workers in his factory like he employs chicken in egg factories or pigs in slaughterhouses -- in modern days many may fall to the illusion that workers aren't poor anymore as 
they may posses Smartphones and big screen TVs, but in essence a worker still lives salary to salary and is in desperate need of it; without a salary he will quickly end up starving in the 
street. Workers do labor that's in itself worth a lot but the capitalist only gives him a small salary, firstly to gain own profit and secondly to keep the worker poor because again, only a poor 
man will work for him. This is also why capitalists are against anything that would end pover ty, such as universal basic income (ubi. md); If the workers owned the factory collectively and 
didn't have to cut the profit off their labor, they wouldn't have to work so many hours in such harsh conditions at all, it's only because there is a capitalist leech at the top that everyone 
has to slave himself to death so that the leech can get enormously rich. 


Here a capitalist says to the worker: "I am not forcing you to slavery, if you don't like the working conditions, go elsewhere". Of course, this is a laughable insult -- the capitalist knows 
very well there is nowhere else to go; wherever you go work in capitalism, you get exploited -- you Can only do às much as choose your slavemaster. A capitalist will then say: "start your own 
business then", which again is a complete idiocy -- it's extreme Ty hard to succeed in business, not everyone can do it, those who have established businesses won't let anyone on the market, and 
of course it's the immoral thing to do, the capitalist is just telling you to start doing what he's doing: abuse others. If you do start your business, he will be sure to attack you as a 
competition and with his power he will very likely be able to stop your business. So this advice is similar to that of "go start your own country if you don't like this one" -- he might as well 
tell you to move to another planet. 


The **new**, modern capitalism is yet worse as it takes full advantage of technology never before seen in history which allows extreme increase of exploitation of both workers and consumers -- 
now there are cameras and computers watching each worker's individual production, ere are "smart" devices spyihg on people and then forcing ads on them, there are loud speakers and screens 
everywhere full of propaganda and brainwashing, nowhere to escape. Now a single capitalist can watch over his factories all over the world through [Internet](internet.md), allowing for such 
people to get yet much richer than we could ever imagine. 


While the old capitalism, was. more, of a steady slavery and the deterioration of society (life environment, morality, art, ...) b S d to 
nowadays, in the new capitalism the downfall of society accelerates immensely. In countries where capitalism is newly instatéd, e.g. after the fa of an old regime, it indeed seem to b 
"working" for a short time, however it will never last -- initially when more or less everyone is at the same start line, when there are no highly evolved corporations with their advanced 
methods of oppression, small businesses grow and take their small Shares of the market, there appears true innovation, businesses compete by true quality of products, people are relatively free 
and it all feels natural because it is, it's the system of the jungle, i.e. as has been said, capitalism is the failure to establish a controlled socioeconomic system rather than a presence of a 
purposefully designed one. Its benefits for the people are at this point only a side effect, people see it as good and continue to support it. However the system has other goals of its own, and 
that is the development and constant growth that's meant to create a higher organism just like smaller living cells formed us, multi cell organisms. The system will start being less and less 
beneficial to the people who will only become cells in a higher organism to which they'll become slaves. A cell isn't supposed to be happy, it is supposed to sacrifice its life for the good of 
e higher organism. 


y it was relatively slow (i.e. it seemed to be somewhat "working"), 
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{ This initial prosperous stage appeared e.g. in Czechoslovakia, where I lived, in the 90s, after the fall of the totalitarian regime. Everything was beautiful, sadly it didn't last longer than 
about 10 years. -drummyfish } 


Slowly "startups" evolve to medium sized businesses and a few will become the big [corporations](corporation.md). These are the first higher entities that have an intelligence of their own, they 
are composed of humans and technology who together work solely for the corporation's further growth and profit. A corporation has a super human intelligence (combined intelligence of its 
workers) but has no human emotion or conscience (which is suppressed by the corporation's structure), it is basically the rogue [At] (ai md) we see in sci-fi horror movies. Corporation selects 
only the worst of humans for the management positions and has further mechanisms to eliminate any effects of human conscience an tendency for ethical behavior; for example it works on the 
principle of ["I'm just doing my job"](just doing my job.md): everyone is just doing a small part of what the whole company is doing so that no one feels responsible for the whole or sometimes 
doesn't even know what he's part of. If anyone protests, he's replaced with a new hire. Of course, many know they're doing something bad but they have no choice if they want to feed their 
families, and [everyone is doing it](everyone is doing it.md). 


Deterioration of society is fast now but coble are kept in.a false sense of a feeling that "it's just_a temporary thing", "it's this individual's fault (not the system's)" and that "it's slowly 
getting better", mainly with the help of 24/7 allmighty media brainwashing. Due to heavy [greenwashing](greenwashing.) [openwashing](openwashing.md) etc. most people are for example naively 
Convinced that corporations are becoming more "environment friendly", "responsible", "open source" ("Microsoft isn't what it used to be' .) etc., as if a corporation had something aking 


emotion instead of pure desire for profit which is its only goal by definition, A corporation will repeat ads telling you it is paying black andicapped gays to plant trees but internally no one 
gives a shit about anything but making more money, a manager's job is just to increase profit, waste is increasing and dumped to oceans when no one is looking bullshit is being invented to 
ickstart more bullshit business which leads to more need for energy wasting (unnecessary transportation, upkeep of factories and workplaces, invention of bu {shit technology to solve artificial 
problems arising from artificial bullshit). A lie repeated 1000 times a day will beat even truth that's evident to naked eye, basic logic and common sense. Even when sky is littered with ads, 
cities are burning and people are wor king 20 hours a day, a capitalist will keep saying "this is a good society", "we are just in a temporary crisis", "it is getting better" and "I care about 
the people", and people will take it as truth. 


Corporations make calculated decisions to eliminate any competition, they devour or kill smaller businesses with unfair practices (see e.g. the [Microsoft's](microsoft.md) infamous [EEE] 
(eee.md)), more marketing and by other means, both legal and illegal. They deve lop advanced psychological methods and extort extreme pressure such as brainwashing by ads to the population to 
create àn immensely powerful propaganda that bends any natural human thinking. With this corporations no longer need to satisfy the demand, they **create the demand** arbitrarily. They create 
artificial scarcity, manipulate the market, manipulate the people, manipulate laws (those who make laws are nowadays mostly businessmen who want to strengthen corporations whose shares they hold 
and if you believe voters can somehow prevent such psychopaths getting this power, just take a look literally at any parliament of any country). At this point they've broken the system, 
competition no longer works as idealized by theoretical capitalists, corporations can now do practically anything they want. 


**This is an [evolutionary system] (evolution. md) ** in which the fitness function is simply the ability to make [capitall(capital.md). Entities involved.in the market are simply chosen by natural 
selection to be the ones that best ‘make protik, i.e. who are best at circumventing laws, brainwashing, hiding itlegal activities etc. Ethical behavior is a disadvantage that leads to 
elimination; if a business decides to behave ethically, it is outrun by the one who doesn't have this weakness. 


The unfair, unethical, behavior of corporations is still supposed to be controlled by the [8tatel(stgte.md), however Corporations become stronger and bigger than states, they can manipulate laws 
by lobbying, financially supporting preferred candidates, favoring them with their propaganda etc. States are the only force left supposed to protect pe pte from this pure evil, but they are too 
weak; a single organization of relatively few people who are, quite importantly, often corporation share holder, won't compete against a plethora of the best warriors selected by the extremely 
efficient system of free market. Furthermore voters, those who are supposed to choose their protectors, are just braindead zombies now who literally do what their cellphones shows them on its 
display. By all this states slowly turn to serving corporations, becoming their tools and then slowly dissolve (see how small role the US government already plays). Capitalist brainwashing is so 
strong that **it even makes people desire more torture** -- see so called ["anarcho" capitalism] (ancap.md) which the stupidest of our population have already fallen for and which is basically 
about saying "let's get rid of anything that protects us against absolute Capitalist apocalypse". 


"Anarcho" capitalism is the worst stage of capitalism where there is no state, no entity 
supposed to protect the people, there is only one rule and that is the unlimited rule of the strongest corporation which has at its hands the most advanced technology there ever was. 


Here the strongest corporation takes over the world and.starts becoming the higher organism of the whole Earth, [capitalist sin ularity) (capitalist singularity md) has been reached. The world 
corporation doésn't have to pretend anything at this point, it can simply hire an army, it can use physical forcé, chemical weapons, torture, unlimited surveillance, anything to achieve further 
seize of remaining bits of power and resources. 


**People will NOT protest or revolt** at this point, they will accept anything that comes and even if they suffer everyday agony and_the system is clearly obviously set up for their maximum 
e 


exploitation, they will do nothing -- in fac hey will Continue to support system and make it stronger and they will seë more slavery as more freedom; this tendency is already present in 
[rightists]( eft vs right md) today. You may ask why, you think that at some point people will have enough and will seize back their power. This won't happen, just as the billions of chicken and 
pigs daily exploited at factories won't ever revolt -- firstly because the system will have absolute control over people at this point, they will be 100% dependent on the System even if they 


ate it, they will have proprietary technology as part of their bodies (which they willingly admitted to in the past as part of bigger comfort while ignoring our warnings about loss of freedom), 
they will be dependent on drugs of the system (called "vaccines" or "medicine"), air that has to be cleaned and is unbreathable anywhere one would want to escape, 100% of communication will be 
monitored to prevent any spark of revolution etc. Secondly the system will have rewritten [history] (histor má) so that people won't see that life used to be better and bearable -- just as today 
we think we live in the best times of history due to the interpretation of history that was force Ted us at schools and by other propaganda, in the future a human in every day agony will think 
history was even worse, that there is no other option than for him to suffer every day and it's a privilege he can even live that way. 


We can only guess what will happen here, a [collapse] (collapse. md) due to instability or total destruction of environment is possible, which would at least save the civilization from_the ‘ 
horrendous’ fate of being eternally tortured. If the System survives, humans will be probably be more and more genetically engineered to be more submissive, further killing any hope of a possible 
change, surveillance chips will be implanted to everyone, reproduction will be controlled precisely and finally perhaps the system will be able, thanks to an advanced [AT] (a1 md), to exist and 
work more efficiently without humans completely, so they will be eliminated. This is how the mankind ends. 


15e here you have it -- it's all here for anyone to read, explained and predicted correctly and in a completet logical way, we even offer a [way] (less_retarded_society md) to prevent this and 
ix the system, but no one will do it because this will be buried and censored by search engines and the 0.0000000000001% who will find this by chance will dismiss it due to the amount of 
brainwashing that's already present today. It's pretty sad and depressive, but what more can we do? ~drummyfish } 

## Capitalist Propaganda And Fairy Tales 

Capitalist brainwashing is pretty sophisticated -- unlike with centralized oppressive regimes, capitalism has a decentralized way of creating and spreading propaganda, in ways similar to for 
example self-replicating and self-modifying malware in the world of software. Creators and promoters of capitalist propaganda are mostly people who are unaware of doing so, they have been 


brainwashed and programmed by the system Tesett to behave that way, for example just by being exposed to hearing the capitalist fairy tales since they were born. Some examples of common 
capitalist propaganda you will probably encounter are the following: 


- *"Capitalism.is freedom."* -- This is of course a complete twist of the word freedom: capitalism promotes freedom of market which goes against the freedom of people. I.e. the freedom enabled 
by capitalism is the freedom to abuse others; the freedom to restrict freedoms of others, which is of almost the polar opposite of génuine freedom. 

*"In capitalism everyone can make it if he only works hard."* -- This is firstly of course not even logically possible, it's just as claiming that everyone can win the Olympic games; to reach 
the top in an extremely competitive system not only do you have to work hard, you also have to be born with the right talent, in the right place, to the Fight family, and be immensely lucky to 
be in right places in right times and make correct guess decisions in situations in which it is impossible to know the correct decision. Even if you work 24/7 without sleep, there will be 
thousands of others who do the same, your success is a pure bet on lottery: **Capitalist fairy tales make heavy use of the [survivorship bias](survivorship_bias.md)** -- you will see movies only 
about the successful people who are asked how they achieved success and who answer along the lines "I just worked hard". Indeed they did, but this doesn't imply that anyone working hard will 
succeed, this is the same as taking an advice from a lottery winner; if you ask a lottery winner how he won the lottery, he will simply say "I bet all I had on a random number". Following such 
advice is of course just about the worse decision you can make. If everyone can make it, why doesn't everyone do it, why don't we have a wold consisting exclusively of billionaires? 

- *"Capitalism just.works, capitalism is natural, capitalism means progress etc."* -- **Capitalism doesn't work, it's just hard to get rid of.** If it "works and.is natural", then it works and 
ie natural natural in the same way as for example cahcer or wars. This doesn't mean we should support it or see it as Something positive. Most of other similar lies are discussed in sections 
above. 

- Fairy tales about about the rich capitalist altruist: you will hear stories about famous gapitalists that paint them as nice guys who give to poor for free, who do manual work despite not 
having to etc. This is just part of cult of personality propaganda and applying cheap populist tricks to deceive masses. A rich guy giving $100 to a poor kid on camera is an extreme powerful 
marketing that costs $100, which for a billionaire is of course a laughable cost. The fact is that every billionaire is the best player of the most dirty game humanity has invented and 
researching any such guy reveals, basically in 100% of cases, that he was_in fact the worst imaginable psychopath -- Edison killed animals with electric current as_part of marketing, the owner 
of McDonald's stole the idea and know-how from McDonald brothers ALONG WITH their own name, similar thing happened with KFC, Steve Jobs was infamous for his psychological pressure on workers 
equating torture, the working condition's in Ford's factories were basically the same as those for black African slaves, etcetc. **Trying to find a rich man that's good is like trying to find a 
shark who's a vegetarian. ** 

*"Capitalism isn't perfect but it's the best system we know."*: complete [bullshit | (bullshit. may; capitalism is probably the worst system that there ever was. See this whole article. 

- *"Successful capitalists are the most intelligent people."*: on the contrary, mostly the stupidest people become successful -- success in capitalism. depends mostly on luck and. lack.of moral 
obstacles, i.e. doing whatever it takes to succéed such as stabbing friends in the back, public lying, exploitation of workers etc. High intel agence is actually a disadvantage in this manner as 
it makes one see all the negative consequences of his behavior, a smart man sees that by engaging in capitalism he is not just hurting and even killing other people, but even e.g. working 
towards destruction of art, culture, living environment and possibly life itself. Being a successful businessman in capitalism is like steering a plane full of people, including oneself, towards 
ground -- only an idiot can do it. 

- TODO: moar 


## So What To Replace Capitalism With? 


See [less retarded society](less_retarded_society.md). 
T0 capitalist singularity.md ---------- 
& Capitalist Singularity 


Capitalist singularity is a point in time at which capitalism becomes irreversible and the cancerous growth of society unstoppable due to corporations taking absolute control over society. It is 
when people loše any power to revolt against corporations as corporations become stronger than states and any other collective effort towards their control. 


This is similar to the famous [technological singularity] (tech singularity. md), the difference being that society isn't conquered by a digital ATI (ad md). but rather a superintelligent entity in 
a form of corporation. while many peoplé see the danger superintelligent Als, surprisingly not many have noticed that we've already seën risé of such AIs -- corporations. A corporation is an 
entity much more intelligent than any single individual, with the single preprogrammed goal of profit. A corporation doesn't have any sense of morals as morals are an obstacle towards making 
profit: gA cor: oration runs on humans but humans don't control them; there are mechanisms in place to discourage moral behavior of people inside corporations and anyone exhibiting such behavior 
is simply replaced. 

l0 CapitaList.software md T 

& Capitalist Software 


Capitalist software is [software](software.md) that late stage [capitalism](capitalism.md) produces and is practically 100% [shitty](shit.md) [modern](modern.md) [bloat](bloat.md) and [malware] 
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(malware.md) hostile, to its users, made with the sole goat of benefiting its.creator (often a [corporation] (¢erporation .md , Capitalist software is not just dprgprietary](proprietar ,md) 
Corporate software, but a lot of times "[open source]( pen source md) [indie](indie.md) software and even [free software](free software.md) that's just infected by the toxic capitalist 
environment -- this infection may come deep even into the basic design principles, even such things as [UI](ui.md) design, priorities and development practices and subtle software behavior which 
have simply all been shaped by the capitalist pressure on abusing the user. 


{ Seriously I don't have enough brain to understand how anyone can accept this shit. -drummyfish } 


Capitalist software largely mimics in technology what capitalist economy is going in society -- for example it employs huge waste of resources (computing resources such as RAM and CPU cycles as 
an equivalent to natural resources) in favor of rapid growth (accumulation of "[ eatures| (feature md) ) it creates hugely complex, interdependent and fragile ever growing networks (tons of 
library of hardware [dependencies](dependency.md) as an equivalent of import/export dependencies of Coüntries) and employs consumerism (e.g. in form of mandatory frequent [updates] 

(update culture.md)). These effects of course bring all the negative implications along and lead to highly inefficient, fragile, bloated, unethical software. 


Basically, everyone will agree that corporate software such as [Windows ] (windows -md) is to a high degree abusive to its .users, be it by its spying, unjustified hardware demands, forced non 
customizability, price etc. A mistake a lot of people make is to think that sticking a free [licensé](license.md) to similar software will simply maké it magically friendly to the user and that 
therefore most [FOSS](foss.md) programs are ethical and respect its users. This is sadly not the case, a license if only the first necessary step towards {freedom} (freedom md), but not a 
sufficient one -- other important steps have to follow. 


A ridiculous example of capitalist software is the most consumerist type: {games ] (game md) - AAA games are pure evil that no longer even try to be good, they just try to be addictive like drugs. 
Games on release aren't even supposed to work correctly, tons of bugs are the standard, something that's expected by default, customers aren't even meant to receive a finished product for their 
money. They aren't even meant to own the product or have any control over it (lend it to someone, install it on another computer, play it offline or play it when it gets retired). These games 
spy on people (via so called [anti-cheat](anti_cheat.md) systems), are shamelessly meant to be consumed and thrown away, purposefully incompatible ("exclusives"), [bloated](bloat.md), 
discriminative against low-end computers and even targeting attacks on children ("lootboxes"). Game corporations attack and take down fan modification and remakes and show all imaginable kinds 
of unethical behavior such as trying to steal rights for maps/mods created with the game's editor (Warcraft: Reforged). 


**But how can possibly a [FOSS](foss.md) program be abusive?** Let's mention a few examples: 


- Being a **[bloat monopoly](bloat monopoly.md)**. 
-.**Allowing [maintenance](maintenance.md) cost to be high** and prioritizing e.g. [features](feature creep.md) over maintainability leads to programs being expensive to maintain which : 
discriminizés against devélopers unable tó pay this maintenance cost. If a rich Corporation antent tonal ly. makes their program bloated and expensive to just maintain, it ensures no one poor will 
be able to fork the software and maintain it (let alone shape it into something better), which effectively removes the possibility of an ethical competition being made out of their "open source" 
program. 
- re (Blogt](bloat md), intentional [gbscuritvlfobscurity md) and | 'pdete culture](update culture.md) may lead to de-facto Cas opposed to de-jure) limitations of basic [freedom conditions] : 
(freé software.md), despite a free ticense**. Specificall reedo (to study thé software, which may be unnecessarily diffic and **expensivé**) and 2 (to modify the software, which requires 
its understanding, unnecessarily high cost of dealing with bad code and the ability to compile it which may be non-trivial). Therefore a company may, on paper, provide the rights to study and 
modify their program, but keep the actual know-how of the program's working and modification private, de-facto becoming the program's owner and sole controlling entity. 
- **Allowing [proprietary] (proprietary. md) [dependencies](dependency.md)**, which happens especially in [open source](open_source.md). While free software usually avoids this, open source is 
happy with €.g. Windows- y programs which of course requires the users to run abusive code in order fo he program to function. 
: teurneeessars.ly high [hardwgre | (hardware md) demands and dropping support for old hardware** which drives fcogsumerism] (consumerism. md) and discriminates_against poor people and people who 
just don't want to onsoom" hardware. A group can make "open source" software that intentionally requires the latest hardware that they just happen to sell (e.g. [gaymes](game.md) with "AAA 
graphics"), even if the software might in theory run on older hardware. Possible "fixes" of this by third parties can be prevented by the above mentioned techniques. 
- **Allowing [bloat](bloat.md) to increase the risk of security vulnerabilities and bugs** (which may in some ares be fatal and lead to literal deaths). 
- **Obscurity and interdependence may be used, to successfully hide malicious. features even within publicly accessible code**. See for example the anti-Russian "protestware" cases such as [node- 
ipc](node ipC.md), an "open source" package that introduced malicious file-wiping code and infected all software depending on it. 

**Introducing dangerous dependencies**: for example a fully free software may be unnecessarily designed as [cloud](cloud.md) software which increases the risk of its non functionality e.g. in 
cases of Internet blackouts (or just any loss of connection). 
- **Licenses can by bypassed**, e.g. [copyteft](co yleft.md) was legally eliminated by [Gopalel(google.qdy's Android] (android. md) which is based on &Spy tef ted [kinux] (Linux md): their 
proprietary Play Store is a 3rd party program to which the Copyleft doesn't apply but which is éSsential for Android and serves tô control Android (which should have been prevented by the 
copyleft). This is an example of a FOSS "protection mechanism" failing under capitalist pressure. 
- Setting up discriminatory .fascist and toxic centralized development communities** that de-facto own and control the software and use discriminatory practices and censorship, e.g. with 
[codes of conduct](coc.md). his allows to bully and "cancel" developers who are, for political or any other reason, unwelcome. 


- **Even free software may behave in unethical ways**. For example.a company that profits from gambling may create a completely "FOSS" game for children that however teaches them gambling so 
that when they grow up théy'll be more likely to become their victims. 


The essential issue of capitalist software is in its goal: profit. This doesn't have to mean making money directly, profit can also mean e,g. gaining popularity and political power. This goal 
goes before and eventually against goals such as helping and respecting the users. A free license is a mere obstacle on the way towards this goal, añ obstacle that may for a while slow down 
corporation from abusing the users, but which will eventually be overcome just by the sheer power of the market environment which works on the principles of Darwinian evolution: those who make 
most profit, by any way, survive and thrive. 


Therefore "fixin capitalist software is only possible via redefinition of the basic goal to just developing [selfless](selflessness.md) software that's good Tor the people (as opposed to 
making software for profit): This approach requires eliminating or just greatly limiting capitalism itself, at least from the area of technology. We need to find other ways than profit to 
motivate development of software and yes, other ways do exist Triora ity, social status, fun etc.). 

---------- cathedral.md ---------- 

# Cathedral 


Welcome to the cathedral. Here we mourn the death of [technology](technology.md) by the hand of [capitalism](capitalism.md). 


{ Sometimes we are very.depressed from what's going on in.this world, how technology is raped and used by living beings against each other. Seeing on a daily basis the atrocities done to the art 
we love and the atrocities done by it -- it is liké watching a living being die. Sómetimes it can help to just Know you are not alone. -drummyfish } 

R. I. P 

TECHNOLOGY 


long time ago - now 


Here lies technology who was 
helping people tremendous ty until 
its last breath. It was killed by 

capitalism. 


CCO is a [waiv 


Foot iota i § waiver.md) (similar to a [license](license.md)) of [copyright](copyright.md), created by [Creative Commons](creative_commons.md), that can be used to dedicate one's work to the 
public domain : 


EPA .md) (kind of) 


Unlike a license, a waiver. such as this *removes* (at,least effectively) the author's copyright; by using CCO the author willingly gives up his own copyright so that the work will no longer be 
owned by anyone (while a license preserves the author's copyright while granting some rights to other pedple). It's therefore the most [free | (rree_sof waré.md) and [permissivel(pepmissiv .md) 
option for releasing intellectual works. CCO is designed in a pretty sophisticated way, it also waives "neig boring rights" ([moral rig ts](moral_rights md)), and also contains a fallback i 
license in case waiving copyright isn't possible in à certain country. For this CCO is one of the best ways, if not the best, of truly and completely dedicating works to public domain world-wide 
(well, at least in terms of copyright). In this world of extremely fucked up [intellectual property](intellectual property.md) laws it is not enough to state "my work is public domain" -- you 
need to use something like CCO to achieve legally valid public domain status. 


CCO is recommended b [URS] (Trs md) for both programs and other art -- however for programs additional waivers of [patents] (patent md) should be added as CCO doesn't deal with patents. CCO is 
endorsed by the [ESE ( sf.md) but not [OSI](osi.md) (who rejected it because it explicitly states that trademarks and patents are NOT waived). 


## Things Under CCO 


Here are some things. and places with CCO materials that you can use in your projects so that you can release them under CCO as well. **BEWARE**: if you find something under CCO, do verify it's 
actually valid, normies often don't know what CCO means and happily post derivative works of proprietary stuff under CCO. 


TODO 


- software: 
- fuch of [LRS](lrs.md) sofware: [Anarch](anarch.md), [small3dlib](small3dlib.md), [raycastlib](raycastlib.md), [SAF](saf.md), 
- other assets: 
- many things on [Wikimedia Commons] (wikimedia_commons.md) 
- many things on open jameart 
- many things on BlendSwap 
- all of fdrummyt ish s] drummyfish.md) stuff including fonts, textures, 3D models etc. 
- [librivox](librivox.md) creates CCQ audiobooks from old books 
text: 


- [Esolang Wiki] (esolang.md) 

- OSdev Wiki [since 2011](https://wiki.osdev.org/OSDev Wiki:Copyrights) 
T censorship.md ---------- 
& Censorship 


*This page is not accessible in your country... NOT :)* 


Censorship means intentional effort towards preventing exchange of certain kind of information among other individuals, for example suppression of, [free speech] (free. Speech.md), altering old 
works of art for political reasons, forced takedowns of [copyrighted (copyragnt md) material from the [Internet |(internet.md) etc. Note that thereby censorship does **NOT** include some kinds of 
data or information filtering, for example censorship does not include fi fering gut [noise](noise.md) such as Spam] (spam: md) on_a forum or static from audio (as noise is a non-information) or 
PERSONAL avoidance of certain information (e.g. using [adblock](adblock.md) or hiding someone's forum posts ONL’ OR ONESELF). **Censorship is always wrong** -- in a [good society] 
(less_retarded_society.md) there is never a slightest reason to censor anything, therefore whenever censorship is deemed the best solution, something within the society is deeply Tucked up. In 
current society censorship, along with [propaganda](propaganda.md), brainwashing and misinformation, is extremely prevalent and growing -- it's being pushed not only by [governments 

government mdy and [corporations](corporation.md) but also by harmful terrorist groups such as [LGBT] (lgbt. md) and [reminism| (feminism. md who force media censorship (e.g. that of [Wikipedia] 
wikipedia.md) or search engines) and punishment of free speech (see [political correctness](political_correctness.md) and "[hate speech] (hate_speech.md)"). 


Sometimes it is not 100% clear which action constitutes censorship: for example categorization such as moving a forum post from one thread to another (possibly less visible) thread may or may 
not be deemed censorship -- this depends on the intended result of such action; moving a post somewhere else doesn't remove it completely but can make it less visible. Whether something is 
censorship always depends on the answer to the question: "does the action prevent others from information sharing?". 


There exist **tools for bypassing censorship** 


(hs Ej [ eu ssin [proxies](proxy.md) or encrypted and/or distributed, censorship-resistant networks such as Tor (tor .md) 
i2p.md) or [torren orrent.m r 


pre, Safe e [Ereenet] (freenet .md), [12P] 
file sharing. Watch out: using such tools may be illegal or at least make you look suspicious and be targeted hard ance. 


by state surveil 


## Examples 


# Chaos 


In mathematics] (math md) chaos is a phenomenon that makes it extremely difficult to predict, even a proximate ly: the result of some process even if we completely know how the process works and 
what state it starts in. In more technical terms chaos is a property of a [nonlinear](nonlinear.md) Tüeterminis ac] (determinism.md) [System] (system. md) in which even a very small ghange in input 
creates a great change in the output, i.e. the system is very sensitive to [initial conditions](initial condition.md). Chaos is a topic studied by the field called **chaos theory** and is 
important in all [science] (science md), In poomputer science|(compsci.md) it is important for example for the generation of [pseudorandom](pseudorandom.md) numbers or in [cryptography] 
(cryptography md) - Every programmer should be familiar with the existence of chaotic behavior because in mathematics (programming) it emerges very often, it may pose a problem but, of course, it 
may be taken advantage of as well. 


Perhaps, the.most important point is that a chaotic system is difficult to predict NOT because of [randomness] (randomness md), lack of information about it or even its incomprehensible complexity 
(many chaotic systems are defined extreme ty simply), but because of its inherent structure that greatly amplifies any slight nudge to the system and gives any such nudge a great significance. 
This may be caused by things such as [teed ack oops] (Feedback Loop.md) and [domino effects](domino effect.md). Generally we describe this behavior as so called **[butterfly effect 

(butterfly effect- md ** -- we liken this to the fact that a butterfly flapping its wings somewhere in a forest can trigger a sequence of events that may lead to causing a tornado in a distant 
City a few days later. 


. [logistic map] i 
. [Langtón's ant] lan tons ant.md) sometimés behaves chaotically. 
strength, it'll shoot and bounce off o 
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Examples of chaotic systems are the double pendulum, weather {which is why it is so difficult to predict it), dice roll, [rule 30](rule_30.md) cellular, automaton 
(logistic_map.md), gravitational interaction of IN bodies] (n_body.md) or }Lorenz differential equations] Lorenz system. md 


Another example may be e.g. a billiard table with multiple balls: if we hit one of the balls with enoug walls and other balls, setting them into motion 


the final,position would probably 


and so on.until all balls.come to stop in a specific position. If we hit the ball with exactly the same strength but from an angle differing Just by 1 degree, f (popiti z 
aws of motion, neglecting things like quantum physics) a slig ifference in inpü 


end up being completely different. Despite the system being deterministic (governed by exact ànd predictable 
causes a great different in output. 


A simple example of a chaotic equation is also the function *sin(1/x)* for *x* near 0 where it oscillates so quickly that just a tiny shift along the *x* axis drastically changes the result. See 
how unpredictable results a variant of the function can give: 


ae *1000 * sin(10^9 / x)* 


T1 cheating.md ---------- 
& Cheating 


Cheating means circumventing or downright violating rules, usually while trying to keep this behavior secret. You can cheat on your partner, in games, in business etc., however despite cheating 
seeming like purely immoral behavior at first, it may be even relatively harmless or even completely moral e.g. in [computer graphics](graphics.md) we sometimes "Cheat" our sense of Sight and 
fake certain visual phenomena which leads to efficient rendering algorithm a ch 


H ce sm.md) cheating is demonized and people are brainwashed to take part in **cheater wi 
unts**, 


In [capitalism](capita 


The truth is that. **cheating is only an issue in a,shitty society** that's driven, by competition. In such.society there is, a huge motivation for cheating. (sometimes literally, physical survival) 
as well as potential by» disastrous consequences of it. Under the tyranny of capitalism we are led to worsnip heroes and high achievers and everyone ets pissed when we get fooled. Corporations go 
ii y e 


"OH NOES our multi bilion dollar entertainment industry is going to go bankrupt if consoomers get annoyed cheaters! People are gonna lose their bullshit jobs! Someone is going to get money 
doesn't deserve! Our customers may get butthurt!!!" (as if corporations themselves weren't basically just stealing money and raping people lol). So they start a huge brainwashing propaganda 
campaign, a cheater witch hunt. States do the same, communities do the same, everyone wants to stone cheaters to death but at the same time the society pressures all of us to compete to death 
with others or else we'll starve. We reward winners and torture the losers, then bash people who try to win -- and no, many times there is no other choice than to cheat, the top of any 


competition is littered with cheaters, most quse don't get caught, so in about 99% of cases the only way to the top is to cheat and try to not get caught, just to have a shot at winning against 
others. It is proven time after time, legit looking people in the top leagues of sports, business, Science and other areas are constantly being revealed as cheaters, usually by pure accident 
(i.e. the number of actual cheater is MANY times higi er). Take a look e.g. at the Trackmania] (trackmania.md) cheating scandal in which after someone invented a re ta analysis tool he revealed 
that a great number or top level players were just Cheaters, including possibly thé GOAT of Trackmania [Rio lu] trio tu md) (who just ragequit and never showed again oly. Of course famous cases 
like Neil Armstrong don't even have to be mentioned. Cheater detection systems are (and always will be) imperfect and try to minimize [false positives |(false_positive .md) so only the cheaters 
who REPEATEDLY make MANY very OBVIOUS mistakes get caught, the smart cheaters stay and take the top places in the competitive system, just as surely as natural selection leads to the evolution 
of organisms that best adapt to the environment. Even if perfect cheat-detection systems existed, the problem would just shift from cheating to immoral unsporcmanship i.e. abuse of rules that's 
technically not. cheating but effectively presents the same kind of problems. How to solve this enormously disgusting mess? We simply have to stop desperately holding to the system itself, we 
ave to ditch it. 


In a good society, such as [ERS] (less retarded society.md), cheating is not an issue at all, there's no motivation for it. (people don't have to prove their worth by their.skills, there are no 
money, people don't worship heróés, ...) and there are no negative Consequences of cheating worse than someone [ragequitting]fragequit md an online game -- which really isn't an issue o 
cheating anyway but simply a consequence of unskilled player facing a skilled one (whether the pro's skill is natural or artificial doesn't play a role, the nub will ragequit anyway)» In a good 
society cheating can become a mild annoyance at worst, and it can really bea positive thing, it can be [fun](fun.md) -- seeing for example a skilled pro face and potentially even beat a cheater 
is a very interesting thing. If someone wants to win by cheating, why not let him? Valid answers to this can only be given in the context of a shit society. In a good society choosing to cheat 
in a game is as if someone chooses to fly to the top of a mountain by helicopter rather than climbing it -- the choice is everyone's to make. 


The fact that cheating isn't really an issue is supported by the hilarigusly vastly different double standards applied.e.g. by, chess platforms in this matter, on one, hand they state in their TOS 
they have absolutely 0% tolerance Of any kind of cheating/assistance and will lifeban players for the slightest suspicion of Cheating yelling "WE HAVE TO [FrGHr](fight.md) CHEATING", on the 
other hand they allow streamers literally cheat on a daily basis on live stream where everyone is seeing it, of course because streamers bring them money -- ALL top chess streamers (chessbrah, 
Nakamura, ...), including the world champion Magnus Carlsen himself, have videos of themselves getting advice on moves from the chat or even from high tevet players present during the stream 
Magnus Carlsen is filmed taking over his friend's low rated account and winning a game which is the sàme as if the friend literally just used an engine to win the game, and Magnus is also filmed 
getting an advice from a top grandmaster on a critical move in a tournament that won him the game and granted him a FINANCIAL PRIZE. **World chess champion is literally filmed winning money by 
Cheating and no one cares** because it was done as part of a highly lucrative stream "in a fun/friendly mood". Chessbrah streams frequently consist of many people in the room just giving advice 
on moves to the one who is currently playing, of course they censor all comments that try to bring up the fact that this is 100% cheating directly violating the platform's TOS. People literally 
have no brains, they only freak out about cheating when they're told to by the industry, when cheating is good for business people are told to shut up because it's okay and indeed they just shut 
up and keep consuming. 

T1 chess.md ---------- 


Chess is a very old two-player board [gane] (game. md) » perhaps most famous_and_ popular, among all board games in, [history] (history .md) - It is a {complete information](complete_information.md) game 

that simulates a battle of two armies On ai x8 board with different battle pieces. Chess is also calléd the King's Game, it has a world-wide Competitive community and is considered an 

intellectual [sport](sport.md) but it's also been a topic of research (as the estimated number of chess games is bigger than [googol](googol.md), it is unlikely to ever be solved) and 

programming] progr amming: md) (many chess engines, [AI](ai.md)s and frontends are being actively developed). Chess is similar to games such [shogi](shogi.md) ("Japanese chess"), [xiangqi] 
e 


xiangqi.md "Chinese chess") and [checkers](checkers.md). 


[There ig a nice plack and white indie movie called *Computer Chess* about chess programmers of the 1980s, it's pretty good, very oldschool, starring real programmers and chess players, check 
it out. -drummyfis| 


[Drummyfish](drummyfish.md) has created a suckless/[LRS](lrs.md) chess library [smallchesslib](smallchesslib.md) which includes a simple engine called *smolchess*. 
**At [LRS](lrs.md) we consider chess to be one of the best games** for the following reasons: 


- It is just a greatly interesting and deep game in which luck plays minimal role. 

.**It is greatly [gucktgss] (suck ess.md)**, the rules are, very simple, it can. be implemented on simple 8bit computers. Of course the game doesn't even require a computer,, just a board and a few 
pieces -- Chess masters don even need a board to play (they Can completely visualize the games in memory). In the end one can in theóry just play against himself in his'héad, achieving the 
ultimate freedom: the only dependency of the game is one's brain, i.e. it becomes a [brain software](brain software.md). Chess is extremely inexpensive, doesn't discriminate against poor people 
and will survive even the most extreme technological [collapse](collapse.md). 

- **No one owns chess**, the game is hundreds of years old and many books about it are also already in the [public domain] (public demain.md). It is extremely free. 

- It is a basis for other derived games, for example many different chess variants or chess puzzles which can be considered a "singleplayer chess game". 

- It is a source of many interesting [mathematical](math.md) and programming challenges. 

- It seems to strike the right balance of simplicity and complexity, it is very simple but not so trivial as to be ever solved in a foreseeable future. 


Chess, as a game is not and cannot be copyrighted, but **can_chess_ games (moves played in a match) be copyrighted?" Thankfully.there is a pretty strong consensus and precedence that say this is 
not the casé, even though capitalists try to play the intellectual property card from time to time (e.g. 2016 tournament organizers tried to stop chess websites from broadcasting the match moves 
under "trade secret protection", unsuccessfully). 


## Chess In General 


Chess.evolved from ancient board games in India in about 6th century. Nowadays the game is internationally governed by **FIDE** which has,taken the on role of an authority that defines the 
official rules: FIDE rules are considered to be the standard chess rules. FIDE also organizes tournaments, promotes the game and keeps a list of registered players whose performance it rates 
with so called Elo system - based on the performance it also grants titles such as **Grandmaster** (GM, strongest), **Internation Master** (a second nj ondes) or **Candidate Master** (CM). A 


game of chess is so interesting in itself that chess is üsually not played for money like many other games ([poker](poker.md), [backgammon] (backgammon.md), 


A,single game of chess is seen as consisting of three stages; **opening** (starting, _theoretical "book" moves, developing pieces **middlegame** (seen as the pure core of the game) and 
**endgame* * (ending in which only relatively few pieces rémain on the board). Theré is no clear border between these stages and hey are sometimes defined differently, however @ach’stage plays a 
bit differently and may require different skills and strategies; for example in the endgame king becomes an active piece while in the opening and middlegame he tries to stay hidden and safe. 


The study of chess openings is called togning theory** or, just *theory*. Playing the opening stage is special by being based on memorization of this theory, i.e. hundreds or even thousands, of 
existing opening lines that have been studied and analyzed by computers, rather than by performing mental calculation (logical "thinking ahead" present in middlegame and endgame)» Some see this 
as weakness of chess that makes players spend extreme energy on pure memorization. One of the best and most famous players, Bobby Fisher, was of this opinion and has created a chess variant with 
randomized starting position that prevents such memorization, so called *chess 960%. 


**[Elo](elo.md) rating** is a mathematical system of numerically rating the performance of Tayers (it is used in many sports, not just chess). Given two players with Elo rating it is possible 
to compute the probability of the game's outcome (e.g. white has 70% chance of winning etc.) he FIDE set the parameters so that the rating is roughly this: < 1000: beginner, 1000-2000: 


intermediate, 00-3000: master. More advanced systems have also been created, namely the Glicko system. 


The rules of chess are guite simple ([easy to learn, hard to master](easy to learn hard to master.md)) and can be found anywhere on the Internet. In short, the game is played on a 8x8 board by 
two players: one with **white** pieces, one with **black**. Each piece has a way of moving and capturing (eliminating) enemy pieces, for example bishops move diagonally while pawns move one 
square forward and take diagonally. The goal is to **checkmate** the opponent's king, i.e. make the king attacked by a piece while giving him no way to escape this attack. There are also lesser 
known rules that noobs often miss and ignore, e.g. so called en-passant or the 50 move rule that declares a draw if there has been no significant move for 50 moves. 


At the. competitive level **clock** (so called *time control*) is used to give each player a limited time for making moves: with unlimited move time games would be painfully long and_more a test 
of patience than skill. Clock can also nicely help balance unequal opponent by giving the stronger player less timé to move. Based on the amount of time to move there exist several formats, most 
notably **correspondence** (slowest, days for a move), **classical** (slow, hours per game), **rapid** (faster, tens of minutes per game), **blitz** (fast, a few seconds per move) and **bullet** 
(fastest, units of seconds per move). 


Currently the best player in the world is pretty clearly Magnus Carlsen from Norway with Elo rating 2800+. 


During [coyid] (covid. md} chess has experienced a small boom among .pormigs and [YouTube (youtube .md) chess channels have gained considerable popularity, This gave rise to [memes | (meme imd) such as 
the bong clou openana popatarized by a top player and streamer Hikaru Nakamura; the bong cloud is' an intentionally shitty opening that's supposed to taunt the opponent (it's been even played in 
serious tournaments lol). 


**white is generally seen as having a slight advantage** because he always has the first move, This.doesn't play such as big role in beginner and intermediate games but starts to become apparent 
in master games. How big the advantages i8 is a mattér of ongoing debate most people are of the opinion there exists a slight advantagé, some people think chess is a win for white with perfect 
al 


play while others believe chess is a draw with perfect play. Pro ly only very tiny minority of people think white doesn't have any advantage. 


On **perfect play**: as stated, chess is unlikely to, be ever solved so it is unknown if, chess is a theoretical forced draw or forced. win for white (or even win for black), however many 
simplified endgames and some simpler chess variants have already been solved. Even if chess was ever solved, it is important to realize one thing: **perfect play may be Unsuitable for humans** 
and so even if chess was ever solved, it might have no significant effect on the game played by humans. Imagine the following: we have a chess position in which we are deciding between move *A* 
and move *B*. We know that playing *A* leads to a very good position in which white has great advantage and easy play (many obvious good moves), however if black plays perfectly he can secure a 
draw here. We also know that if we play *B* and then py perfectly for the next 100 moves, we will win with mathematical certainty, but if we make jut one incorrect move during those 100 A 
moves, we will get to a decisively losing position. while computer will play move *B* here because it is sure it can play perfectly, it is probably better to play *A* for human because human is 
very likely to make mistakes (even a master). For this reason humans may willingly choose to play mathematically worse moves -- it is because a slightly worse move may lead to a safer and more 
comfortable play for a human. 


## Chess And Computers 
£[This](https://www.youtube.com/watch?v-DpXyO41BIlA) is an absolutely amazing video about weird chess algorithms :) ~drummyfish} 


Chess are a big topic in computer science and programming, computers not only help people play chess, train their skills, analyze positions and perform research of games, but they also allow 
mathematical analysis of chess and provide a platform for things such as [artificial intelligence](ai.md). 


There is a great online Wiki focused on programming chess engines: https://www.chessprogramming.org. 


Chess software is usually separated to **libraries** 
other things such as evalu 
underlying engine. 


md) ogram capable of playing,chess but also, doing 
ui Programs that help people interact with the 


**chess engines** and.**frontends** (or boards). Chess engine is typically a [CLI](c ü By 
m 


ik 
ating arbitrary position, hinting best moves, saving and loading games etc. Frontends' on the other hahd are ls] g 


For communication between different engines and frontends there exist standards such as XBoard (engine [protocol](protocol.md)), UCI (another engine protocol), FEN (way of encoding a position as 
a string), PGN (way of encoding games às strings) etc. 


Computers have already surpassed the best humans in their playing strength (we can't exactly compute an engine's Elo as it depends on, hardware used, but generally the strongest would rate high 
above 3000 FIDE). As of 2021 the strongest chess engine is considered to be the [FOSS](foss.md) engine [Stóckfish](stockfish.md), with other strong enginés being e.g. Leela Chess Zero (also 
FOSS) or AlphaZero ({proprietary] (proprietary .md), y [Google](google.md)). [GNU Chess](gnu_chess.md) is a pretty Strong [free software] (free_software.md) engine b GNU](gnu.md). There are 
world championships for chess engines such as the *Top Chess Engine Championship. or *World Computer Chess Championship*. [CCRE https ccrl.chessdom.com/ccr1/4040/ 

along with their Elo ratings. Despite the immense strength of modern engines, there are still very specific situation in which humans beat the computer (shown e.g. in 
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is à list of chess engines 


[this](https://www.youtube.com/watch?v-R9IZWgArWUE) video). 


The first chess computer that beat the world champion (at.the time Gary Kasparov) was famously [deep Blue] (deep bue mea in 1997. [Alan Turing] (turing md) himself has written a chess playing 
ERE but at his time there were no computers to run it, so he executed it by hand -- nowadays the algorithm has beén implemented on computers (there are bots playing this algorithm e.g. on 
ichess). 


For online chess there exist many servers such as, https://chess.com or https://chess24,com, but for us the most important is https://lichess.org which is gra 
allows users to run bots under special accounts which is an amazing way of testing engines against people and other engines). These servers raté players with 
each other or against computer, solve puzzles, analyze games, play chess variants, explore opening databases etc. 


tis and uses I SS](foss.md) (it also 
Elo/Glicko, allow them to play with 


Playing strength is not the only possible measure of chess engine quality, of course -- for example there are people who try to make the **smallest chess programs** (see ogunter com lex] 
(countércompléx.md) and [ Oring] ego tt md ). As of 2022 the leading programmer of smallest chess programs seems to be Oscar Toledo G. (https://nanochess.org/Chess.html). Unfortunately his 
rograms are [proprietary] (proprietary md , even though their source code is public. The programs include Toledo Atomchess (392 [x86](x86.md) instructions), Toledo Nanochess (world's smallest 
[ctc md) chess program, 7 hon-blank C characters) and Toledo Javascript chess (world's smallest [Javascript](javascript.md) chess program). He won the [10CCC] (ioccc.md). nother small chess 
program is micro-Max by H. G. Muller (https://home.hccnet.nl/h.g.muller/max-src2.html, 1433 C characters, Toledo claims it is weaker than his program). 


{ Nanochess is actually pretty strong, in my testing it easily beat [smallchesslib](smallchesslib.md) Q Q -drummyfish } 
## Stats And Records 

Chess stats are pretty [interesting](interesting.md). 

{ Some chess world records are here: https://timkr.home.xs4all.nl/records/records.htm. -drummyfish } 


**Number of possible games** is not known exactly, Shannon estimated it at 10^120 (lower bound, known as *Shannon number*). Number of possible games by plies played is 20 after 1, 400 after 2, 
8902 after 3, 197281 after 4, 4865609 after 5, and 2015099950053364471960 after 15. 


it is estimated to at least 10^40 and 10^50 at most. Numbers of 


Similarly the number of possibly reachable positions fpogition for which so called *proof game* exists) is OE Known exactly; 
f after 11. 


possible positions by plies is after 1, 400 after 5362 after 3, 72078 after 4, 822518 after 5, ahd 7261! 


Shortest possible checkmate is by black on ply number 4 (so called *fool's mate*). As of 2022 the longest known forced checkmate is in 549 moves -- it has been discovered when computing the 
Lomonosov Tablebases. 


Average game of chess lasts 40 moves. Average [branching factor](branching factor.md) (number of possible moves at a time) is around 33. 
White wins about 38% of games, black wins about 34%, the remaining 28% are draws. 


What is the sr LOngesE possible game**? It depends on the.exact rules and details we set, for example if, a 50 move rule applies, a player MAY claim a draw but also doesn't have to -- but if 
neither player evér claims a draw, a game can be played infinitely -- so we have to address details such as this. Nevertheless the longest possible chess game upon certain rules has been 
computed by [Tom7](tom7.md) at 17697 half moves in a paper for [SIGBOVIK](sigbovik.md) 2020. 


The longest game played in practice is considered to be the one between Nikolic and Arsovic from 1989, a draw with 269 moves lasting over 20 hours. For a shortest game there have been ones with 
zero moves; Serious decisive shortest game has occurred multiple times like this: °1.d4 Nf6 2.Bg5 c6 5.ea Qa5*' (white resigned). 


What's **the most typical game**? We can try to construct such a gane from a game database by always picking, the, most common move in given position. Using the lichess database at the time of 
writing, we get the following incomplete game (the remainder of the game is split between four games, 2 won by white, 1 by black, 1 drawn): 


1. e4 e5 2. Nf3 Nc6 3. Bc4 Bc5 4. c3 Nf6 5. d4 exd4 

6. cxd4 Bb4+ 7. Nc3 Nxe4 8. 0-0 Bxc3 9. d5 Bf6 10. Rei Ne7 
11. Rxe4 d6 12. Bg5 5x95 13. Nxg5 h6 14. ge2 hxg5 

15. Rei Be6 16. dxe6 fö 17. Re3 c6 18. Rh3 Rxh3 

19. gxh3 g6 20. Qf3 Qa5 21. Rd1 Qf5 22. Qb3 0-0-0 

23. Qa3 Qc5 24. Qb3 d5 25. Bf1 


You can try to derive your own stats, there are huge free game databases such as the Lichess [CC0](ccO.md) database of billions of games from their server. 
## Variants 


Besides Similar games such as [shogi](shogi.md) there are many variants of chess, i.e. slight modifications of rules, foremost worth mentioning is for example chess 960. The following is a list 
of some variants: 


- **antichess** ([Suicide](Suicide md), ...): The goal is to lose all pieces or get stalemated, rules are a bit changed, e.g. castling and checks are removed and taking is forced. 

- **chess 960** àka **Fisher's random**: Starting position is randomly modified by shuffling the non-pawn rows (with these rules: king must be between rooks, bishops on opposite colors and 
black/white's positions are mirrored). The rules are the same with a slight modification to castling. This was invented by Bobby Fishér to emphasize pure chess skill as opposed to memorizing the 
best opening moves, he saw the opening theory as harmful to chess. Chess 960 is nowadays even advocated by some to become the "main" version of chess. 

- **[chess boxing](chess boxing.md)**: Chess combined with box, players switch between the two games, one wins either by checkmate or knockout. A 

- kinfazyhbuses*: When a player captures a piece, it goes into his reserve. From the reserve a piece can be dropped (as a piece of the current player's color) to an empty square instead of 
making a normal move. 

- **different pieces**: Some variants use different pieces, e.g. empress (moves like rook and knight) or amazon (queen/knight). 

-.**duck chess**: After each move players place a duck on an empty square, the duck blocks the square. The duck cannot be left on the same square, it has to be moved. There are no checks, 
players win by capturing the king. 

- **fog of war**: Makes chess an incomplete-information game by allowing players to only see Squares they can immediately move to (this is similarly to some strategy video games) . 

- **horde chess**: Asymmetric starting position: large number of black pawns vs a white army of traditional pieces. Rules are slightly modified, e.g. black can only be defeated by having all 
pawns captured (there is no black king). 

- **infinite chess**: Infinite chessboard. 

**minichess**: Smaller chessboard, e.g. 4x4, 4x8 etc. Some are already solved (e.g. 3x3). 

**more players**: E.g. 3 man chess or 4 player chess allow more than two players to plays some use different boards. 

**old chess**: The rules of chess itself have been changing over time (e.g. adding the 50 move rule etc.). The older rule sets can be seen as variants as well. 

**puzzle**: For single player, chess positions are presented and the player has to find the best move or sequence of moves. 

**racing kings**: The starting position has both players on the same side, the goal is to get one's king to the other side first. 

**3D chess**: [3D](3d.md) generalization of chess. 

arunan domiy chosen variant**: Here a chess variant to be played is chosen at random before the game, e.g. by dice roll. { This is an idea I got, not sure if this exists or has a different name. 
-drummyfis 


## Programming Chess 


Programming chess is.a [fun](fun.md) and enriching experience and is therefore recommended as a good exercise. There is nothing more satisfying than writing a custom chess engine and then 
watching it play on its own. 


The core. of chess programming is writing the AT] (ai-md), everything else, i.e. implementing. the rules, communication protocols etc., is pretty straightforward (but still a good rogramming 
exercise). Nevertheless one has to pay great attention’ to eliminating aS many bugs as posSible; really, the importance of writing automatic tests can't be stréssed enough as debugging thé AI 
will be hard enough and can become unmanageable with small bugs creeping in. 


The AI itself works in almost all.cases.on the same principle; firstly we implement.so called static **eyaluation.function** -- a.function that takes a chess position and outputs its evaluation 
number which say how good the position is for white Vs black (positive number favoring white, negative black). This function considers a number of factors such as total material of both players, 
pawn structure, king safety, piece mobility and so on (in new engines this function is often a learned [neural network](neural network.md), but it may very well be written by hand). Secondly we 
implement a **search** algorithm -- typically some modification of [minimax](minimax.md) algorithm -- that recursively searches the game tree and looks for a move that will lead to the best 
result, i.e. to position for which the evaluation function gives the best value. This basic principle, especially the search part, gets very complex as there are many possible weaknesses and 
optimizations. 


Exhaustiyely searching the_tree to great depths is not possible due to astronomical numbers of possible move combinations, so the engine has to limit the depth quite greatly. Normally it will 
search all moves to a small depth (€.g. 2 or 3 half moves or *plys*) and then extend the search for interesting moves such as exchanges or checks. Maybe the greatest danger of searching 
algorithms is so called **horizon effect** which has to be addressed somehow (e.g. by detecting quiet positions, so called *quiescence*). If not addressed, the horizon effect will make an engine 
misevaluate certain moves by stopping the evaluation at certain depth even if the played out situation would continue and lead to a yastly different result (imagine e.g. a queen taking a pawn 
which is guarded by another pawn; if the engine Stops evaluating after the pawn take, it will think it's a won pawn, when in fact it's a lost queen). There are also many techniques for reducing 
the number of searched tree nodes and speeding up the search, for example pruning methods such as **alpha-beta** (which subsequently works best with correctly ordering moves to search), or 
**transposition tables** (remembering already evaluated position so that they don't have to be evaluated again when encountered by a different path in the tree). 


Many other aspects come into the AI design such as opening books (databases of best opening moves 


e AI . endgame tablebases (databases of winning moves in simple endgames), heuristics in search, 
clock management, pondering (thinking on opponent's move), learni k 


g from played games etc. For Selai te See the above linked chess programming wiki. 
## Rules 
The exact rules of chess and their scope may depend on situation, this is just a sum up of rules generally used nowadays. 


The start setup of a chessboard is_following (lowercase letters are for black pieces, uppercase for white pieces (though many dislike this, for simplicity let's call pawns "pieces" too), ona 
board with colored squares A1 is black): 
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Players take turns in making moves, white always starts. A move consists of moving one (or in special Cases two) of own pieces from one square to another, possibly capturing (removing from_the 
board) one opponent's piece -- except for a special *en passant* move capturing always happens by moving one piece to the square occupied by the opposite color piece (which gets removed) of 
course no piece can move to a square occupied by another piece of the same color. A move can NOT be skipped. A player wins by giving a **checkmate** to the opponent (making his king unable to 
escape attack) or if the opponent resigns. If a player is to move but has no valid moves, the game is a draw, so called **stalemate**. If neither player has enough pieces to give a checkmate, 
the game is a draw, so called **dead position**. There are additional situation in which game can be drawn (threefold repetition of position, 50 move rule). Players can also agree to a draw. A 
player may also be declared a loser if he cheated, if he lost on time in a game with clock etc. 


The individual pieces and their movement rules are: 


- **pawn** (^P^): Moves 1 square forward (white towards 8th rank, black towards ist rank), unless that square is occupied by any piece (even enemy piece, pawns cannot capture going forward). 
From its stárt position a pawn can optionally move 2 squares if neither of the 2 forward squares are occupied. Pawn can capture enemy pieces 1 square diagonally forward gies square forwârd 
right or 1 square forward left). 

ip. TOOTS (R^): Moves any number of squares either horizontally or vertically, but cannot jump over any pieces, however can capture (i.e. land) on a square occupied by enemy piece and capture 
i 


- **knight** CN Can jump over pieces (both friendly and enemy), moves in "L" shapes, i.e. from its square a knight can jump to (with a possible capture) a square 2 squares in one direction 
and 1 square in the perpendicular direction (e.g. 2 squares down and 1 square right, or 2 squares right and 1 square up etc.). 

- **bishop** (`B`): Moves like rook but diagonally, i.e. a bishop will only ever be able to move on squares of one color (the one it starts on). 

- **queen** ( Q^): Can move both like bishop and rook. p ji . ‘ 

- **king** ( K ): Can move (and capture) to any of the 8 immediately neighboring squares. 


**Check**: If the player's king is attacked, i.e. it is immediately possible for an enemy piece to capture the king, the player is said to be in check. A player in check has to make such a move 
as to not be in check after thàt move. 
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A player cannot make a move that would leave him in check! 


**Castling**: If a player hasn't castled yet and his king hasn't been moved yet and his kingside (queenside ) rook hasn't been moved yet and there are no pieced between the king and the kingside 
(queensade ) and the king isn't and wouldn't be in check on his square or any square he will pass through or land on during cast Ling, short (long) castling can be performed. In short (long) 
castling the king moves two squares towards the kingside (queenside) rook and the rook jumps over the king to the square immediately on the other side of the king. 


**Promotion**: If a pawn reaches the 1st or 8th rank, it is promoted, i.e. it has to be switched for either queen, rook, bishop or knight of the same color. 
**Checkmate**: If a player is in check but cannot make any move to get out of it, he is checkmated and lost. 


**En passant**: If a pawn moves 2 squares forward (from the start position), in the immediate next move the opponent can take it with a pawn in the same way as if it only moved 1 square forward 
(the only case in which a piece captures a piece by landing on an empty square). 


Threefold repetition_is a rule_allowing a player to claim a draw if the same position (piece positions, player's turn, cast ling rights, en passant state) occurs three times (not necessarily 
a CUTIVE Y] The 50 move rule allow$ a player to claim a draw if no pawn has moved and no piece has'been captured in last 50 moves (both players making their move counts as a single move 
ere). 


## LRS Chess 
Chess is only mildly [bloated](bloat.md) but what if we try to unbloat it completely? Here we propose the LRS version of chess. The rule changes against normal chess are: 


No castling. 

No en passant. 

Promotion is always to queen. 

No checks or checkmates, king is just another piece. 

Whoever takes the opponent's king first wins. 

If a player has no available moves, he loses. 

- only a single draw rule: if game doesn't end in 1024 half moves or fewer, it is a draw. I.e. there are no weird draw rules (50 move, repetition, ...). Of course players may still agree on draw 
anytime. 

- Random: optionally. random variant of LRS chess can be played. Here we randomly shuffle the white player's back row pieces in the starting position and mirror it for black (no weird conditions 
on piece positions like in chess 960). 


## See Also 


checkers] (checkers.md 
backgammon] (backgammon . md ) 
cloud.md ---------- 
# "Cloud Computing" 


i fehee ann (nex ann; md) 


*Cloud is just someone else's computer.* 


Cloud computing, more accurately known as clown computing, Means giving up an autonomous computer by storing one's data as well as running one's programs on someone else's (often a 
corporation's) [computer Í (compu er.md), known as *the cloud*, through the [Internet](internet.md) ecoming wholly [dependent | (dependency md) on *someone else* to which one gives all the power. 
While the general idea o server computers](server.md) and remote [terminals](terminal.md) is not bad in itself an may be utilized in very good ways, the term *cloud computing* stands for 
abusing this idea e.g. by Capitalists |(capitalism.md) or states to take away autonomous computers from the people as well as to restrict freedoms of people in other ways, for example by pushing 
DRM](drm.md), making it impossible to truly own a copy of software or other data, to run computations privately, isolated from the Internet or run non-approved, [user-respectin 

free software.md) software. Moreover clown computing as applied nowadays is most ly a very bad engineering approach that wastes [bandwidth](bandwidth.md), introduces [lag](lag.md), requires 
complex and expensive infrastructure etc. 


Despite all this "cloud" is the mainstream, nowadays, it is the way of computin ) n 

they're constantly being pushed to it by the [big tech](big tech.md) ([Apple](apple.md), [Googlé](google.md), [Macrosost | (microsoft mos; ees) 

are simply supposed to SHUT UP AND CONSUME. And of course they wouldn't even have an idea about what's going on in the first place, all that matters to a normie is comfort] (comfort md)" 
cLeveryone does it](everyone does it.md), T: just need my [T3kToK] CEKEOK md) etc. [Zoomers](zoomer.md) probably aren't even aware of the cloud, they simply have phones with apps that show 
their photos if Apple approves of it, they don't even care how shit works anymore. 


g among fnormies {(normacs md even despite regular leaks and losses of their ersonal data etc., simply. because 
pi - man 


y times they don't even have a choice, they 


In the [repara (fusyre men non-cloud computers will most likely become illegal. This will be justified by autonomous computers being "dangerous", only needed by [terrorists](terrorist.md), 
pedophiles](pedophilia.md). An autonomous computer will be seen as à [gun](gun.md), the right to own it will be greatly limited. 


{ We have a [C tutorial](c tutorial.md)! -drummyfish } 


Cisa [how levet (tow level md), structured, [statically typed] (static typing md) [imperative (imperative md) compiled [programming language] (programming _language.md), the go-to language of 
[less rétarded](lrs.md) programmers. It is the absolutely preferred language of the [suckless](suckless.md) community as well as of most trüe experts, for examplé the tina] linux m l and 
OpenBSD](openbsd.md) developers, because of its good, relatively simple design, uncontested performance, wide support, great number of compilers, level of control and a greatly established and 
tested status. C is perhaps the most important language in history, it influenced, to smaller or greater degree, basically all of the widely used languages today such as [C++](c.md), [Java] 


(java.md), [JavaScript](javascript.md) etc., however it is not a thing of the past -- in the area of low level programming C is still the number one unsurpassed language. 
{ Look up *The Ten Commandments for C Programmers* by Henry Spencer. ~drummyfish } 


It is usually not, considered an_easy pangua e to learn because of itş, low level nature: it requires good_understanding of how a [computer |(gomputer md) actually works and doesn't prevent the 
rogrammer from shooting himself in the Too Programmer is given full control (and therefore responSibility). There are things Considered "tricky" which one must be aware of, such as undefined 
ehavior of certain operators and raw pointers. This is what can discourage a lot of modern "coding monkeys" from choosing C, but it's also what inevitably allows such great performance -- 
undefined behavior allows the Comp ter to_choose the most efficient implementation. On the other hand, C as a language is pretty simple without [modern](modern.md) bullshit concepts such as 
00P](oop.md), it is not as much hard to learn but rather hard to master, as any other true art. 


C is,said,to be the **"platform independent fassembly] (assembly.md)"?7 because, of its low level nature, great Performance etc, -- though C is structured (has control. structures such as branches 
and loops) and can be used in a relatively high level manner, it i$ also possible to write assembly-like code that operates directly with bytes in memory through [pointers] (pointer md) without 
many safety mechanisms, so C is often used for writing things like hardware [drivers](driver.md). On the other hand some restrain from likening C to assembly because C compi 


ers still perform 
many transformations of the code and what you write is not necessarily always what you get. 


Mainstream consensus acknowledges that C. is among,the best languages for writing, low level code and code that requires performance, such as,[operating pystems ] (operating system.md), [drivers] 
(driver.md) or [Games (gane may. Even scientific libraries with nórmie-language interfaces -- e.g. various [machine pearning | (machine. Learni, .md) [Python](python.md) libraries -- usually have 
the performance critical core written in [C1 (c: md) ; Normies will tell you that for things outside this Scope C is not a goo anguage, with which we disagree -- [we](lrs.md) recommend using C 
for basically everything that's supposed to last, i.e. if you want to write a good website, you should write it in C etc. 


## History and Context 


C was developed in 1972 at [Bell Labs](bell labs.md) alongside the [Unix](unix.md) operating system by [Dennis Ritchie](dennis, ritchie.md) and [Brian Kerninghan](brian kerninghan.md), as a . 
successor to the n] (bomd) anguage ( portable] (por abili ym language with [recursion](recursion.md)) written by Denis Ritchie and [Ken Thompson](ken thompson.md), which was in turn inspired 
by the the [ALGOL](algol.md) language (code blocks, lexica [scope] (scope md); ves 


In 1973 Unix,was rewritten in C, In 1978 Keninghan and Ritchie, published a book called *The C Programmin Language" known as *K&R*, which became something akin the C specification. In 1989, the 
[ANSI C](ansi c.md) standard, also known as C89, was released by the American ANSI. The same standard was also adopted a year later'by the international I50, so C90 refers to the same language. 
In 1999 ISO issues a new standard that's known as C99. 


TODO 
## Standards 
C is not a single language, there have been a few standards over the years since its inception in 1970s. The notable standards and versions are: 


- **K&R C**: C as described by its inventors in the book *The C Programming Language*, before official standardization. This is kind of too ancient nowadays. . 
- **C89/C90 (ANSI/ISO C)**: First fully standardized version, usable even today, many hardcore C programmers stick to this version so as to enjoy maximum Compiler support. 

- **C95**: A minor update of the previous standard, adds wide character support. 

:.**C99**: Updated standard from the year 1999 striking a great balance between "[modern](modern.md)" and "good old". This is a good version to use in [LRS](lrs.md) programs, but will be a 
little less Supported than C89, even though still very well supported. 

**C11**: Updated standard from the year 2011. This one is too [bloated](bloat.md) and isn't worth using. 

**C17/C18**: Yet another update, yet more bloated and not worth using anymore. 


[LRS](lrs.md) should use C99 or C89 as the newer versions are considered [bloat](bloat.md) and don't have such great support in compilers, making them less portable and therefore less free. 


The standards of C99 and older are considered, pretty [future-proof (future proof.md) and using them will help your program.be future-proof as well, This is to.a high degree due to C having been 
established and tested better than any other language; it is one of the oldest languages and à majority of the most esSential software is written in C, C compiler is oné of the very first things 
a new hardware platform needs to implement, so C compilers will always be around, at least for historical reasons. C has also been very well designed in a relatively minimal fashion, before the 
advent of modern feature-creep and and bullshit such as [00P](oop.md) which cripples almost all "modern" languages. 


## Compilers 


gcc](gcc.md): the main pig name" that can compile all kinds of languages including C, used by default in many places, very [bloated](bloat.md) 
clan Veian .md): another big bloated compiler, kind of competes with gcc 
tcc](tcc.md): tiny C compiler, [guekless) (sucktess md), cannot optimize as well as the big compilers but is pretty elegant 
scc](scc.md): another small/suckless C compiler 

8c](8c.md), [8cc](8cc.md) 


## Standard Library 


Besides the pure C.language the C standard specifies a set of [libraries](library.md) that have to come with.a standard-compliant C implementation -- so called standard library, This includes 
e.g. the *stdio* library Tor performing standard [input/output](io.md) (reading/wrating to/from screen/files) or the *math* library for mathematical functions. It is usually relatively okay to 
use these libraries as they are required by the standard to exist so the [de endeney | ( e endency «md ) they create is not as dangerous, however many C implementations aren't completely compliant 
with the standard and may come without the standard library. So for sake of [portability](portabili cmd) it is best if you can avoid using standard library. 


The standard library (libc) is a subject of live debate because while its interface and behavior are given by the C standard, its implementation is a matter of each compiler; since the standard 
library is so commonly. used, we should take great care in assuring it's extremely well written. As you probably guessed, the popular implementations ([glibc](glibc.md) et al) are [bloat] 
(bloat.md). Better alternatives thankfully exist, such as: 


uclibc] (uclibc.md) 
not using](dependency.md) the standard library :) 


- futia uci be 


## Bad Things About C 


Nothing is perfect] (perfect md) not even C; it was one of the first relativel higher level languages and even though it has showed to have been designed extremely well, some things didn't age 
great, or were simply bad from the start. We'still prefer this language as usually the best choicé, but it's good to be aware of its downsides or smallér issues, if only for the saké of one day 
lesigning a better language. Keep in mind all here are just suggestions, they made of course be a subject to counter arguments and further discussion. So, let's go: 


- **C specification (the ISO standard) ig, [proprietary] (proprietary md)" :( The lan uage itself probably can't be copyrighted, nevertheless this may change in the future, and a proprietary 
specs lowers C's accessibility and moddabitity (you cà make derivative versions of the spec). 


-.**The specification is also long as,fuck**, indicating [bloat (bloat.md)/gomplexity/zobscuritv. A good free language should have_a simple definition. It could be simplified a lot by 
simplifying the language itself aš well as dropping somé truly legacy considerations (like [BCD](bcd.md) systems?) ahd removing a lot of undefined behavior. 


- **Some behavior is weird and has exceptions**, for example a function can return anything, including a 'struct', except for an array. .This makes it awkward to e.g. implement vectors which 
would best be made as arrays but you want functions to return them, so you may do hacks like wrapping them instide a struct just for this. 


- **Some things could be made simpler**, e.g. using [reverse polish](reverse polish.md) notation for expressions, rather than expressions with brackets and operator precedence, would make 


165 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


implementations much simpler, increasing sucklessness (of course readability is -an argument). : ME : . 

- **Some things could be dropped entirely** ([enums](enum.md), [bitfields](bitfield.md), possibly also unions etc.), they can be done and imitated in other ways without much hassle. 

i **The preprocessor isn't exactly elegant**, it has completely different syntax and rules from the main language, not very suckless -- ideally preprocessor uses the same language as the base 
anguage. 

- **The syntax is sucky sometimes**, e.g. data type names may consist of multiple tokens (atge long int` etc.), multiplication uses. the same symbol as. ginger dereference £.* la also it's 
pretty weird that the Condition after “if has to be in brackets etc., it could be designed better. Keywords also high be better being single chars, like `?` instead of “i etc. A shorter, 
Datural- language: neutral source code would be probably better. Both line and block comments could be implemented with a single character (e.g. `#` for line comment, ending with a newline or 
another ^£, `##` for block comment ending with another “##°?). 

- **Some undefined/unspecified behavior would maybe be better defined/specified** -- undefined behavior isn't bad.in general, it, is what allows C to be so fast and efficient, in the first place, 
but some of it has shown to be rather cumbersome; for example the unspecified representation of integers, their binary size ànd behavior of floats leads to a lot of trouble (unknown upper 
bounds, sizes, undefined behavior of many operators etc.) while practically all_computers have settled on using 8 bit bytes, [two's complement ] (twos_complement md) and IEEE754 for [floats] 
(float.md) -- this could easily be made a mandatory assumption which would simplify great many things without doing basically any harm. New versions of actually already settle on two's 
complement. This doesn't mean C should be shaped to reflect the degenerate "moder (modern md)" trends in programming though! 

- Some basic things that are part of libraries or extensions, like fixed width types and binary literals and possibly very basic I/O (putchar/readchar), could be part of the language itself 
rather than provided by libraries. 

- All that stuff with *.c* and *.h* files is unnecessary, there should just be one file type -- this isn't part of the language per se, but it's part of its culture. 

- TODO: moar 


## Basics 
This is a quick overview, for a more in depth tutorial see [C tutorial](c tutorial.md). 


A simple program in C that writes "welcome to C" looks like this: 


#include <stdio.h> // standard I/O library 
int main(void) 
// this is the main program 
puts("welcome to C"); 


return 0; // end with success 


You can simply paste this code into a file which you name e.g. “program.c’, then you can compile the program from command line like this: 
“gcc -o program program.c^ 

Then if you run the program from command line (^./program? on Unix like systems) you should see the message. 

## Cheatsheet 

It's pretty important you learn C, so here's a little cheat sheet for you. 

**data types** (just some): 


**int**: signed integer, at least 16 bits (-32767 to 32767) but usually more 

‘unsigned int**: unsigned integer, at least 16 bit (0 to 65535) but usually more por a 

**char**: smallest integer of at least 8 bits (1 byte, 256 values), besides others used for containing [ASCII](ascii.md) characters 
**unsigned char**: like char but unsigned (0 to 255) 

**float**: [floating point](float.md) number (usually 32 bit) 

**double**: like float but higher precision (usually 64 bit) 

**short**: smaller signed integer, at least 16 bits (-32767 to 32767) 

**long**: bigger signed integer, at least 32 bits (-2147483647 to 2147483647) 
**pointer**: memory address (size depends on platform), always tied to a specific t 
**array**: a sequence of values of some type, e.g. an array of 10 integers: 'int[10 
**struct**: structure of values of different types, e.g. “Struct myStruct { int myInt; chat myChar; j^ 

note: header *stdint.h* contains fixed-width data types such as *uint32 t* etc. 

note: there is no EU e a string is an array of *char*s which must end with a value 0 (string terminator) 

note: there is no real **bool** (actually it is in header *stdbool*), integers are used instead (0 - false, 1 - true) 


yee, e.g. a pointer to integer: `*int`, pointer to double: `*double` etc. 


**branching aka if-then-else**: 


if (CONDITION) 
// do something here 
else // optional 


// do something else here 


**for loop** (repeat given number of times): 


for (int i = 0; i « MAX; ++i) 


// do something here, you can use i 


**while loop** (repeat while CONDITION holds): 


while (CONDITION) 


// do something here 


**do while loop** (same as *while* but CONDITION at the end): 
do 

// do something here 
} while (CONDITION) ; 


**function definition**: 


RETURN TYPE myFunction (TYPE1 parami, TYPE2 param2, ...) 
{ // return type can be void 
// do something here 


## See Also 


- [C tutorial](c tutorial.md 
- [C pitfalls](c pitfalls.md 

- [C pre ramming style](programming_style.md) 
- [IOCCC (reece md) 

- [D](d.md) 
- [Pascal](pascal.md) 

- [Fortran](fortran.md) 

- [LISP](lisp.md) 

- [FORTH](forth.md) 

- [memory management](memory management.md) in C 

# 
Code of conduct (COC), also_code.of coercion, is_a shitty invention of S3W] (siw, md) fascists that dictates how development of specific software should.be conducted, generally pushing toxic woke 
concepts such as forced inclusivity or use of politically correct languáge. COC is typically placed in the software repository as a (CODE OF CONDUCT file. In practicé COCs are used to kick 
people out of development because of their political opinions expressed anywhere, inside or outside the project, and to push political opinions through software projects. 


T. ERS] (Ir md must never include any COC**, with possible exceptions of anti-COC (such as NO COC) or parody style COCs, not because we dislike genuine inclusivity, but because we believe COCs 
are bullshit and mostly harmful as they support bullying, censorship and exclusion of people. 


Anyway it's best to avoid any kind of COC file in the repository, it just takes up space and doesn't serve anything. We may simply ignore this shitty, concept gorgtetely. You may arque why we 
don't ignore e.g. (copyright) (copyrs ht.md) in the same way and' just not use any Puigenses](icense.ndj? The Situation with copyright is different: 1t exists by default, without a license file 
the code is proprietary and our neighbors don't have the legal safety to execute basic freedoms, they may be bullied by the state -- for this we are forced to include a license file to get rid 
of copyright. With COC there simply isn't any such implicit issues to be solved (because COCs are simply inventing their own issues), so we just don't try to solve non-issues. 


-- coding.md -- 


Coding nowadays means low quality attempt at [programming](programming.md), usually practiced by [soydevs](soydev.md) and barely qualified coding monkeys. 


Traditionally it means encoding and decoding of information as in e.g. video coding -- this is the only non-gay meaning of the word 


T1100 collapse.md ---------- 
& Collapse 


Collapse of our civilization is a_concerning scenario in which basic.structures of society relatively rapidly fall apart and cause unusually large, possibly world-wide horrors such as chaos, 
[wars](war.md), famine and loss of advanced technology. It is something that will very likely happen very soon due to uncontrolled growth ahd societal decline by [capitalism](capitalism.md): we, 
the [LRS](lrs.md), are especially focusing on a very probable **techno ogical collapse** (caused by badly designed technology as well as its wrong application and extreme overuse causing 
dangerous [dependencies](dependency.md)) but of course clues point to collapse are coming from many directions (ecological, economical, political, natural disasters such as a coronal mass 
ejection ete.) Some have said that a society can deal with one crisis, but if multiple crises hit at once this hit may be fatal; however the dependence of current society on computer technology 
is so great that its collapse could be enough to deliver a fatal blow alone. Recently (around 2015) there has even appeared a specific term **collapsology** referring to the study of the 
potential collapse. 


166 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


There is a [reddit](reddit.md) community for discussing the collapse at https://reddit.net/r/collapse. [WikiWikiWeb](wikiwikiweb.md) has a related discussion under *ExtinctionOfHumanity*. 


Collapse of civilizations has been a repeated theme throughout [history] (history md), it_is nothing new or exceptional, see e.g. Maya empire collapse, Bronze age collapse, the fall of Rome etc. 
It usually comes when a civilization reaches high complexity and becomes "spoiled", morally corrupt and socially divided -- just what we are seeing today. 


In technological world a.lot of people are concerned with the collapse, notable the [coliqpse OS] (collapse ps-md) an operating system meant to run on.simple [hardware](hw,md) after the 
technological supply chain collapses and renders development of modern’ computers impossible. They believe the collapse will happen before 2030. The chip shortage, financial, Climatic and 
energetic crisis and beginning of war in Europe as of early 2020s are one of the first warnings showing how fragile the systems really is. 


Jed Kaczynski] (ted kaczynski md) (a famous primitivist, mathematician that, committed mass, murderer to warn about the decline.of society due to complex technology) has,seen the collapse as a 
ossible option. Internet bloggefs/vloggers Such as [Luke Smith](luke smith.md) and *no phone man* advocate (and practice) simple, independent off-grid Living, possibly to be prepared for such 
an event. Even [proprietary](proprietary.md) normies like [Jonathan Blow](jonathan blow.md) warn of a coming disaster (in his talk *Preventing the Collapse of Civilization*). [Vienut] (viznut md) 
is another programmer warning about the collapse. 


The details of the collapse cannot of course be predicted exactly -- it may come in a relatively quick, violent form (e.g..in case of a disaster causing a blackout) or, as a more agonizing slow 
death. CollapseOS site talks about two stages of the Slow collapse: the first one after the collapse of the supply chain. i.e. when the production of módern computérs halts, and the second 
(decades after) when the last modern computer stops working. It most likely won't happen overnight -- that's a very extreme case. A typical collapse may take decades during which all aspects of 
Society see a rapid decline. Of course, à collapse doesn't mean extinction of humans either, just deaths of many and great losses of what has been achieved culturally and technologically. 


{ I've read a book called *Blackout* by Marc Elsberg whose story revolves around a fictional large collapse of power supply in Europe. A book called *The World Without Us* explores what the 
world would look like if humans suddenly disappeared. ~drummyfish } 


## Late 2022 Report 


It.seems like the collapse may have already begun. After the worldwide {Covid] (covid.md) pandemic the Russia-Ukraine war has begun with talks of nuclear war already going on. A great economic 
crisis has begun, possibly as a result of the pandemic and the war, inftation is skyrocketing and breaking all records, especially gas and energy prices are growing to extremes and as a result 
basically prices of everything go up as well. Russia ísolated itself, new cold war has begun. Many big banks have gone bankrupt. War immigrants from Ukraine are flooding into Europe and European 
fascists/nationalists seem to be losing their patience about it. People in European first world countries are now àctually concerned about how not to freeze during the winter, this talk is all 
over TV and radio. The climate disaster has also started to show, e.g. in Czech Republic there was the greatest forest fire in its history as well an extremely hot summer, even tornados that 
destroyed some villages {tornados in this part of world are basically unheard of), winters_have almost no snow unlike some two decades ago. Everything is shitty: food costs more and is of much 
lower quality as basically everything else, newly bought technology cannot be expected to last longer than a few months. Society is spoiled to an unimaginable level, extreme hostility, | 
competition and aggressive commerce is everywhere, kids are addicted to cellphones and toxic social media, mental health of population rapidly deteriorates. Art such as movies and music is of 
extremely low quality, people hate every single new movie or video game that comes out. A neofascist party has won elections in Italy, in Czech Republic all socialist parties were eliminated 
from the parliament: only capitalists rule now -- all social securities are being cancelled, people are getting poorer and poorer and forced to work more and to much higher ages. Ads are 
everywhere and equate psychological torture. The situation now definitely seems extremely bad. 


## See Also 


- [capitalist singularity](capitalist singularity.md) 
I-II collision detection.md ---------- 
# Collision Detection 


Collision detection is an essential problem egy of simulating physics of mechanical bodies in [physics, engines (physics engine md) (but also elsewhere), it tries to detect whether (and.also 
how) geometric shapes overlap. Here we'll be talking about thé collision detection in physics engines, but the blem appears in other contexts too (e.g. [frustum culling | (frustum cul ting. md) 
in [computer graphics] (graphics.md) ) . Collision detection potentially leads to so called *collision resolution*, a different stage that tries to deal with the detected collision (separate the 
bodies, update their Gea a make them "bounce off"). Physics engines are mostly divided into 2D and 3D ones so we also normally either talk about 2D or 3D collision detection (3D being, of 
course, a bit more complex). 


There are two main types of collision detection: 


- enLdiscrete] (discrete md) Detecting collisions only at one point in time feach engine tick or "frame") -- this is easier but can result in detecting the collisions in wrong ways or missing 
them completely (imagine a fast flying object that in one moment is wholly in front of a wall and at the next instant wholly behind it). Nevertheless this is completely usable, one just has to 
be careful enough about the extreme cases. 

-,**[continuous {continuous md)": Detecting collisions consider ing the continuous motion of the bodies (still done at discrete ticks but considering the whole motion since the. last tick) -- 
this is more difficult to program and more Costly to compute, but also correctly detects collisions even in extreme cases. Sometimes engines perform discrete detection by default and use 
continuous detection in special cases (e.g. when speeds become very high or in other error-prone situations). Continuous detection can be imagined as a collision detection of a higher 
dimensional bodies where the added dimension is time -- e.g. detec ing collisions of 2D spheres becomes detecting collisions of "tubes" in 3D space. If you don't want to go all the way to 
implementing continuous collisions, you may consider an in-between solution by detecting collisions in smaller steps (which may also be done only sometimes, e.g. only for high speed bodies or 
only when an actual discrete collision is detected). 


Collision detection is non-trivial because we need to detect not only the presence of the collision but also its parameters which are typically the exact **point of collision, collision depth 
and collision normal] (normal md) ^ -- these are needed for subsequently resolving the collision (typically the bodies will be shifted àlong the normal by the collision depth to become separated 
and [impulses](impulse.md) will be applied at the collision point to update their velocities). We also need to detect **general cases**, i.e. collisions of whole volumes (imagine e.g. a tiny 
cuboid inside àn arbitrarily rotated bigger cone). This is very hard and/or expensive for some complex shapes such as general 3D triangle meshes (which is why we approximate them with simpler 
shapes). We also want the detection algorithm to be at least reasonably **fast** -- for this reason collision detection mostly happens in two phases: 


- **broad.phase**: Quickly estimates which bodies MAY collide, usually with [boundin volumes] (bpunding volume md) fsuch as spheres or [axis aligned bounding boxes] (aabb.md)) or, space indexing 
and algorithms such as *[Sweep and prune](sweep and prune.md)*. This phase quickly opts out of checking collision of objects that definitely CANNOT collide because’ they're é.g. too far away. 


**narrow phase**: Applying the precise, expensive collision detection on the potentially colliding pairs of bodies determined in the broad phase. This yields the real collisions. 


In many cases it is also important to correctly detect the **order of collisions** -- it may well happen a body collides not with one but with multiple bodies at the time of collision detection 
and thé computed behavior may vary widely depending on the order in which we consider them. Imagine at body *A* is colliding with body *B* and body *C* at the same time; in [real life] | 
real, Hife md) *A* may have first collided with *B* and be deflected so that it would have never hit *C*, or the other way around, or it might have collided with both. In continuous collision 
etection we know the order as we also have exact time coordinate of each collision (even though the detection itself is still computed at discrete time steps), i.e. we know which one happened 
first. SY discrete collisions we may use [heuristics](heuristic.md) such as the direction in which the bodies are moving, but this may fail in certain cases (consider e.g. collisions due to 
rotations). 


**On shapes**: gengral rule is that **mathematically simpler.shapes are better for collision.detection**, Spheres (or circles in 2D) are the best, they are stupidly, simple -- a collision of two 
spheres is simply decided by their [distance](distahce.md) (i.e. whether the distance of their center points is less that the sum of the radia of the Spheres), which also determines the 
collision depth, and the collision normal is always aligned with the vector pointing from one sphere center to the other. So **if you can, use spheres** -- it is even worth using multiple 
spheres to approximate more complex shapes if possible. [Capsules] (capsule: md) ("extruded spheres"), infinite planes, half-planes, infinite cylinders (distance from a line) and axis-aligned 
boxes are also pretty simple. Cylinders and cuboids with arbitrary rotation are bit harder. Triangle meshes (the shape most commonly used for real-time 3D models) are very difficult but may be 
[approximated] (approximation md e.g. by a [convex hull](convex hull.md) which is manageable (a convex hull is an intersection of a number of half-spaces) -- if we really want to precisely 
collide full 3D meshes, we may split each one into several convex hulls (but we need to write the non-trivial splitting algorithm of course). Also note that you need to write a detection 
algorithm for any possible pair of shape types you want to support, so for *N* supported shapes you'll need *N * (N + 1) / 2* detection algorithms. 


In theory we may in,some cases also think about using iterative/numerical methods to_find. collisions, 
Intersection until we're close enough. Another idea I had was to use [signed distance functions](sdf.md) 
(tinyphysicsengine.md). ~drummyfish } 


i,e. starting at some point between the bodies and somehow Stepping towards their . 
for representing static environments, I kind of implemented it in [tinyphysicsengine] 


TODO: some actual algorithms 
T collision.md ---------- 
# Collision 


Collision, sometimes also *conflict*, happens,when two or more things want to occupy the same spot. This situation usually needs to be addressed somehow; then we talk about **collision 
resolution**. In [programming](programming.md) there are different types of collisións, for example: 


- pias] (hash nd collision**: When two items produce the same hash, they will map to the same index in a [hash table](hash table.md). Typical solution is to have a [list](list.md) at each 
tablé indéx so that multiple items can fit there. 

- **collision of bodies in a [physics engine](physics_engine.md)**: See [collision detection](collision detection.md). These collision are resolved by separating the bodies and updating their 
velocities so that they "bounce off" as in [real life](irl.md). 

- **request collision**: General, situation in which multiple clients, request access, to something that, can be used only by one client at a time, e.g. a communication [bus](bus.md). Resolution is 
usually done by some kind of [arbiter](arbiter.md) who decides, by whatever algorithm, who to grant the access to. 

- **name collision**: When e.g. the same pedenti tier] (identifier smd) is used in two separate [libraries](library.md) that are included at the same time, the [compiler](compiler.md) doesn't know 
which one is intended. This iS addressed by [namespaces] (namespace.md). 

T1 combinatorics.md ---------- 

# Combinatorics 


Combinatorics is an area of fmath] (math. md) that's basically concerned with counting possibilities. As such it is very related to [probability theory] ( robability.md) (as probapility is 
typical ly defined in terms of ratios of poSsible outcomes). It explores things such' as [permutations](permutation.md) and [combinations] (combination. p! i.e. question such as how many ways are 
there to order *N* objects or how many ways are there to choose *k* objects from a set of *N* objects. 


The two basic quantities we define in combinatorics are **[permutations](permutation.md)** and **[combinations](combination.md)**. 


Permutation (in,a simple form) of a [set](set.md) of objects (lets say A, B and C) is one possible ordering of such set (i.e. ABC, ACB, BAC etc.). I.e. here by permutation of a number *n*, which 
we'll write as *P(n)*, we mean the number of posSible orderings of a Set of size *n*. So for example *P(1) - 1* because there is only one way to order a set containing one item. Similarly *P(3) 
= 6* because there are six ways to order a set of three objects (ABC, ACB, BAC, BCA, CAB, CBA). *P(n)* is computed very simply, it is [factorial](factorial.md) of *n*, i.e. *P(n) = n!*. 


Combination (without repetition) of a set of objects says in how many ways we can select given number of objects, from that set (eg. if.there are 4 shirts in a drawer and we want, to choose 2, . 
how many possibilities are theré?). I.e. given à set of certain size a combination tells ùs the number of póssible subsets of certain size. I.e. there are two parameters of a combination, one is 
the size of the set, *n*, and the other is the number of items (the size of the subset) we want to select from that set, *k*. This is written as *nCk*, *C(n,k)* or 
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A combination is computed as *c(n, ko. =n! / (k! * (n - k)!)*. E.g. having a drawer with 4 shirts (A, B, C and D) and wanting to select 2 gives us *C(4,2) = 4! / (21 * (4 - 2)!) = 6* 
possibilities (AB, AC, AD, BC, BD, CD). 


Furthermore we.can define combinations with repetitions in which.we allow ourselves, to select the same item from the set more than once (note that the selection order still doesn't matter). I.e. 
while combinations without repetition give us the number of possible subsets, a combinations WITH repetitions gives us the number of possible [multisubsets](multiset.md) of a given set. 
Combinations with repetition is computed as *Cr(n,k) = C(n + k - 1,k)*. Ea having a_drawer with 4 shirts and wanting to select 2 WITH the possibility to choose one shirt multiple times gives 
us *Cr(4,2) = C(5,2) = 5! / (2! * (5 - 2)!) = 10* possibilities (AA, AB, AC, AD, BB, BC, BD, CC, CD, DD). 


Furthermore if we take combinations and say that order matters, we get generalized permutations that also take two parameters, *n* and *k*, and there are two kinds: without and with repetitions. 
I.e. permutations without repetitions tell us in how many ways we can choose *k* items from *n* items when ORDER MATTERS, and is computed as *P(n,k) = n!/(n - DIM (e.g. *P(4,2) = 4!/(4 - 2)! = 
12*, AB, AC, AD, BA, BC, BD, CA, CB, CD, DA, DB, DC). Permutations with repetitions tell us the same thing but we are allowed to select the same thing multiple times, it is computed as *Pr(n,k) 
= n^k* (e.g. *P(4,2) = 4^2 = 16*, AA, AB, AC, AD, BA, BB, BC, BD, CA, CB, CC, CD, DA, DB, DC, DD). 


To sum up: 

quantity order matters?|repetition allowed? |formula 

permutation (simple) yes P(n)-n! 

permutation without rep.| yes no P nu) = n!/(n - k)! 
permutation with rep. yes yes Pr(n n^k 

combination without rep.| no no en k) =n! / (k! * (n - k)!) 
combination with rep. no yes Cr(n,k)  c(n* k - 41,k) 


Here is an example of applying all the measures to a three item set ABC (note that selecting nothing from a set counts as 1 possibility, NOT 0): 


quantity|possibilities (for set ABC) count 
P(3) ABC ACB BAC BCA CAB CBA 3! 6 
P(3,0) 31/(3-0)! -1 
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P(3,1 ABC 3!/(3 - 3 
P(3,2 AB AC BA BC CA CB 3!/(3 - 6 
P(3,3 ABC ACB BAC BCA CAB CBA 3!/(3 - 6 
Pr(3,0 3^0 = 1 

Pr(3,1 ABC 341 = 3 

Pr(3,2 AA AB AC BA BB BC CA CB CC 342 = 9 

Pr(3,3 AAA AAB AAC ABA ABB ABC ACA ACB ACC ... 3^3 = 27 

C(3,0 3!/(0! * (3 =1 
C(3,1 ABC 3!/(1! * (3 =3 
C(3,2 AB AC BC 3!/(2! * (3 =3 
C(3,3 ABC 3!/(3! * (3 =i 
Cr(3,0 c(3 + 0 - 

Cr(3,1 ABC c(3 +1 - 

Cr(3,2 AA AB AC BB BC CC c(3 + 2 - 

Cr(3,3 AAA AAB AAC ABB ABC ACC BBB BBC BCC CCC c(3 +3 - 


---------- comment.md ---------- 
# Comment 


Comment is part of computer code that doesn't affect how the code is interpreted by the computer and is intended to hold information for humans that read the code (even though comments can 
sometimes contain additional information for Computers such as metadata and autodocumentation information). There are comments in basically all [programming languages ] (prográmming. language .md), 
they usually start with ^//^, `#`, ~/** and similar symbols, sometimes parts of code that don't fit the language syntax are ignored and as such can be used for comments. 


Even though you should write nice, [self documenting](self documentation.md) code, **you should comment you source code** as well. General tips on commenting: 


- ALWAYS put a **global file comment** at the top of a file to make it [self-contained] (self contained md). It should include: 
- iepescription of what the file actually does.** This is extremely important for [readability](readapi ity.md), documentation and quick orientation. If a new programmer comes looking,for a 
specific part of the code, he may waste hours on searching the wrong files just because the idiotic author couldn't be bothered to include fucking three sentences at the start of the file. 
[Modern](modern.md) program just don't fucking do this anymore, this is just [shit](shit.md). 
E- [License] ( license md)/ [waiver (waiver.md), either full text or link. Even if your repo contains a global license (which it should), it's good for the file to carry the license because the 
file may just be copy pa$ted on its own into Some other project and then it will àppear as having no license. 
- **Name/nick of the author(s)" and roughly the date of creation (year is enough). This firstly helps legally assess [copyright](copyright.md) (who and for how long holds the copyright) and 
secondly helps others contact the author in case of encountering something weird in the code. 
- Comment specific blocks of code with **keywords** -- this will help searching the code with tools like [grape] (grep md) . E.g. in game's code add comment ^// player: shoot, fire’ to the part of 
code that handles player's shooting so that someone searching for any one of these two words will be directed here. 
- Functions (maybe with some exceptions like trivial one-liners) should come with a comment documenting: 
e rBehavior*s 95 rng function; what it does and also how it does that (Is the function slow? Is it safe? Does it perform checks of arguments? Does it have [side effects](side_effect.md)? How 
are errors handled? ...). 
- **Meaning of all arguments** and if needed their possible values. 
- **Return value meaning**. 


- You may decide to use comment format of some [autodog] (autodo¢ md) System such as goxygen (doxygen.md) -- it costs nothing and helps firstly unify the style of your comments and secondly, 
obviously, generate automatic documentation of your codé, as well aS possibly automatically process it in other ways. 
- TODO: moar 


T competition.md ---------- 
# Competition 


Competition is a situation of conflict in which several entities try to overpower or otherwise win over each other. It is the opposite of [collaboration](collaboration.md). Competition is 
conhected to pursuing [self interest](self interest.md). 


**Competition is the absolute root cause of all [evit (evil.md) in Society. Society must never be based on competition**. Unfortunately our society, has decided to do the exact oppos h 
E alism](capitalism.md), the glorification of compétition -- this will very likely lead to the [destructing of our society](collapSe.md), possibly even to the destruction of all 


1 
life.md). 


e wit 
life] 


Competition is to society what .a.drug is to an individual: competition makes a situation become better quickly and start achieying technological "progress" but for the price of, things going 
downwards from then on, Competition quickly degenerates and kills other values in society such as altruism and morality; society that decidés to make unnaturally fast "progress" and baše itself 
on competition is equivalent to someone deciding to take steroids to grow muscles quickly -- corporations that arise in techno Logically advanced society take over the world just like muscle 
cancer that grows from taking steroids. A little bit of competition can be helpful in small doses just as painkillers can on occasion etp lower suffering of an individual, but one has to be 
pxereme ly careful to not take too many of them... even smoking a joint from time to time can have a positive effect, however with [capitalism](capitalism.md) our society has become someone who 
has started to take heroin and only live for that drug alone, take as much of it as he can. Invention of bullshit jobs just to keep competition running, extreme growing hostility of people, 
[productivity cults](productivity cult.md), overworking, wage slavery, extreme waste that's destroying our environment, all of these are signs our society is dying from overdose, living from day 
to day, trying to get a few bucks for the next dose of its drug. 


Is all competition bad? Competition is not bad as a concept, it may for example be used in [genetic Progpamming](genetic programming md _to evolve good computer programs. People also have a NEED 
for at least a bit of competition as this need was necessary to survive in the past -- this need has to be satistied, so we Create àrtificial, mostly harmless competition e.g. with [games 
(game.md) and sports. This kind of competition is not so bad as long as we are aware of the dangers of overapplying it. What IS bad is making competition the basis of a society, in à [goo 
society | less_retarded_society md people must never compete for basic needs such as food, shelter or health care. Furthermore after sufficient technological progress, competition is no longer 
just a bad basis for society, it becomes a fatal one because society gains means for complete annihilation of all life such as nuclear weapons or factories poisoning our environment that in the 
eat of competition will sooner or later destroy the society. I.e. in a technologically advanced society it is necessary to give up competition so as to prevent own destruction. 


Why is competition so prevalent if it is so bad? Because it is natural and it has been with us since we as life arised. It is extremely hard to let go of such a þasic instinct but it has to be 
dohe not only because competition has become obsolete and is now only artificially sustaining suffering without bringing in any benefits (we, humans, have basically already won the evolution), 
but because, as has been said, sustaining competition is now fatal. 


How to achieve letting, go of competition in society? The only.way is a voluntary choice achieved through our intellect, i.e. through [education] (education.md), Competition. is.something we 
naturally want to do, but we can rationally decide not to do it once we see and understand it is bad -- such behavior is already occurring, for example if we know someone is infected with a 
sexually transmitting disease, we rationally overcome the strong natural instinct to have sex with him. 

T1 compsci.md ---------- 

# Computer Science 


theoretical areas that neighbor and overlap with [mathematics] (marh.m such as [formal nguages ormal_language.md), [cryptography](cryptography.md) and [machine learning] 

(machine learning.md), but also more practicala plied and_"softer" disciplines such as [software engineerin software_engineering.md), [pro ramming] (programming .md) [hardware] (hardware.md), 
computer networks or even [user inter Gee (ud. md) design. This science deals with such things as [algorithms](al orithn-mdj; [data structures](data_structure.md), [artificial intelligence] 
(ai.md) and [information](information.md) theory. The field has become quite popular and rapidly growing after the coming of the 21st century computer/[Internet](internet.md) revolution and it 
has also become quite spoiled and abused by its sudden lucrativity. 


Computer science, abbreviated as "compsci", is (surprise-surprise),a Ajeisnen (sctence qu] pguagerd format Vantage mi]; [67y The term is pretty wide, a lot of it.covers very formal and 
al 
r 


## Overview 
Notable fields of computer science include: 


- [artificial intelligence] (ai.md 
- [computer raphics]¢gra ics .md 
- [databases (database md) 7 

- [hardware](hardware.md) design 

- [networking](network.md) 

- security] (security md) and [cryptography] (cryptography.md) 

- [software engineering] (software) engineering may 

- theoretical computer science 

- [user interface](ui.md) 

- Smaller field or subfields such as [operating systems](os.md), [compiler](compiler.md) design, formal verification, speech recognition etc. 


Computer science also figures in interdisciplinary endeavors such as [bioinformatics](bioinformatics.md) and [robotics](robotics.md). 


In the industry there have arisen fields of fart] (art.md) and study that probably shouldn't be included in computer science itself, but are very close to it. These may include e.g. [web design] 
(webdesign.md) (well, let's include it for the sake of completeness), [game](game.md) design, [system administration](sysadmin.md) etc. 

T computer.md ---------- 

# Computer 


The word. *computer* can be defined in many ways and can.also take many.different meanings; a somewhat common definition may be this: computer is a machine that automatically performs 
mathematical computations. We can also see it as a machine for processing [information] {thrormation. mdf or, very generally, as any tool that helps computation, in which case one's fingers or 
even a [mathematical](math.md) formula itself can be considered a computer. Here we are of course mostly concerned with electronic [digital](digital.md) computers. 


We can divide computers based on many attributes, e.g.: 


by continuous or discrete **representation of data**: [digital] (da ital.md) vs [analog (analog md) 
by **[hardware](hw.md) technology**: [electronic](electronics.md) T" lightniny in sand"), [mechanical](mechanical.md), [quantum](quantum.md), biological etc. 
**purpose**: special purpose vs general purpose, [personal](pc.md), [server](server.md [embedded] (embedded.md), [supercomputers](supercomputer.md), gaming computer etc. 
by **[programmabi ity (programming md)'?: non-programmable partially or fully programmable 3 4 $ 
by the theoretical **[model of computation] (model_of_computa ion.md)** it is based on: [Turing machine) (turing machine mdo, [lambda calculus (lambda_caleulus md) etc. 
- by. **computational power**: how difficult problems the computer is able to solve, i.e. where in the [Chomsky hierarchy](chomsky_hierarchy.md) it stands (typically we want [Turing complete] 
(turing_completeness.md) computers) 
- by **other criteria**: price, reliability, durability etc. 


j 
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Computers are theoretically studied by [computer science](compsci.md). The kind of computer we normally talk about consists of two main parts: 


- **[hardware](hw.md)**: physical parts 
**[software](sw.md)**: [programs (program.md) executed by the hardware, made by [programmers](programmer.md) 


**The power of computers is limited**, forap Turing](turing.md) mathematically proved that there exist problems that can never be completet Solved by any [algorithm](algorithm md), i.e. there 
are prob Lems a computer (including our [brain](brain.md)) will never be able to solve (even if solution existo): This is related to the fact that the power of mathematics itself iS limited in a 
similar way {see [Godel's theorems] (incompleteness. theorems md). Turing also invented the theoretical model of a computer called the [Turing machine](turing_machine.md). Besides the mentioned 
Hate pei many solvable problems may take too long to compute, at least with computers we currently know (see [computational complexity] (computational_complexity.md) and [P vs NP] 
p_vs_np.md)). 


## Typical Computer 


Computers we normally, talk_about in gaily conversati 
possibly also [cell phones](phone.md), [tablets](ta 


Such_a computer consists of some, kind of [case](case.md) (chassis 
are for example a [keyboard] (keyboard. md) and [mouse](mouse.md) ( 


internal [hardware] (hardware md) plus peri heral devices | (pe 
f.md) (ou ard 
computer normally include: 


), in I r t serve for làngut and, outpi 
input devices), a [monitor](monitof.md tput device) or [harddi: n 


Liga"? -- these 
put/output řħals of the 


ut 
evice). The interna 


- ni]motherbeard](motherbeard:md)* The main electronic circuit of the computer into which other components are piu ged and which creates the network and interfaces that interconnect them (a 
chipset](chipset.md)). It contains slots for expansion cards as well as connectors for external devices HE fy el (usb). In a small memory on the board there is the most basic software 
{Ufirmaware( irmware.md)), such as [BIOS](bios.md), to e.g. enable installation of other software. The board also carries the [lock] (clock md). generator for synchronization of all hardware, 
eat sensors etc. 

( «dj X] (epu md)** (central processing unit): Core of the computer, the chip plugged into motherboard that performs general calculations and which runs [programs](program.md), i.e. [software] 
sw.md). 

- **[RAM](ram.md)/working,memory**: Lower capacity volatile (temporary, erased when powered off) working memory of the computer, plugged into motherboard. It is used as a "pen and paper" by the 
CPU when’ performing calcülation$. 

- **[disk](disk.md)**: [Non-volatile](volatile.md) (persisting when powered off) large capacity memory for storing [files](file.md) and other [data](data.md), connected to the motherboard via 
some kind of [bus](bus.md). Different types of disks exist, most commonly [hard diskS](hdd.md) and [SSDs](ssd.md). 

- aphibaneton, cards ([GPU](gpu.md), sound card, network card, ...)**: Additional hardware cards plugged into motherboard for either enabling or accelerating specific functionality (e.g. GPU for 
graphics etc.). 

- **[PSU](psu.md)** {power supply unit): Converts the input electrical power from the plug to the electrical power needed by the computer. 

- other things Lake ans for [cooling](cooling.md), batteries in laptops etc. 

Il comun.md ---------- 
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Comun is a, [LRS](lrs.md) [Rrogrammipg language programming. language md) made b [drummy fish] (drummy?ish md) based on his ideals of_ [good technology] (Irs .md) « It is still work in progress, 
currently there is a [ste ess (suek ess.id)~[C](c.md) implementation and a number of supplemental material (specification, tutorial, ...); the project repository is currently at 
https://codeberg.org/drummyfish/comun. The goal now is to make a [self hosted](self_hosting.md) implementation, i.e. write comun in comun. 


The language is [minimalist](minimalism.md), [imperative](imperative.md), [stack](stack.md)-based and [low level](low_level.md), similar e.g. to [FORTH](forth.md). 


TODO: more, code examples, ... 
T1 copyleft.md ---------- 
& Copyleft 


Copyleft (also share-alike) is a concept of sharing something on the condition that others will share it under the same terms; this is practically always used by a subset_of pires (as in . 
freedom) sor ware] (irge 50 tware.md) and culture] (free culture md) to legally ensure this software/art and its modifications will always remain fre his kind’ of [hacks](hack.md) [copyright] 
(copyright.md) to de-facto remove copyright by its own power. 

Copyleft has been by its, mechanisms likened. to a virus because once it is applied to certain software, it, "infects" it and will.force its conditions on any descendants of that software, i.e. it 
wi spread itself Yin this case the word virus does not bear a negative connotation, at least to some, they see it as a good virus). 


For free/open-source software the alternative to copyleft is so called **permissive** licensing which (same as with copyleft) grants all the necessary freedom rights, but does NOT require 
modified versions to grant these rights as well. This allows free software being forked and developed into [proprietary](proprietary.md) software and is what copy Left proponents criticize. 


ru the Loss (Tosama) world there is a huge battle between the copyleft camp and permissive camp ([LRS](lrs.md) advocates permissive licenses with a preference for 100% [public domain] 
public domain.md)). 


44 Issues With Copyleft 
In the great debate of copyleft vs permissive free licenses we, as technological anarchists, stand on the permissive side. Here are some reasons for why we reject copyleft: 


- By adopting copy left one is **embracing and supporting the copyright laws and perpetuating the (capitalist ] (capitalism. md) ways** ("marrying the lawyers") because_copyleft relies on and uses 
copyright laws. Copyleft chooses to play along with the capitalist bullshit [intellectual property](intellectual_property.md) game and threaténs to use force and bullying in order to enforce 
*correct* usage of information. 

- In a way it is a [B'ggt] (bloat md So GOBYISTt introduces **legal complexity**, ,Firiction]( friction md) and takes programmers' [head space] (head. space md), especially when copyleft is probably 
mostly ineffective as **de ecting its violation and actual legal enforcement is difficult, expensive and without a guaranteed positive outcome** ([FSF](fsf.md) encourages programmers to hand 
over their copyright to them so they can defend their programs which just confirms existence and relevance of this issue). Sure, corporations can probably "abuse" permissive Qnon-copytert) 
software easier, but we argue that this is a problem whose roots lie in the broken basic principles of our society ([capitalism](capitalism.md)) and so the issue should be addressed 

our socioeconomic system rather than by bullshit legal techniques that just imperfectly and many times completely ineffectively try to cure the symptoms. 

-.**The scope.of copyleft is nighty debatable** (which is why we have different kind of copyleft such as.*strong*, *weak*, *network* etc.). I,e. it can't be objectively said what exactly should 
classify as violation of copyleft AND increasing copyleft scope leads to copylefted software being practically ünüsable. You may say "so what", but in law clarity is extremely important, it may 
also discourage people because they don't really know what they sign up for, commercial use may also be discouraged by this for the same reason which may have a Similar effect to a non-free 
license that downright disallows commercial use. Consider this **example**: [Linux](linux.md) is copylefted which means we can't create a proprietary version of Linux, nevertheless we can create 
a proprietary operating system of which Linux is part (e.g. [Anar aid htandroi .md) in which its proprietary app store makes it de-facto owned by [Google] (google.md) ) and so Linux is effectively 
used as a part of proprietary software -- the copylert is bypassed. One might try to increase the copyleft scope here by saying *"everything Linux ever touches has to be free software"* which 
would however render Linux unusable on practically any computer as most computers contain at least some small proprietary software and hardware. The restriction would be too great. 

- In practice **copyleft licenses have to be complex and uus because they have to strictly describe the copyleft scope and include lots of legal [boilerplate] (boilerplate md) in order to 
make_ them welt defendable in court (copyleft is really about preparing for a legal war) -- and as we know, gomp exity comes with bugs, vulnerabilities, it makes it incomprehensible to common 
people and imposes many additional burdens. Indeed, we see this in practice: the only practically used copyleft licenses are the various versions of GPL of which all are ugly and have 
istorically shown many faults (which is again evident from e.g. looking at GPL vi vs v2 vs v3). This introduces great license compatibility issues, headaches for programmers who should rather 
be spending time programming and other similar bullshit. Permissive licenses on the other hand are simple, clear and well understandable, they aren't as much preparing for a court battle as 
trying to give other hackers a peace of mind and make them free of legal worries. 

- **Copyleft prevents not only inclusion in proprietary software but also in permissive FREE software,** I.e. as a consequence of denying code to corporations collateral damage is done by also 
denying code to ethical free Software that wishes to be distributed without copyleft conditions. Similarly to how proprietary software forces free software programmers to reinvent wheels by 
rewriting software as free, copyleft forces permissive free software programmers to reinvent wheels and rewrite copylefted code as permissive. 


y improving 
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# Copyright 


Copyright (better called *copyrestriction* or *copywrong*) is,one of many types of so called "[intellectual property] intellectual_property.md)" (IP) PESE concept that allows. "ownership", 
i.e. réstriction, [censorshi Y(eensorship.md) and artificial [monopo Ly] (monopoly md) on certain kinds of nformation](information.md), for example prohibition of s aring or viewing useful 
information](information.md) or improving lart lart amd works. Copyright specifically allows the copyright holder (not necessarily the author) a monopoly (practically absolute power) over [art] 
art.md) creations such as images, Songs or texts, which also include source code of computer [pro rams](program.md). Copyright is a [capita list](capi alism.md) mechanism for creating 
artificial scarcity) (artificial -scarcity md), enabling censorship and elimination of the [public domain (pul lic_domain.md) (a pool of freely shared works that anyone can use and benefit from). 
Copyright is not to be confused with [trademarks](trademark.md) [patents] (patent nd) and other kinds of "intellectual property", which are similarly [harmful](harmful.md) but legally different. 
Copyright is symbolized by C in a circle or in brackets: (C), which is often accompanies by the phrase "all rights reserved". 


When someone creates something that can even remotely be considered artistic expression (even such things as e.g. a mere collection of already existing things), he automatically gains copyright 
on it, without having to register it, pay any tax, announce it or let it be known anywhere in any way. He then practically has a full control over the work ànd can successfully sue anyone who 
basically just touches the work in any way (even unknowingly and unintentionally). Therefore **any work (such as computer code) without a [free](free software.md) license attached is implicitly 
fully "owned" by its creator** (so called "all rights reserved") and can't be used by anyone without permission. It is said that copyright can't apply to ideas (ideas are covered by [patents] 
(patent.md)), only to expressions of ideas, however that's [bullshit](bs.md), the line isn't clear and is arbitrarily drawn by judges; for example regarding stories in books it's been 
established that the story itself can be copyrighted, not just its expression (e.g. you can't rewrite the [Harry Potter](harry potter.md) story in different words and start selling it). 


As if Sopyright wasn't bad enough of a [cancer](cancer.md), **there usually exist extra gppressive copyright-like restrictions called related rights or neighboring rights such as "[moral 
rights](morat_rights.md)", "[personal rignts]t érsonal rights.md)" etc.** Such "rights" differ a lot by cóuntry and can be used to restrict and Censor even copyright-free works. This is a stuff 
that makes you nant to commit [suicide](suicide.md). Waivers such as [CC0](ccO.md) try to waive copyright as well as neighboring rights (to what extent neighboring rights can be waived is 
ebatable though). 


The current extreme form of copyright (as well as other types of IP such as software patents) has.been highly criticized by many people, even those whom it's supposed to "protect" (small game 
creators, musicians etc.). Strohg Copyright laws basically benefit mainly [corporations (corporation.md) and "trolls" on the detriment of everyone else. It smothers creativity and efficiency by 


prohibiting people to reuse, remix and improve already existing works -- somet ing that's crucial for art, science, education and generally just making any kind of progress. Most people are 
probably for *some* form of copyright but still oppose the current extreme form which is pretty crazy: **copyright applies to everything without any registration or notice and last usually 70 
years (!!!) AFTER the author has died (!!!)** and is already rotting in the ground. This is 100 years in some countries. In some countries it is not even possible to waive copyright to own 


Creations -- just think about what kind of twisted society we are living in when it PROHIBITS people from making a selfless donation of their own creations to others. Some people, including [us] 
(trs m are against the very idea of copyright (those may either use waivers such as [CCO](ccO.md) or [unlicense](unlicense.md) or protest by not using any licenses and simply ignoring 
copyright which however will actually discourage other people from reusing their works). Though copyright was originally intended to ensure artists can make living with their works, it has now 
become the tool of states and corporations for universal censorship, control, bullying, surveillance, creating scarcity and [bullshit jobs](bullshit_job.md); states can use copyright to for 
example take down old politically inconvenient books shared on the Internet even if such takedowns do absolute not serve protection of anyone's living but purely political interests. 


Prominent critics of gopyri ht include [Lawrence Eessig](lessig md) (who established [free culture](free culture.md) and poreative Commons](creative_commons.md) as a response), [Nina Paley 
(nina_paley.md) and [Richa Stallman](rms.md). There aré many movements and groups opposing copyright or its current form, most notably e.g. the [free culture](free_culture.md) movement, [free 
software](free_software.md) movement, [Creative Commons](creative_commons.md) etc. 


The book *Free Culture* by Lessig.talks, besides others, about how copyright has started and how it's been shaped by Corporations to becoming their tool for monopolizing art, The concept of 
copyright has appeared after the invention of [printing press | (printing press md). The so called *Statute of Anne* of 1710 allowed the authors of books to control their copying for **14 years** 
and only after PRE rede ara The term could be prolonged anothert 14 years if the author survived. The laws started to get more and more strict as control of information became more 
valued and eventually the term grew to **life of author plus 70 years**, without any need for registration or deposit of the copy of the work. Furthermore with new technologies, the scope of 
copyright has also extended: if copyright originally only limited *copying* of books, in the Internet age it started to cover basically any use, as any manipulation of [digital](digital.md) data 
in the computer age requires making local copies. Additionally the copyright laws were passing despite being unconstitutional as the US constitution says that copyright term has to be finite -- 
the corporations have found a way around this and simply regularly increased the copyright S term, trying to make it [de-facto] (de_facto md) [infinite] (infinity md) {fechnicalty not infinite but 
ever increasing) Their reason, of course, was to firstly forever keep ownership of their own art but also, maybe more importantly, to **kill the [public domain](püblic domain.md)**, i.e. 
prevent old works from entering the public domain where they would become a completely free, unrestricted work for all people, competing with their [proprietary proprietary.md) art (who would 
pay for movies if there were thousands of movies available for free?). Nowadays, with coprperations such as [YouTube] (youtube .md) and [Facebook](facebook.md) de-facto controlling most of 
infromation sharing among common people, the situation worsens further: they can simply make their own laws that don't need to be passed. by the government but simply implemented on the platform 
they control. This way they are already kitting $40 the right to [fair usel (Fair use d) they can simply remove any content on the basis of "copyright violation", even if such content would 
normat Ly NOT violate Copyright because it would fall under fair use. This would normally have to be decided by court, but a corporation here itself takes the role of the court. So in terms of 
copyright, corporations have now a greater say than governments, and of course they'll use this power against the people (e.g. to implement censorship and surveillance). 


Copyright rules differ greatly by country, most notably the US measures copyright length from the publication of the work rather than from when the author died. It is possible for a work to be 
copyrighted in one country and not copyrighted in another. It is sometimes also very difficult to say whether a work is copyrighted because the rules have been greatly changing (e.g. a notice 
used to be required for some time), sometimes even retroactively copyrighting public domain works, and there also exists no official database of copyrighted works (you can't safely look up 
whether your creation is too similar to someone else's). All in all, copyright is a huge mess, which is why we choose [free licenses](free software.md) and even [public domain](public_domain.md) 
waivers. 


copyleft] (copyleft.md) (also share-alike) is a concept, standing against copyright, a kind of anti-copyright, invented by [Richard Stallman] (rms mq) in, the context of [free software] 

freé software.md). It's a license that grants people the rights tö the author's work on the condition that they share its further modification undér the same terms, which basically [hacks] 
hacking.md) copyright to effectively spread free works like a "virus". 

Copyright does **not** (or at least should not apply to facts (including mathematical formulas even though the formulation of them may be copyrighted), i 
[patents](patent.md)) and single words or short phraSes (these may howevér still be [trademarke l trademark.md)) and similarly trivial works. AS such copyright can't e applied to game 
mechanics of a computer [game](game.md) (it's an idea). It is also basically proven that copyright doesn't cover [computer languages](programming language .m ) (Oracle vs Googie). Also even 
though many try to claim so, copyright does NOT arise for the effort needed to create the work -- so called "sweat of the brow" -- some say that when it took a great effort to create something 
the author should get a copyrig t on it, however this is NOT and must NOT be the case (otherwise it would be possible to copyright mere ideas, simple mathematical formulas, rules of games etc.). 
Depending on time and location there also exist various peculiar exceptions such as the freedom of panorama: for photographs or uncopyrightable utilitarian design E no one can own the shape 
of a generic car). But it's never good to rely on these peculiarities as they are specific to time/location, they are often highly subjective, fuzzy and debatable and may even be retroactively 
changed by law. This constitutes a huge legal [bloat](bloat.md) and many time legal unsafety. Do not stay in the gray area, try to stay safely far away from the fuzzy copyright line. 


ideas (though these may.be covered by 
+g. 


A work which is not covered by copyright (and any other IP) -- which is nowadays pretty rare due to the extent and duration of copyright -- is in the **[public domain](public domain.md)**. 


[Free software] (free_software.md) (and free art.etc.) is **not** automatically public domain, it is most ly still copyrighted, i.e. "owned" by someone, but the owner has given some key rights .to 
veryone with free software license and by doing sO minimized or even eliminated the negative effects of full copyright. The owner may still keep the rights e.g. to being properly Credited in 
all copies of the software, which he may enforce in court. Similarly software that is in public domain is **not** automatically free software -- this holds only if source code for this software 


is available (so that the rights to studying and modifying can be executed). 
## See Also 


free culture](free culture.md) 
copyleft](copyleft.md 

fair usej(fair use.md 

creative commons](cc.md) 

license](license.md) 

patent] patent-md) 

trademark](trademark.md) 

public domain](pd.md) 

intellectual property](intellectual property.md) 
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# Corporation 


Corporation is basically a huge company that doesn't have a single owner but is rather managed by many shareholders. Corporations are one of the most powerful, dangerous and unethical entities 
that ever came into existence -- their power is growing, sometimes even beyond the power of states and their sole goal is to make as much profit as possible without any sense of morality. 
Existence of corporations is enabled by [capitalism](capitalism.md). 


The most basic.fact to know about corporations is that, **1009 6 of everything a corporation ever does.is done 100% solely for maximizing its own benefit for any cost, with no other reason, with O 
morality and without any consideration of consequences**. If a corporation could make 1 cent by raping 1000000000 children and get away with it, it would do it immediately without any hesitation 
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apd any regret. This is very important to keep in mind. Now try to not get depressed at realization that corporations are those to whom we gave power and who are in almost absolute control of 
e world. 


**Corporation is not a human, it has no emotion and absolutely © sense of morality.** The most basic error committed by retards is to.reply to this argument with "but corporations are run by. 
humans". This is an extremely dangerous argument because somehow 99.999999999999999999% people believe this could be true and accept it as a comforting argument so that they can continue thêir 
daily lives and do absolutely nothing about the disastrous state of society. The argument is of course completely false for a number of reasons: firstly corporations exclusively hire psychopaths 
for manager roles -- any corporation that doesn't do this will be eliminated by -natur alse lection of the market environment because it will be weaker in a [fight](fight_culture.md) against other 
corporations, and its place will be taken by the next aspiring corporation waiting in line. Secondly corporations are highly sophisticated machines that have strong mechanisms preventing any 
ethical behavior -- for example division of labor in the "[just doing my job](just doing my job.md)"/"[everyone does it Tévéryohe does it.md]" style allows for many people collaborating on 
something extremely harmful and unethical without any single one feeling responsibility for the whole, or sometimes without people even knowing what they are really collaborating on. This is 
taken to perfection by corporations not even having a single responsible owner -- there is a group of shareholders, none of whom has a sole responsibility, and there is the CEO who is just a 
tool and puppet with tied hands who is just supposed to implement the collective bidding of shareholders. Of course, most just don't care, and most don't even have a choice. Similar principles 
allowed for example the [no tocaust] (holocaust. md) to happen. Anyone who has ever worked anywhere knows that managers always pressure workers just to make money, not to behave more ethically -- 
of course, such a manager would be fired on spot -- and indeed, workers that_try to behave ethically are replaced by those who make more money. just as companies that try to behave ethically in 
the market are replace: by those that rather make money, i.e. corporations. This is nothing surprising, the definition of [capitalism] (capita ism.md) implies existence of a system with Darwinian 
evolution that selects entities that are best at making money for any cost, and that is exactly what we are getting. To expect any other outcome in Capitalism would be just trying to deny 
mathematics itself. 


A corporation is, made to exploit people just as a gu is made to kill people. When a corporation commits a crime, it is.not punished like a human.would be, the corporation is left to exist and 

continue doing what it has been doing --' a supposed "punishment" for a corporation that has been caught red handed committing a crime is usually just replacing whoever is ruled to be 

for qxample the CEO, which is of course ridiculous, the guy is just replaced with someone else who will do exactly the same. This is like trying to fix the lethal nature of a 
wi 


e blame on a screw in the weapon, then replacing e screw h another one and expecting the weapon to no longer serve killing people. 


"responsible", 
weapon by putting all t 


There is probably nothing we can do to stop corporations from taking over the world and eventually eliminating humans, we have probably passed the **[capitalist singularity] 
(capitalist singülarity.md)**. 

T c pitfalls.md ---------- 

# C Pitfalls 


[Etc md) is a, powerful language that offers almost absolute control and maximum performance which necessarily comes with responsibility and danger of shooting oneself in the foot. Without 
nówledgé of the pitfalls yóu may well find yourself fallen into one of them. 


Unless specified otherwise, this article supposes the C99 standard of the C language. 


**Generally**: be.sure to check your programs with tools such as [valgrind](valgrind.md), [splint](splint.md) or [cppcheck](cppcheck.md), and turn on compiler auto checks (^-Wall', ~-Wextra’, `- 
pedantic’, ), it's quick, simple and reveals many bugs! 


## Undefined/Unspecified Behavior 


Undefined | (completely un redictable), unspecified (safe but potentially differing) and.implementation-defined (consistent within implementation but potentially differing between them) behavior 
poses a kind of unpredictability and sometimes non-intuitive, tricky behavior of Certain operations that may differ between compilers, platforms or runs because they arë not exactly described by 
the language specification; this is mostly done on purpose so as to allow some implementation freedom which allows implementing the language in a way that is most efficient on_ given platform. 
One has to be very careful about not letting such behavior break the program on platforms different from the one the program is developed on. Note that tools such as [eppcheck ] (cppcheck md) can 
help find undefined behavior in code. Description of some such behavior follows. 


^sizeof(Char)' is always 1). Int (and unsigned int) type width should reflect the architecture's native integer typ so nowadays it's mostly 32 or 64 bits. deal with these differences wé can 


**Data type sizes always if int and char may not be the same on each platform**. Even though we almost take it for granted that char,is 8 bits wide, in theory it can be, different feven though 
o 
use the standard library `limits.hò and 'stdint.h'^ headers. : 


**No specific [endianness](endian.md) or even encoding of numbers is specified**. Nowadays little endian and [two's complement](twos complement.md) is what you'll encounter on most platforms, 
but e.g. [PowerPC](ppc.md) uses big éndian ordering. 


**Order of, evaluation of operands and function arguments is not specified**. I.e. in an expression or function call it is not defined which operands or arguments will be evaluated first, the 
order may be completely random and the order may differ even when evaluating the same expression at another time. This is demonstrated by the following code: 
#include <stdio.h> 
int x = 0; 
int a(void) 
{ 
x ctm; 
return x; 
int main(void) 


printf("%d %d\n",x,a()); // may print 0 10r 1 1 
return 0; 


**Overflow behavior of signed type operations is not specified,** Sometimes we suppose that eg: addition of two signed integers that are past the data types limit will produce two's complement 
overflow (wrap around), but in Tact this operation's behavior is undefined, C99 doesn't say what representation should be uséd for numbers. For [portability](portability.md), predictability and 
preventing bugs **it is safer to use unsigned types** (but safety may come at the cost of performance, i.e. you prevent compiler from performing some optimizations based on undefined behavior). 


**Bit shifts by type width or more are undefined.** Also bit shifts by negative values are undefined. So e.g. `x >> 8° is undefined if width of the data type of ^x^ is 8 bits or fewer. 
**Char data type signedness is not defined**. The signedness can be explicitly "forced" by specifying 'signed char~ or “unsigned char’. 


**[Floating poin Af Log md) results are not precisely specified**, no representation (such aş IEEE 754) is specified and there may appear small differences in float operations under different 
machines or e.g. Compiler optimization settings -- this may lead to [nondeterminism](déterminism.md). 


## Memory Unsafety 


Besides being extra careful,about, writing memory safe code, one needs to also know that **some functions of the standard library are memory unsafe**. This is re arcing mainly string functions 
such as 'strCpy or ‘strlen’ which do not check the string boundaries (i.e. they rely on not being passed a string that's not zero terminated and so can potentially touch memory anywhere 
beyond); safer alternatives are available, they have an ^n' added in the name (‘strncpy’, “strnlen’, ...) and allow specifying a length limit. 


## Different Behavior Between C And C++ (And Different C Standards) 


C is **not** a subset of C++, i.e. not every C program is a C++ program (for simple example imagine a C program in which we use the word “class as an identifier: it is a valid C program but not 
a C++ program). Furthermore a C prò ram that is at the same time also a C++ program ma ehave differently when compiled as C vs C++, i.e. there may be a [semantic](semantics.md) difference. Of 
course, all of this may also apply between different standards of C, not just between and C++. 


For portability sake it is good to try to write C code that will also compile as C++ (and behave the same). For this we should know some basic differences in behavior between C and C++. 


One difference lies for example in [pointers](pointer.md) to string literals. While in C it is possible to have non-const pointers such as 
char *s - "abc"; 

C++ requires any such pointer to be ‘const’, i.e.: 

const char *s - "abc"; 


TODO: more examples 
## Compiler Optimizations 


C compilers perform automatic optimizations and other transformations of the code, gspecially when you tell it to optimize aggressively (98) which is a standard practice to make programs run 
faster. However this makes comps ters perform a lot of {magic} (magic.md) and may lead to unexpected and unintuitive undesired behavior Such as bugs or even the "unoptimization of code". { I've 
seen a code I've written have bigger size when I set the "-Os flag (optimize for smaller size). ~drummyfish } 


Aggressive optimization may firstly lead to tiny bugs in your code manifesting in,very weird ways, it may happen that a line.of code somewhere which, may somehow trigger some tricky [undefined 

béhavior ](undefined_behavior.md) may cause your program to crash in some completely different place. Compilers exploit undefined behavior to make all kinds of big brain reasoning and when they 
see code that MAY lead to undefined behavior a lot of chain reasoning may lead to very weird compiled results. Remember that undefined behavior, such as overflow when adding signed integers, 
doesn't mean the result is undefined, it means that ANYTHING CAN HAPPEN, the program may just start printing nonsensical stuff on its own or your computer may explode. So it may happen that the 
line with undefined behavior will behave as you expect but somewhere later on the program will just shit itself. For these reasons if you encounter a very weird bug, try to disable optimizations 
and see if it goes away -- if it does, you may be dealing with this kind of stuff. Also check your program with tools like [cppcheck](cppcheck.md). 


Automatic optimizations may also be dangerous when writing jmuleithreaded (multithreading.md) or, very. low. level code (e.g. a driver) in which the compiler may have wrong assumptions about the 
code such as that nothing outside your program can change your program's memory. Consider e.g. the following code: 


while (x 
..puts("X is set!"); 


Normally the compiler could optimize this to: 


if (x 
while (1) . 
puts("X is set!"); 


As in.typical code this works the same and is faster. However if the variable *x* is part of shared memory and, can be changed by an,outside process during the execution of the loop, this 
optimization can no longer be done as it results in different behavior. This can be prevented with the ‘volatile’ keyword which tells the compiler to not perform such optimizations. 


Of course this applies to other languages as well, but C is especially known for having a lot of undefined behavior, so be careful. 
## Other 


Watch out for **operator precedence**! Bracket expressions if unsure, or just to increase readability for others. 


Also watch out for this one: `!=`> is not “=!°_:) I.e. "if (x !- 4)' and “if (x =! 4l. are two different things, the first means *not equal* and is usually what you want, the latter is two 
operations, `= d the tricky thing is it also compiles and may work as expected in some cases but fail in others, leading to a very nasty bug. 
# c 
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C++ is.an object obsessed] (gop.md) Adekel (jokes md); Langua e based. on [C] (cmd) to. which it adds only [capitalist](capitalist software.md) features and bloat](bloat,md), most notably [qbject 
obsession](oop.md). Most good programmers’ Such as [Richard Stallman](rmS.md) and [Linus Torvalds](linüs torvalds.m agree that C++ is hilariously messy and also tragic in that it actua ni 
succeeded to become mainstream. The language creator [Bjarne Stroustrup] (stroustrup.md) himself infamously admitted the language suck but laughs at its critics because it became successfu 
anyway -- indeed, in a retarded society only [shit](shit.md) can succeed. As someone once said, "C++ is not an increment, it is excrement". 
Faccio cracker.md ---------- 

racker 


Crackers are either "bad [hackers] (hacking.md)” that, break into computer 
sharing [infomration](information.md); for example they help remove [DRM] 


systems or the goo eople who with the power o ackin acking.m remove artificia arriers to obtaining an 
i h d l h ith th f [hacki g hacki d ificial b i btaini $e d 
more admirable. 


rm.md) from [games](game.md) or leak data from Secret abases. This is normally illegal which makes the effort even 
Cracker is also food. 

Cracker is also the equivalent of [nigger-word](nigger.md) for the white people. 

---------- Cracking.md ---------- 

# Cracking 

See [cracker](cracker.md). 

T1 creative commons.md ---------- 

# Creative Commons 

TODO 

## Licenses 


Creative_commons [licenses] ( License. md) /waivers form.a **[spectrum](spectrum.md)** spanning from complete freedom (CCO [public domain] (public domain,md), no conditions on use) to complete 
[fascism](fascism.md) (prohibiting basically everything except for non-commercial sharing). This means that **NOT all Creative Commons licenses are [freé'cultural](free culturé.md) licenses** -- 
this is acknowledged by Creative Commons and part of the design. Keep in mind that as a good human you mustn't ever use licenses with [NC](nc.md) (non-commercial use only) or [ND](nd.md) (no 
derivatives allowed) clauses, these make your work non-free and therefore unusable. 


Here is a comparison of the Creative Commons licenses/waivers, from most free to least free: 


| name abbreviation|free culture|use share remix copy Left |attribution|non-commercial|comment 

[creative Commons Zero](ccO.md) cco .yes il yes :) ) no :) no need :) no :) [public domain](public domain.md), copyright [waiver] 
waiver.md), no restrictions, moŝt freedom, best, sadly doesn't waive patents ahd tr 

Creative Commons Attribution CC BY yes :) yes :) |yes | yes :) no :) forced :( no :) no restrictions except for requiring attribution to 
authors 

Creative Commons Sharealike : . CC SA yes :) yes :) |yes,:) lyes :) yes :/ |no need :) no :) retired, secret license, no longer recommended by CC, 
ure copyleft/sharealike without forced attribution | 

creative commons Attribution Sharealike CC BY-SA yes :) yes :) |yes :) lyes :) yes :/ |forced :( no :) requires attribution to authors and copyleft (sharing 
ünder same terms 

Creative Commons Attribution NonCommercial CC BY-NC NO! :((( yes but|yes but|yes,but| yes :/ |forced :( yes :( [proprietary](proprietary.md) fascist license 
prohibiting commercial use, DO NOT USE | 

Creative Commons Attribution NoDerivs CC BY-ND NO! :((( yes but|yes but|NO! :( yes :/ |forced :( no but [proprietary](proprietary.md) fascist license 
prohibiting modifications, DO NOT USE 

Creative Commons Attribution NonCommercial NoDerivs| CC BY-NC-ND| NO! :((( yes but|yes but|NO! :( yes :/ |forced :( yes :( [proprietary](proprietary.md) fascist license 
rohibiting commercial use and even modifications, DO NOT USE 

NO! :((( NO! :( |NO! :( |NO! :( [FUCK YOU|FUCK YOU FUCK YOU [proprietary](proprietary.md) fascist option, 


none (alt rights reserve 


d 
prohibits everything, DO R USE 


Tl crime against economy.md ---------- 
# Crime Against Economy 


Crime against [economy | (economy -md) refers to any foulishit] (bullshit md) "crime" invented by [capitalism](capitalism.md) that is deemed to "hurt economy", the new God of sgciety . In the current 
dystopian m ty wheré money has replaced God, worshiping economy is thé new religion; to satisfy economy human and animal lives are sacrificed just as such sacrifices used to be made to please 
the gods of ancient times. 


Examples of crimes against economy include: 


Fixing purposefully broken technology, e.g. removing Pa oe 
ii 


z gnaet ng oneself from marketing torture and refusing to [consume](consumerism.md), e.g. by using [adblocks](adblock.md). 
- Burning money. 
- Doing literally anything that could destabilize economy such as simply giving away too many BE for free or for very low prices. 


Sharing useful information with other people which is called a "theft" of [intellectual property (intellectual property.md), "[piracy](piracy.md)" etc. 
- Taking basic natural resources from monstrously rich corporations who declare to own natural resources and deny access to them. E.g. printing money or physically taking goods from corporations 
without paying is declared a crime. 

- Destroying [ads](ads.md) and so sparing other of suffering. 
- Encouraging others to commit crimes against economy. 

- Revealing certain truths about rich people, corporations, their products or states, so called [whistleblowing](whistleblowing.md), [antivaxxing](antivax.md) etc. 
T crow funding.md ---------- 

# Crow Funding 


Crow funding is when a crow pays for your program. 
You probably misspelled [crowd funding](crowd funding.md). 


-- crypto.md -- 
# Cryptocurrency 


Cryptocurrency, or just ery plo, is a digital, virtual (non-physical) currency used on the [Internet] (internet md) which uses [cryptographic] (cryptography md) methods (electronic signatures 
etc.) to implement a [decen ralized| (decentralized md) system in which there iS no authority to control the currency (unlike eg. with traditional currencies that are controlled by the state or 
systems of digital payments controlled by the banks that run these systems). Cryptocurrencies use so called **[blockchain](blockchain.md)** as an underlying technology and are practically always 
implemented as [free and open-source software](foss.md). Example of cryptocurrencies are [Bitcoin](bitcoin.md), [Monero](monero.md) or [Dogecoin](dogecoin.md). 


The word, *crypto* in *crpytocurrency* **doesn't imply that the currency provides or protects privacy** -- it rather refers to the. cryptographic algorithms used to make the currency work -- even 
though thanks to the decentralization, anonymity and openness cryptocurrencies actually are mostly privacy friendly (up to the points of being conSidered the currency of criminals). 


[ERS] (Urs md) Sees cryptocurrencies as not only unnecessary foutishdt | (bullshit. md), but downright. as an **unethical** technology because [money] (money .md) itself is unethical, plus the 
urréncies based on proof of work waste not only human effort but alsó enormous amóünt of electricity and computing power that Could be spent in à better way. Keep in mind that 
**cryptocurrencies are part of [cryptofascism](cryptofascism.md)**; they're a way of digitizing harmful concepts existing in society. Crypto is just an immensely expensive game in which people 
try to fuck each other over money that have been stolen from the people. 


# History 
TODO 
# How It Works 


Cryptocurrency is build on top of so called [blockchain](blockchain.md) -- a kind structure that holds records of transactions. (exchanges of money or "coins", as called in the crypto world). 
Blockchain is a [data Structure (datasstrueture Mmd) serving as a [database](database.md) of the system. As its name suggests, it consists of **blocks**. Each block contains various data, most 
important of which are performed transactions (e.g. "A sent 1 coin to B"), and each block points to a previous one (forming a [linked list](linked list.md)). As new transactions are made, new 
blocks are created and appended at the end of the blockchain. 


But where is the blockchain stored? It is not.on a single computer; many computers participating in the system have their own copy of the blockchain and they share it together (similarly to how 
people share files via [torrents](torrent.md)). 


But how do we know which one is the "official" blockchain? Can't just people start forging information in the blockchain and then distribute the fake blockchains? Isn't there a chaos if there 
are so many copies? Well yes, it would be messy -- that's why we heed à **consensus** of the participants on which blockchain is the *real* one. And there are a few algorithms to ensure the 
consensus. Basically people can't just spam add new blocks, a new block to be added needs to be validated via some process (which depends on the specific algorithm) in order to be accepted by 
others. Two main algorithms for this are: 


- [proof of work] (Proof. of work md): For a block to be confirmed it has to have a specific cryptographic puzzle solved, e.g. it may need to have appended some string that makes the block's hash 
some predetermined value. Participants try to solve this puzzle: finding the string is difficult and has to be done by [brute force] (brute force md) (which wastes electricity and makes this 
method controversial). Once someone finds a solution, the block is confirmed and the solver gets a reward in coin -- this is therefore called **mining**. 

- [proof of stake](proof of stake.md); This methods tries to waste less energy by not, solving cryptographics, puzzles but rather having some chosen participants validate/confirm the blocks. 
BaSically participans can give some Of their money at stake which then gives them a chance (proportional to the amount of money put a stake) to be chosen as validators. A validator is then 
chosen at random who will check the transactions and sign the block. For this they will get a small reward in coins. If they try to confirm fraudulent transactions (e.g. money sent from people 
without any money), the network will punish them by taking away the money they put at stake (so there is a financial motivation to not "cheat"). 


Can't people just forge transactions, e.g. by sending out a record that says someone else sent them money? This can be easily prevented by [digitally signing] (digital_signature md) the 
transactions, i.e. if there is e.g. a transaction "A sends 1 coint to B", it has to be Signed by A to confirm that A really intended to send the money. But Can't someone just copy-paste someone 
else's already Signed transactions and try to perform them multiple times? This can also be prevented by e.g. numbering the transactions, i.e. recording something like "A sent 1 Coin to B as his 
1st transaction". 

But where are one's coins actually stored? They're not explicitly stored anywhere; the amount of coins, any participant has is deduced from the list of transactions, i.e.. 
joined the network with © coins and there is a record of Someone else sendihg him 1 coin, it is clear he now has 1 coin. For end users there are so called **wallets** whi 
Store their coins, but a wallet is in fact just the set of cryptographic keys needed to perform transactions. 


. if it is known someone 
ch to them appear to 


But why is blockchain even needed? Can't we just have a list of signed transactions without any blocks? Well, blockchain is designed to ensure coherency and the above mentioned consensus. 


C# is a supposed to be programming language](programming_language.md)" but it's just some capitalist [shit](shit.md) b Micro$oft](microsoft.md) that's supposed to give it some kind of 
i 1 b 
monopoly. Really it's not even worth writing about. It's like 09878] 3áva md) but worse. I'm tired, DO NOT U: THIS PSEUDOSHIT. Learn [C](c.md). 


T2 c tutorial.md ---------- 

# C Tutorial 

{ Still a work in progress, but 99% complete. -drummyfish } 
This is a relatively quick [C](c.md) tutorial. 


You should probably know at,least the completely basic ideas of programming before reading this (what's a {programming language] (programming_language.md), [source code](source_code.md), [command 
line](cli.md) etc.). If you're as far as already knowing another language, this should be pretty easy to underStand. 


## About C And Programming 
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[C](c.md) is 


- A **[programming language](programming language.md)**, i.e. a language that lets you express [algorithms](algorithm.md). 

- [compa te ](compiled.md) language (as opposed to [interpreted] (inter reted.md)), i.e. you have to compile the code you write (with [compiler](compiler.md)) in order to obtain a [native] 
(native.md) executable program (à binary file that you can run directly). 

- Extremely **fast and efficient**. E 
- Very **widely supported and portable** to almost anything 
- **[Low Teye l| [low level. nd) e^ i.e. there is relatively little [abstraction] (abstraction md and not many comfortable_built-in functionality such as [garbage collection] 
(garbage collection.md), you’ have to write many things yourself, you will deal with [pointers](pointer.md), [endianness](endianness.md) etc. 

- [imperative] ( imperative md) (based on sequences of commands), without [object oriented programming] (opp; md). Y : " . , 
- Considered hard**, but in certain ways it's simple, it lacks [bloat](bloat.md) and [bullshit](bul Shit md) of "pmodern] (modern md)" languages which is an essential thing. It will take long 
to learn (don't worry, not nearly as long as learning a foreign language) but it'S the most basic thing you should know if you want to create good software. You won't regret. 

- **Not folding your hand**, i.e. you may very easily "shoot yourself in your foot" and crash your program. This is the price for the language's power. 

- Very old, well established and tested by time. 

- Recommended by us for serious programs. 


If you come from a tanguage like [EY&hon] (pythgn . md or Jayapcript]Cjavascript md). ou may be shocked that C doesn't, come with its own [package Tanager]t ackage manager , md [debugger] 
debugger.md) or [build system](büild system.md), it doesn't have [modules (module mal? Í enerics (generics md), [garabage collection](garbage Collection. 5? OUPT(oop.md), ha5fimaps] 
hashmap.md), dynamic [lists](list.md), [type inference](type inference.md) and similar modern](modern.md)" features. When you truly get into C, you'll find it's a good thing. 


Programming in C works like this: 


1. You write a C source code into a file. 
2. You compile the file with a C [conpiter](compiler-md) such as [gcc](gcc.md) (which is just a program that turns source code into a runnable program). This gives you the executable program. 
3. You run the program, test it, See how it works and potentially get back to modifying the source code (step 1). 


So, for writing the, source code you'll need a [text editor](text editor.md); any {plain text](plain_text.md) editor will do but you should use some that can highlight Ç [svptax](s ntax.md) -- 
this helps very much when programming and is actically a necessity. Ideal editor is [vim] Cvim. md) but it'S a bit difficult to learn so you can use something s simple as [Gedit](gedit.md) or 
Geapy] (geany md) . We do NOT recommend. using huge programming [IDEs](ide.md) such as "VS Code" and whatnot. You definitely can NOT use an advanced document editor that works with [rich text] 
rich text.md) such as [LibreOffice](libreoffice.md) or that [shit](shit.md) from Micro$oft, this won't work because it's not plain text. 


d one called [acc] (gcc md) (you can tr 
ic ly 


Next you'll need a C [compiler (compiler.md), the program that will turn your source code into a runnable program. We'll use the most commonly y E 
G I should), gcc is 


use 
different ones such as ang](clang.md) or [eec] cc.md) if you want). IT you're on a [unixi(unixsmd)- tike system such as [GNU] ( nu.md)/[Linüx](linux.md) (wh. ; You probal l 
rd already installed. Open up a terminal and write “gcc to see if it's installed -- if not, then install it (e.g. with “Sudo apt install build-essential' if you're on a Debian-based 
System). 
If you're extremely lazy, there are online web C compilers that work in a web browser (find them with a search engine). You can use these for quick experiments but note there are some 
limitations (e.g. hot being able to work with files), and you should definitely know how to compile programs yourself. 


Last thing: there are multiple standards of C. Here we will be covering [C99](c99.md), but this likely doesn't have to bother you at this point. 
44 First Program 
Let's quickly try to compile a tiny program to test everything and see how everything works in practice. 


Open your text editor and paste this code: 


/* simple C program! */ 
#include <stdio.h> // include IO library 
int main(void) 

puts("It works."); 


return 0; 


Save this file and name it "resram c > Then open a terminal emulator (or an equivalent command line interface), locate yourself into the directory where you saved the file (e.g. “cd 
somedirectory ) and compile the program with the following command: 


gcc -o program program.c 
The program should compile and the executable "program? should appear in the directory. You can run it with 
program 

And you should see 

It works. 


written in the command line. 
Now let's see what the source code means: 


- "/* simple C program! */^ is so. called *block comment*, it does nothing, it's here only for the humans that will read the source code. Such comments can be almost anywhere in the code. The 
comment starts at ^ /* and ends with ^*/'. 

- '// include IO library’ is another comment, but this is a *line comment*, it starts with ^//^ and ends with the end of line. 

= "Hinclude «stdio.h»' tells the compiler, we want.to include a library named *stdio* (the weird [syntax](syntax.md) will be explained in the future). This is a standard, Library with input output 
functions, we need it to be able to use the function “puts” later on. We can include more libraries if we want to. These includes are almost always at the very top of the source code. 

- “int main(void). is the start of the main program. What exactly this means will be explained later, for now just remember there has to be this function named /main' in basically every program 
-- inside it thefe are commands that will be exécuted when the program is run. Note that the curly brackets thàt follow ( (^ and ^) ) denote the block of code that belongs to this function, so 
we need to write our commands between these brackets. 

- Ruts CIE works, aU f is a "command", for printing text strings to the command line (it's a command from the,'stdio' library included aboye): Why exactly this iş written like this will be 
explainéd later, but for now notice the fo t (^ and 


lowing. The command starts with its name puts’, for *put string*), then there are left and rig brackets ( between which there are 
arguments to the command, in our case there is one, the text string `"It works."'. Text strings have to be put between quotes C nali otherwise the compiler would think the words are other 
commands (the quotes are not part of the string itself, they won't be printed out). The command is terminated by ^;' -- all "normal" commands in C have to end with a semicolon. 


0;^ is another "command", 


- "return s it basically tells the, operating system that everything was terminated successfully (;0' is a code for success), This command is an exception in that it 
doesn't have to have brackets ( (^ and `)`). This doesn't have to bother us too much Row, let' 


j0 
s just remember this will always be the last command in our program. 


Also notice how the source code is formatted, e.g. the indentation of code withing the :[(' and `}` brackets. White characters (spaces 


t t ` : i r new lines, tabs), are ignọred by the compiler so we can 
theoretically write our program on a single tine, but that would be unreadable. Wë use indentation, spaces and empty lines to format the code to'be well 


readáble. 


To sum up let's see a general structure of a typical C program. You can just copy paste this for any new program and then just start writing commands in the “main” function. 


#include <stdio.h> // include the I/O library 
// more libraries can be included here 


int main(void) 
// write commands here 


return 0; // always the last command 


## Variables, Arithmetic, Data Types 


Programming is a lot like mathematics, we compute equations and.transform numerical values into other values, You.probably know in mathematics we use *variables* such as *x*.or *y* to denote 
numérical values that can change (hence variables). In programming we also use variables -- here Vt Variable](varibbie md] is a place in memory which has a name** (and in this place there will 
be stored a value that can change over time). 

We can create variables named `x`,.`y`, ‘myVariable’ or “score,” and then,store,specific values (for now let's only consider numbers) into them, We can read from and write to these variables at 
any time. These variables physically reside in [RAM](ram.md), but we don't really care where exactly (at which address) they are located -- this is e.g. similar to houses, in common talk we 
normally say things like *John's house* or *the pet store* instead of *house with address 3225*. 


Variable names can't start with a digit (and they can't be any of the [keywords] (Keyword md) reserved by C). By convention they also shouldn't be all uppercase or start with uppercase (these are 
normally used for other things). Normally we name variables like this: myVariable or 'my variable' (pick one style, don't mix them). 


In C_as in other, languages each variable has a certain **[data type] (data type.md)**; that is each variable has associated an information of what kind of data is stored in it. This can.be 
*whole number*, *fractión*, a *text character*, *text string* etc. Data types are a more complex topic that will be discussed later, for now we'll start with the most basic one, the **int 
type**, in C called "int'. An `int`ò variable can store whole numbers in the range of at least -32768 to 32767 (but usually much more). 


e.g. a 
eger 


Let's see an example. 


#include <stdio.h> 

int main(void) 

t int myVariable; 
myVariable = 5; 
printf("%d\n",myVariable); 
myVariable = 8; 


printf("%d\n",myVariable); 


- "int myVariable;' is so called **variable declaration**, it tells the Compiler we are creating a new variable with the name ^myVariable' and data type '^int'. Variables can be created almost 
anywhere in the code (even outside the ‘main’ function) but that's a topic for later. 

- "myVariable -,5;" is so called,**variable assignment**, it stores a value 5 into variable named ^"myVariable'. IMPORTANT NOTE: the ^-'.does NOT signify mathematical equality but an assignment 
(equality in C is'written as “=="); when compiler encounters ^-', it simply takes the value on the right of it and writes it to the variable on the left side of it. Sometimes people confuse 
assignment with an equation that the compiler solves -- this is NOT the case, assignment is much more simple, it simply writes a value into variable. So "x = x + 1;` is a valid command even 
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though mathematically it would be an equation without a solution. . 2 " : . : : : 

- “printf("%d\n",myVariable);* prints out the value currently stored in "myVariable'. Don't get scared by this complicated command, it will be explained later (once we learn about [pointers] 
(pointer.md)). For now only know this prints the variable content. 

- "myVariable = 8;^ assigns a new value to `myVariable`, overwriting the old. 

- “printf("%d\n",myVariable);~> again prints the value in '"myVariable'. 


After compiling and running of the program you should see: 


5 

Be 

Last thing to learn_is **arithmetic operators**. They're just normal math operators such as +, - and /. You can use, these along with brackets (^(^ and p to create or exprepsions]; 
(expressión.md)**. Expressions can contain variables and Can themselves be used in many places where variables can be used (but not everywhere, é.g. on thé left side of variable assignment, that 


would make no sense). E.g.: 
&include «stdio.h» 
uM main(void) 
int heightCm - 175; 
int weightKg - 75; 
int bmi = (weightKg * 10000) / (heightCm * heightCm); 


printf("9&dNn", bmi); 


calculates and prints your BMI (body mass index). 


Let's quickly mention how you,can read and write values in C so that you can begin to experiment with your own small programs. You don't have to understand the following [syntax](syntax.md) as 
of yet, it will be explained later, now simply copy-paste the commands: 


*puts("hello" Prints a text string with newline. 

"printf("hello") Same as above but without newline. 

‘printf ("%d\n", x Prints the value of variable `x` with newline. 

*printf("%d ");^: Same as above but without a newline. 

"Scanf ("«d",&x]; `: Read a number from input to the variable ^x^. Note there has to be ^&' in front of ^x^ 


## Branches And Loops (If, While, For) 


Wen. creating [algorithms](algorithm.md), it's not enough to just write linear sequences of commands. Two things (called [control structures](control structure.md)) are very important to have in 
addition: 


- **[branches](branch.md)**; Conditionally executing or skipp 
password was incorrect). This is informally known aš **"if-then-else 
dd Loops] (Loa .md)** (also called **iteration**): Repeating certain commands given number of times or as long as some condition holds (e.g. when searching a text we repeatedly compare words 
one by one to the searched word until a match is found or end of text is reached). 


ing certain commands (e.g. if a user enters password we want to either log him in if the password was correct or write error if the 


Let's start with **branches**. In C the command for a branch is "if'. E.g.: 


if (x » 10) 
..puts("X is greater than 10."); 


The [syntax (syntax,md) is given, we start with "if', then brackets (^(^ and `)`) follow inside which there.is a. condition, then a command or a block of multiple commands (inside "(^ and ^j") 
follow. If the conditión in brackets holds, the command (or block of commands)’ géts executed, otherwise it is skipped. 


onally there may be an *else* branch which is gets executed only if the condition does NOT hold. It is denoted with the 'else' keyword which is again followed by a command or a block of 
ultiple Commands. Branching may also be nested, i.e. branches may be inside other branches. For example: 


if (x > 10) 
puts("X is greater than 10."); 
else 


puts("X is not greater than 10."); 


if (x < 5) 
puts("And it is also smaller than 5."); 


So if ^x^ is equal e.g. 3, the output will be: 


X is not greater than 10. 
And it is also smaller than 5. 


About **conditions** in C; a,condition is just.an expression (variables/functions along with arithmetic operators). The expression is evaluated (computed) and the number that, is obtained is 
interpreted as *true* or *false* like this: **in C 0 (zero) means false, 1 (and everything else) means true**. Even comparison operators like '« and >` are technically arithmetic, they compare 
numbers and yield either 1 or 0. Some operators commonly used in conditions are: 


not equal yields 1 if the operands are NOT equal, otherwise 0. 

ess than): yields 1 if the first operand is smaller than the second, otherwise 0. 
xn yields 1 if the first operand is smaller or equal to the second otherwise 0. 
&&^ ogical [AND](and.md)): yields 1 if both operands are non-0, otherwise 0. 
`| |` (logical [OR](or.md)): yields 1 if at least one operand is non-0, otherwise 0. 
(logical [NOT](not.md)) 


I {not equa yields 1 if the operands are equal, otherwise 0. 
( í 


E ^ 
1i 


yields 1 if the operand is 0, otherwise 0. 
E.g. an if statement starting as “if (x == 5 || x == 10)' will be true if ^x^ is either 5 or 10. 
Next we have **loops**. There are multiple kinds of loops even though in theory it is enough to only have one kind of loop (there are multiple types out of convenience). The loops in C are: 


- **while**: Loop with condition at the beginning. 
- **do while**: Loop with condition at the end, not used so often so we'll ignore this one. , 7 P 
- **for**: Loop executed a fixed number of times. This is a very common case, that's why there is a special loop for it. 
The **while** loop is used when we want to repeat something without knowing in advance how many times we'll repeat it (e.g. searching a word in text). It starts with the “while” keyword, is 
followed by brackets with a condition inside (same as with branches) and finally a command or à block of commands to be looped. For instance: 
while (x » y) // as long as x is greater than y 
printf("%d %d\n",x,y); // prints x and y 


X - 1; // decrease x by 1 
y * 2; // double y 


x 
y 

H 

puts("The loop ended."); 


If ^x^ and ^y were to be equal 100 and 20 (respectively) before the loop is encountered, the output would be: 


The loop ended. 


The **for** loop is executed a fixed number of time, i.e,..we use it when, we know in advance how many time we want to repeat our commands. The [gyntax] (syntax. md) is a bit more complicated; it 
starts with the keywords ‘for then brackets ( (^ and `)`) follow and then the command or a block of commands to be looped. The inside of the brackets Consists of an initialization, condition 
and action separated by semicolon (C) -- don't worry, it is enough to just remember the structure. A for loop may look like this: 


puts("Counting until 5..."); 
for (int i = 0; i < 5; ++i) E 
_ prantf("%d\n",i); // prints i 


"int i = 0° creates a new temporary variable named ^i^ (name normally used,by convention) which is used as a **counter**, i.e. this. variable starts at 0 and increases with each iteration 
(cycle), and it can be used inside the loop body (the repeated commands). `i < 5° says the loop continues to repeat as long as i' is smaller than 5 and `++i` says that 'i' is to be increased by 
i after each iteration (`++i` is basically just a shorthand for ^i = i + 1°). The above code outputs: 


Counting until 5... 
(oJ 


RONE 


IMPORTANT NOTE: in, programming we **count from O**, not from 1 (this is convenient e.g. in regards to [pointers](pointer.md)). So if we count to 5, we get 0, 1, 2, 3, 4. This is why `i` starts 
with value 0 and the end condition is i «5 (not “i <= 5°). 


Generally if we want to repeat the “for” loop *N* times, the format is “for (int i = 0; i < N; ++i)`. 
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p can be exited at any time with a special command called “break>, This is often used with so. called infinite loop, a *while* loop that has “1° as a condition; recall that 1 means true, 
e loop condition always holds and the loop never ends. "break" allows us to place conditions in the middle of the toop and into multiple places. E.g.: 
uite (1) // infinite loop 

x=x- 1; 


if (x == 0) : : 
break; // this exits the loop! 


y-y/x 

da. 

The code above places a condition in the middle of an infinite loop to prevent division by zero in `y =y/ x`. 

Again, loops can be nested (we may have loops inside loops) and also loops can contain branches and vice versa. 

## Simple Game: Guess A Number 

With what we've learned so far we can already make a simple [game](game.md): guess a number. The computer thinks a random number in range © to 9 and the user has to guess it. The source code is 


following. 


&include «stdio.h» 
#include <stdlib.h> 
#include <time.h> 


int main(void) 
srand(clock()); // random seed 
while (1) // infinite loop 
int randomNumber = rand() % 10; 
puts("I think a number. What is it?"); 
int guess; 


scanf("%d",&guess); // read the guess 


getchar(); 
if (guess == randomNumber ) 
s("You guessed it!"); 


pu 
E pFintf("Wrong. The number was %d.\n", randomNumber ) ; 

puts("Play on? [y/n]"); 

char answer; 

scanf("%c",&answer); // read the answer 

if (answer == 'n') 

break; 

puts("Bye."); 


return 0; // return success, always here 


- “#include «stdlib.h»^, ~“#include «time.h»': we're including additional libraries because we need some specific functions from them (“rand*, `srand`ò, ~clock’). 

- ngpandCetoek (9 07 don't mind this line too much, its purpose is to [seed](seed.md) a pseudorandom number generator. Without doing this the game would always generate the same sequence of 
random numbers when run again. 

- "while qr is an infinite game loop -- it runs over and over, in each cycle we perform one game round. The loop can be exited with the “break” statement later on (if the user answers he 
doesn't want to continue playing). 

- "int randomNumber = rand() % 10; ; this,line.declares a,variable named 'randomNumber' and immediately assigns a value to it. The value is.a random number frọm Ọ to.9. This is achieved with a 


function "rand. (from the above included `stdlib“ library) which returns a random number, and with the modulo (remainder after division) arithmetic operator ( 9^) which ensures the number is in 
the correct range (less than 10). 

- "int guess i creates another variable in which we'll store the user's guessed number. 

ie 804n ("9d",&guess);' reads a number from the input to the variable named 'guess'. Again, don't be bothered by the complicated structure of this command, for now just accept that this is how 
it's done. 

- jgetchar(); 


: don't mind this line, it just discards a newline character read from the input. 

- (if (guess = randomNumber) ...': this is a branch which,checks if the user guess, is equal to the. generated random number, If so, a success message is printed out. If not, a.fail message is 
printed out along with the sécret number. Note we use the "puts function for the first message as it only prints a text sting, while for the latter? message we have to use printf’, a more 
complex function, because that requires inserting a number into the printed string. More on these functions later. 

- "char answer; declares a variable to store user's answer to a question of whether to play on. It is of 'char' data type which can store a single text character. 

- “scanf("%c",&answer);~ reads a single character from input to the 'answer'^ variable. 

- "if (answer == 'n') break;? is a branch that exits the infinite loop with "break? statement if the answer entered was `n`ò (*no*). 


## Functions (Subprograms) 


Functions are extremely important, no program besides the most primitive ones can be made without them (well, in theory any program can be created without functions, but in practice such 
programs would be extremely complicated and unreadable). 


**[Function](function.md) is a subprogram** (in other languages functions are also called procedures or subroutines), i.e. it is code that solves some smaller subproblem that you can repeatedly 
invoke, for instence you may have a function for computing a [square root](sqrt.md), for encrypting data or for playing a sound from speakers. We have already met functions such as ‘puts’, 
‘printf’ or ^rand'. 


Functions are similar to but **NOT the same as mathematical, functions**. Mathematical function (simply put) takes a number as input and outputs another number computed from the input number, and 
this output number depends only on the input number and nothing else. C functions can do this too but t ey can also do additional things such as modify variables in other parts of the program or 
make the computer do something (such as play a sound or display something on the screen) -- these are called **[side effects](side_effect.md)**; things done besides computing an output number 
from an input number. For distinction mathematical functions are called *pure* functions and functions with side effects are called non-pure. 


**why are function so important?" Firstly they help us divide a big problem into small subproblems and make the code better organized and readable, but mainly they help us respect the [DRY] 
(dry.md) (*Don't Repeat Qurselt. ) principle -- this is extremely important in programming. Imagine you need to solve a [quadratic equation](quadratic, equation.md) in several parts of your 
program; you do NOT want to solve it in each place separately, you want to make a function that solves a quadratic equation and then only invoke (call) that function anywhere you need to solve 
your quadratic equation. This firstly saves space (source code will be shorter and compiled program will be smaller), but it also makes your program manageable and eliminates bugs -- imagine you 
find a better (e.g. faster way to solving quadratic equations; without functions you'd have to 9 through the whole code and change the algorithm in each place separately which is impractica 
maki in the 


and increases the chance o ng errors. With functions you only change the code in one place unction) and in any place where your code invokes (calls) this function the new better 


and updated version of the function will be used. 


Besides writing programs that can be directly executed programmers write eritibrariesIetibrary:md) y -- collections of functions that can be used in other projects. We have already seen 
libraries such as *stdio*, *standard in ut OUT DUE library*, a standard (official, bundled with every C compiler ) library for input/output (reading and printing values); *stdio* contains 
functions such as `puts` which is used to printing out text strings. Exàmples of other libraries are the standard *math* library containing function for e.g. computing [sine](sine.md), or [SDL] 
(sdl.md), a 3rd party multimedia library for such things as drawing to screen, playing sounds and handling keyboard and mouse input. 


Let's see a simple example of a function that writes out a temperature in degrees of Celsius as well as in Kelvin: 


#include <stdio.h> 

void writeTemperature(int celsius) 
int kelvin = celsius + 273;. » 
printf("%d C (%d K)\n",celsius, kelvin); 


zt main(void) 


writeTemperature(0); 


writeTemperature( -50); 
writeTemperature(100) ; 


return 0; 


The output is 


Now imagine we decide we also want our temperatures in Fahrenheit. We can simply edit the code in "writeTemperature' function and the program will automatically be writing temperatures in the 
new way. 


Let's see how to.create and.inyoke functions. Creating a function in code is done between inclusion of libraries and the “main function’, and we formally call this **defining a function**. The 
function definition format is following: 


RETURN TYPE FUNCTION NAME(FUNCTION PARAMETERS) 
FUNCTION BODY 


:, RETURN TYPE, is the [data type] (data. type md) the function returns. A function may or may not return a certain value, just as the pure mathematical function do. This may for example be "int', 
if the function returns an integer number. If the function doesn't return anything, this type is ‘void’. 

- 'FUNCTION NAME^ is the name of the function, it follows the same rules as the names for variables. 1 F Y 

>, FUNCTION PARAMETERS specifies the input values of the function. The function can take any number of parameters (e.g. a function 'playBeep' may take © arguments, 'sine' function takes 1 
logarithm’ may take two etc.). This list is comma-separated and each item consists of the parameter data type and name. If there are 0 parameters, there should be the word ‘void’ inside the 
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brackets, but compilers tolerate just having empty brackets. . . ; 
- “FUNCTION BODY’ are the commands executed by the function, just as we know them from the *main* function. 


Let's see another function: 


#include <stdio.h> 
int power(int x, int n) 
int result = 1; 


for (int i = 0; i < n; ++i) // repeat n times 
result = result * x; 


return result; 
int main(void) 


pr (int i = 0; i < 5; ++i) 


int powerOfTwo = power(2,i); 
printf ("%d\n", powerOfTwo) 


; 


return 0; 


The output is: 


HORN + 


The function power takes two parameters: `x` and ‘n°, and returns ^x; raised to the “n’s power. Note that unlike the first function we saw here the return type is 'int' because, this, function 
does return a value. **Notice the command 'return'** -- it is a special command that causes the function to terminate and return a specific value. In functions that return a value (their return 


type is not `void`) there has to be a ‘return’ command. In function that return nothing there may or may not be one, and if there is, it has no value after it (`return;`); 


Let's. focus on how.we invoke the function -- in programming we say we **call the function**. The function call in our.code is ^power(2,i)'. If a function. returns a value [return type is not 
void’), its function call can be used in any expression, i.e. almost anywhere where we can use a variable or a numerical value -- just imagine the function computes a return value and this 
value is **substituted to the place where we call the function**. For example we can imagine the expression “power(3,1) + power (3,0) as simply ^3 + 1'. 


If a function returns nothing (return type, is ^void'), it can't be used in expressions, it is used "by itself"; e.g. '"playBeep();' . (Function that do return a value can also be used like this -- 
their return value is in thi$ case simply ignored.) 


We call a function by writing its name (^power;), then adding brackets Che and ^)') and inside them we, put ncetgumense* -- specific values that will substitute the corresponding parameters 
inside the function Ynere x` will take the value 2 and n will take the current value of 'i'). If the functión takes no parameters (the function parameter list is "void ), we simply put 
nothing inside the brackets (e.g. 'playBeep(); ); 


Here comes the nice thing; **we can, nest function calls**, For example we can write `x = power(3,power(2,1));'^ which, will result in assigning the variable “x” the value of 9. **Functions can 
atso catt SCR Tune ones (Syen themselves, see [recursion](recursion.md)), but only those that have been’ defined before them in the sourcé code (this can be fixed with so called [forward 
eclarations](forward decl.md)). 


Notice that the. main’ function we always have in our programs is also a function definition. The definition of this function is required for runnable programs, its name has to be "main? and it 
has to return ‘int’ (an error code where © means no error). It can also take parameters but more on that later. 


These is the most basic knowledge to have about C functions. Let's see one more example with some pecularities that aren't so important now, but will be later. 


#include <stdio.h> 

void writeFactors(int x) // writes divisord of x 
printf("factors of %d:\n",x); 
while (x > 1) // keep dividing x by its factors 


for (int i 2; i <= x; ++i) // search for a factor 

if (x % i == 0) // i divides x without remainder? 

printf("  %d\n",i); // i is a factor, write it 
xX-x i; // divide x by i 
break; // exit the for loop 


H 
H 


uM readNumber ( void) 
int number; 


puts("Please enter a number to factor (0 to quit)."); 
scanf ("%d", &number ) ; 


return number; 


J 
int main(void) 
while (1) // infinite loop 
int number - readNumber(); // «- function call 


if (number == 0) // © means quit 
break; 


writeFactors(number); // «- function call 


return 0; 
We have defined two functions: "writeFactors' and 'readNumber'. ^writeFactors' return no values but it has side effects (print text to the command line). 'readNumber^ takes no parameters but 
return a value; it prompts the user to enter a value and returns the read value. 
Notice that,inside "writeFactors' we modify its parameter ^x^ inside the function body -- this is okay, it won't affect the argument that was passed to this function (the '"number' variable 
inside the "main function won't change after this function call). 'x. can be seen as a **[local variable] {local variable md] of the function, i.e. a variable that's created inside this 
function and can only be used inside it -- when "writeFactors' is called inside ‘main’, a new local variable ^x^ is created inside "writeFactors' and the value of “number” is copied to it. 


Another.local variable is "number" -- it.is.a local variable both in "main' and in, readNumber:. Even, though the names are the same, these are two different variables, each one is local to its 
respective function (modifying ‘number’ inside 'readNumber' won't affect “number” inside '"main' and vice versa). 


And E last thin i keep in mind that not every command you write in C program is a function call. E.g. control structures ("if^, ^while', ...) and special commands (‘return’, “break*, ...) are 
not function calis. 


## More Details (Globals, Switch, Float, Forward Decls, ) 


We've skipped a lot of details and small tricks for simplicity. Let's go over some of them. Many of the following things are so called [syntactic sugar](sugar.md): convenient syntax shorthands 
for common operations. 


Multiple variables can be defined and assigned like this: 

int x = 1, y = 2, z; 

The meaning should be clear, but let's mention that `z` doesn't generally have a defined value here -- it will have a value but you don't know what it is (this may differ between different 
computers ànd platforms). See [undefined behavior] (undefined behavior md). 


The following is a shorthand for using operators: 


// same as: X = X + 1; 
// same as: X = X - 1; 
// same as: X - X * (x * 1); 
// same as: x = X + 1; 
// same as: X = X - 1; 


The last two constructs are called **[incrementing](increment.md)** and **[decrementing](decrement.md)**. This just means adding/subtracting 1. 
In C there is a pretty unique operator called the **[ternary operator](ternary operator.md)** (ternary for having three [operands](operand.md)). It can be used in expressions just as any other 
operators such as “+ or '- . Its format is: 


CONDITION ? VALUE1 : VALUE2 


It evaluates the CONDITIONS and if it's true (non-0), this whole expression will have the value of `VALUE1`, otherwise its value will be `VALUE2`. It allows for not using so many "if's. For 
example instead o 
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we can write 
X,2 x >= 10 ? x - 10 : 10; 


**[Global Variables] (gtobal_variable.md)*® : we can create variables even outside function bodies. Recall than variables inside functions are called *local*; variables outside functions are 
catled *global* -- théy can basically bé accessed from anywhere and can sometimes be useful. For example: 


&include «stdio.h» 
#include <stdlib.h> // for rand() 


int money - 0; // total money, global variable 


void printMoney(void) 


printf("I currently have $%d.\n",money) ; 


void playLottery(void) 

t puts("I'm playing lottery."); 
money -- 10; // price of lottery ticket 
if (rand() 96 5) // 1 in 5 chance 


money += 100; 
puts("I've won!"); 


else 
puts("I've lost!"); 


} printMoney(); 


void work(void) 
puts("I'm going to work :("); 
money += 200; // salary 


printMoney(); 


int main() 
work(); 
PlayLitteryO; 
work(); 
playLottery(); 


return 0; 


In C programs you may encounter a **switch** statement -- it is a control structure similar to a branch `if`ò which can have more than two branches. It looks like this: 


switch (x) 


case 0: puts("X is zero. Don't divide by it."); break; 
case 69: puts("X is 69, haha."); break; 3 
case 42: puts("X is 42, the answer to everything."); break; 
default: printf("I don't know anything about X."); break; 


Switch can onl compare exact values, it can't e.g. check if a value is greater than something. Each branch starts with the keyword ‘case’, then the match value follows, then there is a colon 
:`) and the branch commands follow. IMPORTANT: there has to be the "bréak; statement at thé end of each case branch (we won't go into details). A special branch is the one starting with the 
word ‘default’ that is executed if no case label was matched. 
Let's also mention some additional data types we can use in programs: 
: "char: A single text character such as *'a'*, *'G'* or *' '*, We can assign characters as ‘char c = 'a';^ (Single characters are enclosed in apostrophes similarly to how text strings are 
inside quotes). We can read a character as `c = getchar();^ and print it as “putchar(c); . Special characters that can be used are ^in (newline) or '* (tab). Characters are in fact small 
Y 


numbers (usua with 256 possible values) and can be used basically anywhere a number can be used (for example we can compare characters, e.g. if (c < 'b') ..."). Later we'll see characters 
are basic building blocks of text strings. 


- ‘unsigned int': Integer that can only take positive values or © (i.e. no negative values). It can store higher positive values than normal `int` (which is called a *signed int*). 
- ‘long’: Big integer, takes more motory but can store number in the range of at least a few billion. 
an 


- "float; “double: GF logtin point (float .md) number (:double',is bigger and more precise than "float') -- an approximation of [real numbers](real number.md), i.e. numbers with a fractional 
part such as 2.5 or 0.0001. You Can print these numbers as “printf("%Lf\n",x); and read them as 'scanf("9*f",&x);' . 


Here is a short example with the new data types: 


#include <stdio.h> 
Pt main(void) 


char c; 
float f; 


puts("Enter character."); 
c = getchar(); // read Character 


puts("Enter float."); 
scanf ("%f",&f); 


printf("Your character is :%c.\n",c); 
printf("Your float is %lf\n",f); 


float fSquared - f * f; 
int wholePart - f; // this can be done 


printf("It's square is %1f.\n" fequared) 
"It's whole part is %d. Án", whole art); 


printf 

return 0; 
d 
Notice mainly how we can assign a "float! value into the variable of "int, type ('int wholePart = f;`). This can be done even the other way around and with many other types. C can do automatic 
**type conversions** (*[casting](cast.md)*), but of course, some information may be lost in this procéss (e.g. the fractional part). 
In the section about functions we said a function can only call a function that has been defined before it in the source code -- this is, because the compiler read the file from start to finish 
and if you call a function that hasn't been defined yet, it simply doesn't know what to call. But sometimes we need to call a function that will be defined later, e.g. in cases where two 
functions call each other (function *A* calls function *B* in its code but function *B* also calls function *A*). For this there exist so called **[forward declaractions](forward decl.md)** -- a 


forwara declaration is informing that a function of certain name (and with certain parameters etc.) will be defined later in the code. Forward decláration look the same às a function definition, 
ut it doesn't have a body (the part between ^(^ and ~}°), instead it is terminated with a semicolon (^; ). Here is an example: 

#include <stdio.h> 

void printDecorated2(int x, int fancy); // forward declaration 

void printDecoratedi(int x, int fancy) 

t putchar('-'); 


if (fancy) 
printDecorated2(x,0); // would be error without f. decl. 


else 
printf ("%d",x); 
} putchar('~'); 
1 printDecorated2(int x, int fancy) 
putchar('>'); 


if (fancy) 
printDecoratedi(x,0); 


else 
printf ("%d",x); 


} putchar('<'); 


int main() 
{ 
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printDecorated1(10,1); | 
putchar('\n'); // newline 
printDecorated2(20,1); 


which prints 
~>10<~ 
Boos 


The functions '"printDecoratedi' and ^printDecorated2' call each other, so this is the case when we have to use a forward declaration of ^printDecorated2'. Also note the condition “if (fancy) 
which is the same thing as “if (fancy !- 0) (imagine "fancy being 1 and © and about what the condition evaluates to in each case). 


## Header Files, Libraries, Compilation/Building 

So far we've only been writing programs into a single source code file (such as 'program.c'^). More complicated programs consist of multiple files and libraries -- we'll take a look at this now. 
In C we normally deal with two types of source code files: 

ine Somat fer: These files contain so called **[implementation](implementation.md)** of algorithms, i.e. code that translates into actual program instructions. These files are what's handed to 

- *.h files*, or **[header files](header_file.md)**: These files typically contain **declarations** such as constants and function headers (but not their bodies, i.e. implementations). 


When we have multiple source. code files, we typically have pairs of *.c* and *.h* files. E.g. if there is a library called *mathfunctions*, it will consist of files *mathfunctions.c* and 
e*. 


*mathfunctions.h*. file will contain e fuhction headers (in the same manner as with forward declarations) and constants such as [pi](pi.md). The *.c* file will then contain the 


implementations of all the functions declared in the *.h* file. But why do we do this? 


Firstly *.h* files may serve as a nice documentation of the library for programmers: you can simply open the *.h* file and see all the functions the library offers without having to skim over 
thousands of lines of code. Secondly this is for how multiple source code files are compiled into à single executable program. 


Suppose now we're compiling a single file named *program.c* as we've been doing until now. The compilation consists of several steps: 


1. The compiler reads the file *program.c* and makes sense of it. , : F : n " , : i p" 
2. It then creates an intermediate file called *program.o*. This is called an [object file](object file.md) and is a binary compiled file which however cannot yet be run because it is not 
*linked* -- in this code all memory addresses are rélative and it doesn't yet contain the Code from external libraries (e.g. the code of ^printf ) 


3. e compiler then runs a ** Jinkgr]CHnker mp 77 which takes, the file oBregram: pr. and the object files of libraries (such as the *stdio* library) and it puts them all together into the final 
executable file called *program*. This$ is called **linking**; the code from the libraries is copied to complete the codé of our program and the memory addresses are settled to some specific 
values. 


So realize that when the compiler is compiling our program (programei); which contains function.such,as ‘printf’ from a separate library, it doesn't have the code of these functions available 
-- this code is not in our file. Recall that if we want to call à function, it must have been defined before and so in order for us to be able to call ‘printf’, the compiler must know about it. 
This is why we include the *stdio* library at the top of our source code with “#include «stdio.h»' -- this basically copy-pastes the content of the header file of the *stdio* library to the top 
of our source code file. In this header there are forward declarations of functions such as ‘printf’, so the compiler now knows about them (it knows their name, what they return and what 
parameters they take) and we can call them. 


Let's see a small example. We'll have the following files (all in the same directory). 


*library.h* (the header file): 


// Returns the square of n. 
int square(int n); 


*library.c* (the implementation file): 


int square(int x) 


// function implementation 
return x * x; 


*program.c* (main program): 
tette stie 
int main(void) 
int n - square(5); 
printf("9&dNn",n); 


return 0; 


NOTE: ^"library.h"^ here is between double quotes, unlike “<stdio.h> . This just says we specify an absolute path to the file as it's not in the directory where installed libraries go. 


Now we will manually compile the library and the final program. First let's compile the library, in command line run: 
gcc -c -o library.o library.c 


The `-c` flag tells the compiler to only compile the file, i.e. only generate the object (*.0o*) file without trying to link it. After this command a file *library.o* should appear. Next we 
compile the main program in the same way: 


gcc -c -o program.o program.c 


This will generate the file. *program.o*. Note that during.this process the compiler is working only with the. *program.c* file, it doesn't know the code of the function “square, but it knows 
this function exists, what it returns and what parameter it has thanks to us including the library header *library.h* with “#include "library.h"' (quotes are used instead of `< and `>` to tell 
the compiler to look for the files in the current directory). 


Now we have the file *program.o* in which the compiled ^main' function resides and file *library.o* in which the compiled function ^'square' resides. We need to link them together. This is done 
ike this: 


gcc -o program program.o library.o 


For inking we dont need to use any special flag, the compiler knows that if we give it several *.o* files, it is supposed to link them. The file *program* should appear that we can already run 
and it should prin 


28. 
This is the principle of compa Lin multiple_C files (and it also allows for fombining C with other tenouages): This Pees ess is normally automated, but you should know how it, works. The systems 
o mal 


that automate this action are called **[build systems](build system.md)**, they are r example [Make e.md) and [Cmake](cmake.md). when using e.g. the Make system, the whole codebase’ can be 
built with a single command “make” in the command line. 


Some rogrammers simplify this whole process further so that they don't even need a build system, e.g. with so called [header-only libraries](header_only.md), but this is outside the scope of 
is tutorial. 


As a bonus, let's see a few useful compiler flags: 


7-017, ^-02^, ^-03': Optimize for speed (higher number means better optimization). Adding '-03' normally instantly speeds up your program. This is recommended. 
*-Os*: Optimize for size, the same as above but the compiler will try to make as small executable as possible. 

^-Wall -Wextra -pedantic : The compiler will write more warnings and will be more strict. This can help spot many bugs. 

7-c:: Compile only (generate object files, do not link). 

^-g^: Include debug symbols, this will be important for [debugging](debugging.md). 


## Advanced Data Types And Variables (Structs, Arrays, Strings) 


Until now we've encountered simple data types such as '"int', “char” or ^float'. These identify values which can take single atomic values (e.g. numbers or text characters). Such data types are 
called **[primitive types](primitive type.md)**. 


Above these there exist **[compound data types](compound type.md)** (also *complex* or *structured*) which are composed of multiple primitive types. They are necessary for any advanced program. 
The first compound type is a structure, or **[struct](struct.md)**. It is a collection of several values of potentially different data types (primitive or compound). The following code shows how 
a struc can be created and used. 

&include «stdio.h» 


typedef struct 
char initial; // initial of name 
int weightKg; 
int heightCm; 

} Human; 

int bmi(Human human) 


return (human.weightKg * 10000) / (human.heightCm * human.heightCm); 
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Pt main(void) 
Human carl; 
carl.initial 1e 
carl.weightKg 100; 
carl.heightCm - 180; 


DR (bmi(carl) » 25) 
puts("Carl is fat."); 


return 0; 


The part of the code starting with nay pedet struct’ creates a new data type that .we.call :Human' (one convention for data type names is to_start them with an uppercase character). This data type 
is a structure consisting of three members, one of type char" and two of type ‘int’. Inside the ‘main’ function we create à variable ‘carl’ which is of “Human” data type. Then we set the 
specific values -- we see that each member of the struct can be accessed using the dot character (^.^), e.g. 'carl.weightKg'; this can be used just as any other variable. Then we see the type 
*Human~ being used in the parameter list of the function “bmi*, just as any other type would be used. 


What_is this gpod for? Why don't we just create global variables such as 'carl initial', ‘carl_weightkg: and 'carl heightCm'? In this simple case it might work just as well, but, in a more 
complex code this would bé burdening -- imagine we wanted to create 10 variables of type "Human ( john', ‘becky’, 'arnold , ...). We would have to painstakingly create 30 variables (3 for each 
person), the function 'bmi' would have to take two parameters (‘height and "weight') instead of one (‘human’) and if we wanted to e.g. add more information about every human (such as 
nairLengtn or we would fave to manually create another 10 variables and add one parameter to the function ^"bmi', while with a struct we only add one member to the struct definition and create 
more variables of type "Human'. 


**Structs can be nested**. So you may see things such as "myHouse.groundFloor.livingRoom.ceilingHeight' in C code. 


Another extremely important compound type is **[array](array.md)** -- a sequence of items, all of which are_of the same data type. Each array is. specified with its length (number of items) and 
the data type of the items. We can have, for instance, an array of 10 ' int s, or an array of 235 'Human's. The important thing is that we can **index** the array, i.e. we access the individual 
items of the array by their position, and this position can be specified with a variable. This allows for **looping over array items** and performing certain operations on each item. 
Demonstration code follows: 


&include «stdio.h» 
#include «math.h» // for sqrt() 


int main(void) 
float vector[5]; 


vector[0 
vector[i 
vector[2 
vector[3 1:1; 

vector[4] = -405.054; 


1; 
2:557 


; 


puts("The vector is: 


; 
for (int i - 9; i < 5; ++i) 
printf("%lf ",vector[i]); 


putchar('\n'); // newline 


£8 Compute vector length with 
pythagoren theorem: */ 


float sum - 0; 


for (int i = 0; i < 5; ++i). 
sum += vector[i] * vector[i]; 


printf("Vector length is: %lf\n",sqrt(sum)); 


return 0; 


We've included a new library called ^math.h' so that we can use a function for square root (‘sqrt’). (If you have trouble compiling the code, add ^-lm^ flag to the compile command.) 


-float vector [p]; is a declaration of an array of length 5 whose items are of type `float`. When compiler sees this, it creates a continuous area in memory long enough to store 5 numbers of 
float? type, the numbers will reside here one after another. 


After doing this, we can **index** the array with square brackets (^[^ and "P like this: ARRAY NAME INDEX] where 'ARRAY NAME' is the name of the array (here ^vector') and `INDEX` is an, 
expression that evaluates to integer, **starting with 0** and going up to thé vector length minus one (remember that **programmers count from zero**). So the first item of the array is at index 
0, the second at index 1 etc. The index can be a numeric constant like ~3°, but also a variable or a whole expression such as "x + 3 * myFunetion(): Indexed array can be used just like any 
other variable, you can assign to it, you can use it in expressions etc. This is seen in the example. Trying to access an item beyond the array's bounds (e.g. 'vector[100]^) will likely crash 
your program. 


Especially important are the parts of code staring with “for (int i = 0; i < 5; **i)': this is an iteration over the array. It's a very common pattern that we use whenever we need to perform 
some action with every item of the array. 


Arrays can also be multidimensional, but we won't bothered with that right now. 


Why are arrays so important? They allow us to work with great number of data, not just a handful of numeric variables. We can.create an array of million structs, and easily work with all of them 
thanks to indexing and loops, this would be practically impossible without arrays. Imagine e.g. a game of [chess](chess.md); it would be very silly to have 64 plain variables for each square of 
the board (squaread ^squareA2^, ..., ^squareH8/), it would be extremely difficult to work with such code. With an array we can represent the square as a single array, we can iterate over all 
the squares easily etc. 


One more thing to mention about arrays is how they can be passed to functions. A function can have as a parameter an array of fixed or unknown length. There is also one exception with arrays as 
opposed to other types: **if a function has an array as parameter and the function modifies this array, the array passed to the function (the argument) will be modified as well** (we say that 
arrays are *passed by reference* while other types are *passed by value*). We know this wasn't the case with other parameters such as "int! -- for these the function makes a local copy that 
doesn't affect the argument passed to the function. The following example shows what's been said: 


#include <stdio.h> 


// prints an int array of lengt 10 
void printArray10(int array[10]) 


for (int i = 0; i < 10; ++i) 
printf("%d ",array[i]); 


// prints an int array of arbitrary lengt 
void printArrayN(int array[], int n) 


for (int i = 0; i« n; ++i) 
printf("%d ",array[i]); 


// fills an array with numbers 0, 1, 2, 
void fillArrayN(int array[], int n) 


for (int i 


0;icn; ++i) 
array[i] i 


1; 


int main(void) 


int array10[10]; 
int array20[20 


fillArrayN(array10,10); 
fillArrayN(array20, 20 


; 


; 
BrinrArrayT0(arraáy10) E 
ni) 


putchar(' T 
printArrayN(array20, 20); 


return 0; 


e function "printArray as a fixed len array as a parameter (‘int array while '"printArrayl akes as a parameter an array. of. unknown. len int array, plus one additiona 
The f ti "printA! 10; h fixed l th t "int 10] hile "printA N) tak t f k l th ("int 3: d dditi l 
parameter to specify this length (so that the function knows how many items of the afray it should print). The function 'printArray10 ^is important because it shows w'a function can modify an 
array: when we call 'fillarrayN(array10,10);' in the "main' function, the array 'array10' will be actually modified after when the function finishes (it will be filled with numbers 0, 1, 

2, ...). This can't be done with other data types (though there is a trick involving [pointers](pointer.md) which we will learn later). 


Now let's finally talk about **text [strings](string,md)**. We've already seen strings (such as ""hello"'), we know we can print them, but what are they, really? A string is a data types and from 
C's point of view strings are nothing but **arrays of 'Char's** (text characters), i.e. sequences of ‘char s in memory. **In C every string has to end with a char ** -- this is N *9'- 
(whose [Aserr|(aseii md] value is 48) but the direct value © (remember that "char s are really just numbers). The © 'char' cannot be printed out, it is just a helper value to terminate strings. 
So to set a String T, Byron in memory we need an array of length at least 6 -- one for each character plus one for the terminating 0. These types of string are called **zero terminated 
strings or *C strings*). 


When we write a string such as ""hello"' in our source, the C compiler creates an array in memory for us and fills it with characters ^"'h'^, ^'e'^, ^'l'^, ^'l'^, ^'o'^, 0. In memory this may 
look like a sequence of numbers 104, 101, 108, 108 111, 0. 


Why do we terminate strings with 0? Because functions that work with,strings (such as “puts” or printf à don't know what length the string is. We can call, puts("abc");" or . 
püts("abcdefghijk"); -- the string passed to ‘puts’ has different length in each case, and the function doesn't know this léngth. But thanks to these strings ending with 0, the function can 
compute the length, simply by counting characters from the beginning until it finds © (or more efficiently it simply prints characters until it finds 0). 


The [syntax] (syntax md) that allows us to create strings with double quotes (^"^) is just a helper (*syntactic sugar*); we can create strings just as any other array, and we can work with them 
the same. Let's see an example: 


#include <stdio.h> 


int main(void) 
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char alphabet[27]; // 26 places for letters + 1 for temrinating 0 


for (int i= 0; i < 26; ++i) 
alphabet[i] = 'A' + i; 


alphabet[26] = 0; // terminate the string 
puts(alphabet); 


return 0; 


"alphabet; is an array of "char's, i.e. a string, Its length is 27 because we need.26 places for letters and_one extra_space_for the terminating ©. Here it's important to remind ourselves that 
we count from ©, so the alphabet can be indexed from © to 26, i.e. 26 is the last index we can use, doing 'alphabet[27]' would be an error! Next we fill the array with letters (see how we can 
treat "'char's as numbers and do ''A' + LI We iterate while `i < 26°, i.e. we will fill all the places in the array up to the index 25 (including) and leave the last place (with index 26) empty 
for the terminating 09. That we subsequently assign. And finally we print the string with ^puts(alphabet)' -- here note that there are no double quotes around 'alphabet' because its a variable 
name. Doing “puts("alphabet")~ would cause the program to literally print out '"alphabet'. Now the program outputs: 


ABCDEFGHI JKLMNOPQRSTUVWXYZ 


in Ç there is a standard library for working with strings called *string* (^£include <string.h>), it contains such function as ‘strlen’ for computing string length or 'strcmp' for comparing 
strings. 

One final example -- a creature generator -- will show all the three new data types in action: 

#include <stdio.h> 

#include <stdlib.h> // for rand() 


typedef struct 
char name [td : // 3 letter name + 1 place for 0 
int weightkg; 
int legCount; 
} Creature; // some weird creature 
Creature creatures[100]; // global array of Creatures 


void printCreature(Creature c) 


printf("Creature named %s ",c.name); // %s prints a string 
printf("(%d_ kg, ",c.weightKg); 
printf ("%d legs) An", c. légCount) ; 


int main(void) 
// generate random creatures: 
for (int i = 0; i < 100; ++i) 


Creature c; 


c.name[0] = 'A' + (rand % 26); 
c.name[1] = 'a' + (rand % 26); 
c.name[2] = 'a' + (rand % 26); 
c.name[3] = 0; // terminate the string 


.weightkg 
. LegCount 


oo 


1 * (rand % 1000); 
1 * (rand % 10); // 1 to 10 legs 


creatures[i] = c; 


J 
// print the creatures: 


for (int i = 0; i « 100; ++i 
printCreature(creatures[i]); 


return 0; 


When run you will see a list of 100 randomly generated creatures which may start e.g. as: 


Creature named Nwl (916 kg, 4 legs 
Creature named Bmq (650 kg, 2 legs 
Creature named Cda (60 kg, 4 legs) 
Creature named Owk (173 kg, 7 legs 
Creature named Hid (430 kg, 3 legs 


## Macros/Preprocessor 
The C language comes with a feature called *preprocessor* which is necessary for some advanced things. It allows automatized modification of the source code before it is compiled. 


Remember how we said that compiler compiles E programs in several steps such as generating object files and, linking? There is one more.step we didn't mention: **[preprocessin 
e ep -- 


(preprocessing.md)**. is very first s the source code you give to the compiler first goes to the preprocessor which modifies it according to special commands in He source code 


called **preprocessor directives**. The result of preprocessing is à pure C code without any more preprocessing directives, and this is handed over to the actual compilation. 
The preprocessor is like a **mini language on top of the C language**, it has its own commands and rules, but it's much more simple than C itself, for example it has no data types or loops. 
Each directive begins with ^£, is followed by the directive name and continues until the end of the line (^V? can be used to extend the directive to the next line). 


We have already encountered one preprocessor directive: the `#include` directive when we included library header files. This directive pastes a text of the file whose name it is handed to the 
place of the directive. 


Bone dipecplye i$ a define which creates so called [macro](macro.md) -- in its basic form a macro is nothing else than an alias, a nickname for some text. This is used to create constants. 
#include <stdio.h> 

#define ARRAY_SIZE 10 

int array[ARRAY_SIZE]; 

void fillArray(void) 


for (int i 


0; i < ARRAY SIZE; ++i) 
array[i] i 


i; 


void printArray(void) 
for (int i = 0; i « ARRAY SIZE; ++i) 
printf("%d ",array[i]); 
int main() 
fillarray(); 


printArray( f; 
return 0; 


`#define ARRAY SIZE 10` creates a macro that can be seen as a constant, named "ARRAY SIZE' which stands for `10`. From this line on any occurence.of `ARRAY_SIZE` that the preprocessor encounters 
in the code will be replaced with “10°. The reason for doing this is obvious -- we respect the [DRY](dry.md) (don't repeat yourself) principle, if we didn't use a constant for the array size and 
used the direct numeric value ^10" in different parts of the code, it would be difficult to change them all later, especially in a very long code, there's a danger we'd miss some. With a 
constant it is enough to change one line in the code (e.g. “#define ARRAY SIZE 10° to "define ARRAY SIZE 20°). 


The macro substitution is literally a copy-paste text replacement, there is, nothing very complex going on. This means you can create a nickname for almost anythin {for example you could do 
#define when if. and then also usé when’ in place of “if -- but it's probably not a very good Igea. By convention macro names are to be `ALL_UPPER_CASE so that whenever yoü see an all 
upper case word in the source code, you know it's a macro). 


Macros can optionally take parameters similarly to functions. There are no data types, just parameter names. The usage is demonstrated by the following code: 


#include <stdio.h> 
#define MEAN3(a,b,c) (((a) + (b) + (c)) / 3) 
int main() 

int n = MEAN3(10, 20,25); 

printf ("%d\n",n); 


return 0; 
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"MEAN3' computes the mean of 3 values. Again, it's just text replacement, so the line “int n = MEAN3(10,20,25);" becomes “int n = (((10).+ (20) + (25)) 
there so many brackets in the macro? It'S always good to put brackets over a macro and all its parameters because the parameters are again a simple tex 
“#define HALF(x) x / 2^ -- if it was invoked as "HALF(5 + 1)', the substitution would result in the final text “5 + 1 / 2°, which gives 5 (instead of t 


/ 3);` before code compilation. Why are 
t replacement; consider e.g. a macro 
he intended value 3). 


You may be askin why, would we. use a macro when we can use a function for computing. the mean? Firstly macros don't just have to work with numbers, they can be used_to generate parts.of the 
source code in ways that functions can't. Secondly using a macro may sometimes be Simpler, it's shorter and will be faster to execute because the is no function call (which has a slight 

overhead) and because the macro expansion may lead to the compiler precomputing expressions at compile time. But beware: macros are usually worse than functions and should only be used in very 
Justified cases. For example macros don't know about data types and cannot check the 


and they also result in a bigger compiled executable (function code is in the executable only once whereas 
he macro is expanded in each place where it is used and so 


m 
he code it generates multiplies). 


Another very useful directive is `#if` for conditional inclusion or exclusion of parts of the source code. It is similar to the C "if^ command. The following example shows its use: 


#include <stdio.h> 
#define RUDE 0 


void printNumber(int x) 


puts( 
#if RUDE 
"You idiot, the number is:" 
#else 
"The number is:" 


#endif 
; 


} printf ("%d\n",x); 


int main() 


printNumber (3); 
printNumber (100) ; 


#if RUDE 
puts("Bye bitch."); 
#endif 


return 0; 


When run, we get the output: 
The number is: 

3 

The number is: 

190 


And if we change `#define RUDE 0° to `#define RUDE 1°, we get: 


You idiot, the number is: 


3 

You idiot, the number is: 

100 . 

Bye bitch. 

We see the ^£if' directive has to have a,corresponding :;£endif' directive that terminates it, and there can be an optional `#else` directive for an *else* branch. The condition after `#if` can 

use similar operators as those in C itself (`°+`, “==, ^&& , |||  etc.). There also exists an £ifdef' directive which is used the same and checks if a macro of given name has been defined. 

"Hif' directives are very useful, for, conditional, compilation they allow for creation of various naettiqgs" and parameters that can fine-tune a pro ram -- you may turn specific features on and 
ability.md); compilers may automatically define specific macros depending on the platform (e.g. "WIN64', APPLE ., ...) 


off with this directive. It is also helpful for [portability](por 
based on which you can trigger different code. E.g.: 


#ifdef _WIN64 
puts("Your OS sucks."); 
#endif 


Let us talk about one more thing that doesn't fall under the preprocessor language but is related to constants: **enumerations**. Enumeration is a data type that can have values that we specify 
individually, for example: 


typedef enum 


This creates a.new data type ‘Fruit’. Variables of this type may have values 'APPLE', “PEAR” or 'TOMATO', so we may for example do “Fruit myFruit = APPLE;'. These values are in fact integers and 
the names we give them are just nicknames, so here "APPLE is equal to 0, PEAR’ to 1 and TOMATO to 2. 


## Pointers 


Pointers are an advanced topic that many people fear -- many complain they're hard to learn, others complain about memory unsafety and potential dangers of using pointers. These people are 
stupid, pointers are great. 


But beware, there may be too much new information in the first read. Don't get scared, give it some time. 


Pointers allow us to do certain advanced things such as allocate dynamic memory, return multiple values from functions, inspect content of memory or use functions in similar ways in which we use 
variables. 


A** pointer |(pointer .md)* is essentially nothing complicated: it is a **data type that can hold a memory address** (plus an information about what data type should be stored at that address). 
An address i$ simply a number. Why can't we just Use an 'int to store a memory address? Because the size of 'int' and a pointer may differ, the size of pointer depends on each platform's 
address width. Besides this, as said, a pointer actualiy holds not only an address but also the information about the type it points to, which is a safety mechanism that will become clear later. 
It is also good when the compiler knows à certain variable is supposed to point to a memory rather than to hold a generic number -- this can all prevent bugs. I.e. pointers and generic integers 
are distingüished for the same reason other data types are distinguished -- in theory they don't have to be distinguished, but it's safer. 


It is, important.to stress again that a pointer is not a pure address but it also knows about the data type it is pointing to, so there are many kinds of pointers: a pointer to 'int', a pointer 
to ‘char’, a pointer to a Specific struct type etc. 


A variable of pointer type is created similarly to a normal variable, we just add ^*^ after the data type, for example “int *x;^ creates a variable named ^x^ that is a pointer to "int' (some 
people would write this as “int* x; ). 


But how do we assign a value to the pointer? To do this, we need an address of something, e.g. of some variable. To get an address of a variable we use the “& character, i.e. '&a' is the 


address of a variable 


i.e. working with 


The last basic thing we, need to know is how to “a ldereference | (dereference md) ** a pointer. Dereferencing means accessing. the value at the address that's stọred in the pointer 
usingly) with '* c e ah EDO int’, ~*x* is the 'int' value to which the pointer is 


the pointed to valué. This is again done (maybe a bit conf aracter in front of a pointer, e.g. is a pointer to `i 
pointing. An example can perhaps make it clearer. 


#include <stdio.h> 
int main(void) 


int normalVariable = 10; 
int *pointer; 


pointer = &normalVariable; 


printf("address in pointer: %p\n", pointer); 
printf("value at this address: *&d n", *pointer); 


*pointer = *pointer + 10; 
printf("normalVariable: %d\n",normalVariable) ; 


return 0; 


This may print e.g.: 


address in pointer: Ox7fff226fe2ec 
value at this address: 
normalVariable: 20 


“int *pointer;'^ creates a pointer to 'int' with. name, ‘pointer’. Next we make the pointer point to the variable, normalVariable', i.e. we get the address of the variable with "&normalVariable^ 
and assign it normally to "pointer . Next we print firstly the address in the pointer (accessed with ‘pointer ) and the value at this address, for which we use dereference as ` *pointer At the 
next line we see that we can also use dereference for writing to the pointed address, i.e. doing '*pointer = *pointer + 10;'" here is the same as doing “normalVariable = normalVariable + 10;'. 
The last line shows that the value in ^normalVariable' has indeed changed. 


IMPORTANT NOTE: **You generally cannot read and write from/to random addresses**! This will crash your program. To be able to write to a certain address it must be *[allocated](allocation.md)*, 
i.e. reserved for use. Addresses of variables are allocated by the compiler and can be safely operated with. 


There's a special value called “NULL” (a macro defined in the standard library) that is meant to be assigned to pointer that points to "nothing". So when we have a pointer “p> that's currently 
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not supposed. to point. to anything, we do.`p = NULL;'. In a safe code we should always check (with 'if:;) whether a pointer is not “NULL” before dereferencing it, and if it is, then NOT " 
dereverence i his isn't required but is considered a "good practice" in safe code, storing “NULL” in pointers that point nowhere prevents dereferencing random or unallocated addresses which 
would crash the program. 


But what can pointers be good.for? Many things, for example we can kind of "store variables in variables", i.e. a pointer is a variable which says which variable we are now using, and we can 
switch between variable any time. E.g.: 


#include <stdio.h> 
int backAccountMonica = 1000; 


int backAccountBob = -550; 
int backAccountJose = 700; 


int *payingAccount; // pointer to who's currently paying 
void payBills(void) 
} *payingAccount -= 200; 


void buyFood(void) 
} *payingAccount -= 50; 


void buyGas(void) 


*payingAccount -= 20; 


Pt main(void) 
// let Jose pay first 
payingAccount - &backAccountJose; 


Present] ji 
buyGas( 


i 

; 

// that's enough, now let Monica pay 
payingAccount - &backAccountMonica; 


buyFood(); 
buyGas(); 

buyFoo H 
buyFood( ); 


// now it's Bob's turn 
payingAccount - &backAccountBob; 


payBilts(); 
uyFood( ); 
buyFood(); 
buyGas(); 
printf 
printf 
printf 


"Monika has $%d left.\n",backAccountMonica) ; 
"Jose has $%d left.\n",backAccountJose); 
"backAccountBob has $%d left.\n",backAccountBob); 


return 0; 


well, this, could be similarly achieved with arrays, but.pojnters have more uses. For example they allow us, to **return multiple values by a function**. Again, remember that we said that (with 
the exception of arrays) a function cannot modify à variable passed to it because it always makes its own local copy of it? We can bypass this by, instead of giving the function the value of the 
variable, giving it the address of the variable. The function can read the value of that variable (with dereference) but it can also CHANGE the value, it simply writes a new value to that 
address (again, using dereference). This example shows it: 


#include <stdio.h> 
#include <math.h> 
#define PI 3.141592 


// returns 2D coordinates of a point on a unit circle 
void getUnitCirclePoint(float angle, float *x, float *y) 


*x 
* 
y 
J 


int main(void) 


sinfangie}; 


; 
for (int i = 0; i < 8; ++i) 
float pointX, pointy; 


getUnitCirclePoint(i * 0.125 * 2 * PI,&pointX,&pointY); 
} printf("%lf %Lf\n", pointX, pointy); 


return 0; 


Function “getUnitCirclePoint: doesn't return any value in the strict sense, but thank to pointers it effectively returns. two float’ values via its parameters "x^ and `y`. These parameters are 
of the data type pointer to ‘int’ (as there's in front of them). When we call the function with ger Una tet Glerount * 9.125 * 2 * PI,&pointX,&pointY); , we hand over the addresses of the 
variables "pointX and "pointY' (which belong to the "main" function and couldn't normally be accessed in "getUnitCirclePoint'). The function can then compute values and write them to these 
addresses (with dereference, ^*x and ^*y^), changing the values in `pointX` and `pointY`, effectively returning two values. 


Now let's take a look at pointers to structs. Everything basically works the same here, but there's one thing to know about, a [syntactic sugar](sugar.md) known as an arrow (^-»^). Example: 


#include <stdio.h> 


typedef struct 


} SomeStruct; 


SomeStruct s; . 
SomeStruct *sPointer; 


Tn main(void) 
sPointer - &s; 


(*sPointer).a - 10; // without arrow 


sPointer->b = 20; // same as (*sPointer).b = 20 
printf("%d\n",s.a); 
printf("%d\n",s.b); 
return 0; 
ls 


Here we are trying to write values to a struct through pointers. Without using the arrow.we can simply, dereference the pointer with ^*', put, brackets around and access the member of the struct 
normally. This shóws the line (*sPointer).a = 10; . Using an arrow achieves the same thing but is perhaps a bit more readable, as seen in the line 'sPointer-»b = 20; . The arrow is simply a 
special shorthand and doesn't need any brackets. 


Now let's talk about arrays -- these.are,a bit special. The important, thing is that **an array is itself basically a pointer**, What does this mean? If we create an array, let's sav “int 
myArray [10]; , then "myArfay' is basically a pointer to ‘int’ in which the address of the first array item is stored. When we index the array, e.g. like "myArray[3] = 1; , behind the scenes 
there is basically a dereference because the index 3 means: 3 places after the address pointed to by JRYATTRY 7. So when we index an array, the compiler takes the address stored in ^"myArray' (the 
address of the array start) and adds 3 to it (well, kind of) by which it gets the address of the item we want to access, and then dereferences this address. 


Arrays and pointer are kind of.a duality -- we can.also use array indexing with pointers. For example if we have a pointer declared as “int *x;',. 1 
dereference (^*x ), but ALSO with indexing like this: "x[0] . Accessing index © Simply means: take the value stored in the variable and add © to'it, then dereference it. So 
thing. We can also use higher indices (e.g. `x[10]`>), BUT ONLY if ^x^ actually points to a memory that has at least 11 allocated places. 


,,We can access the value ^x^ ,peints to with a 
it achieves the same 


This, leads to a concept,called **[pointer qyithmetic] (pointer_arithmetic md) Pointer prithmetic simply means we can add or subtract numbers to BI Shading: a: If we continue with the same 
nt *x; i k 


** 
pointer as above ("i ), we Can actually add numbers to i ke "*(x + 1) = 10; . What does this mean?! It means exactly the same thing as x[1]. ding a number to a pointer shifts that 
pointer given number of *places* forward. We use the word *places* because each data type takes a different space in memory, for example 'char' takes one byte of memory while "int' takes usually 
4 (but not always), so shifting a pointer by *N* places means adding *N* times the size of the pointed to data type to the address stored in the pointer. 


This may be a lot information to digest. Let's provide an example to show all this in practice: 
#include <stdio.h> 


// our own strini print function 
void printstringte ar *s) 
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int position - 0; 
while (s[position] !- 0) 


putchar(s[position]); 


} position += 1; 
J 
// returns the length of string s 
int stringLength(char *s) 
int length - 0; 
while (*s != 0) // count until terminating 0 
length += 1; . z 2 
S += 1; // shift the pointer one character to right 


) 


return length; 


H 
int main(void) 


char testString[] - "catdog"; 


printString("The string '"); 
printString(testString); 
printString("' has length "); 


int l = stringLength(testString); 
printf("%d.",1); 


return 0; 


The output is: 
The string 'catdog' has length 6. 


We've created a function for printing strings (‘printString:) similar to ‘puts’ and a function for computing the length of a string {-stringlength ). .They both take as an argument a pointer to 
char’, i.e. a string. In 'printString we Use indexing ( t and '] ) just as if `s` was an array, and indeéd we see it works! In “stringLength we similarly iterate over all characters in the 
string but we use dereference ('*s') and pointer arithmetic (^s += ay It doesn't matter which of the two styles we choose -- here we've shown both, for educational purposes. Finally notice 
that the string we actually work with is created in ‘main’ as an array with “char testString[] = "catdog";'^ -- here we don't need to specify the array size between ~[~ and ^]' because we 
immediately assign a string literal to it (^"catdog"') and in such a case the compiler knows how big the array needs to be and automatically fills in the correct size. 


Now that know about pointers, we can finally completely explain the functions from ^'stdio' we've been using: 


- “int puts(char *s)o: A simple and fast function for printing a string (adds the newline character ^n^ at the end). 
d u 


- "int printf(char *format, ... A little bit more complex nction at can print not only strings but also other data types. It takes a variable number of parameters. The first one is always 
a string that specifies the print format -- this string can contain special sequences that will be replaced by textual representations of values we additionally provide as extra parameters after 
"format'. E.g. the sequence "Xd" is replaced with a number obtained from the value of a corresponding 'int' parameter. Similarly `%c` is for ‘char’, `%s` for strings, ~%p° for pointers. Example: 


^printf("MyInt = %d, myChar = %c, MyStr = %s\n",myInt,myChar,myStr); >. 
- "int getchar(void)': Reads a single text character from the input and returns it. Why does the function return `int`ò and not ‘char’? Because the function can return additional special values 
such as “EOF end of file) which Couldn't be stored in plain ‘char’. 


- “int scanf(char *format, ....)°: Function for reading various data types from the input. bike. pritf" it takes a.variable number of parameters. The first one is a string that specifies which, 
data type(s) to read -- this i$ a bit complicated but "Xd" reads an int , "Xf" "float , "Xc" `char` and "%s" string. The following arguments are **pointers** to expected data types, so e.g. if 
we've provided the format string "9d", a pointer to 'int' has to follow. Through this parameter the value that's been read will be returned (in the same way we've seen in one example above). 


## Files 


Now wer tt jakea 1gok at how we can read and write from/to files on the computer disk which enables us to store information permanently or potentially process data such as images or audio. Files 
aren't so difficult. 


We work with files through functions provided in the *stdio* library (so it has to be included). We distinguish two types of files: 


- **text files**: Contain text, are human readable. ead 4 
- **binary files**: Contain binary data, aren't human readable, are more efficient but also more prone to corruption. 


From programmer's point of view there's actually not a huge difference. between the two, they're both just sequences of characters or bytes fubich are kind of almost the same). Text files are a 
little more abstract, they handle potentially different format of newlines etc. The main thing for us'is that we'll use slightly different functions for each type. 


There is a special data type for file called “FILE” (we'll be using a pointer to it). Whatever file we work with, we need to firstly open it with the function '^fopen' and when we're done with 
it, we need to close it with a function 'fclose'. 


First we'll write something to a text file: 


#include <stdio.h> 
Pt main(void) 
FILE *textFile - fopen("test.txt","w"); // "w" for write 


if (textFile !- NUE // if opened successfully 
S "Y. 


printf CEexEFE LS; llo file."); 
else 
puts("ERROR: Couldn't open file."); 

fclose(textFile); 

return 0; 
ls 
When run, the program should create a new file named *test.txt* in the same directory we're in and in it you, should find the text "Hello file.'. “FILE *textFile' creates a new variable 
textFile' which is a pointer to the “FILE data type. We are using a pointer simply because the standard library is designed this way, its functions work with pointers (it can be more ; 
efficient). `fopen("test.txt","w");` attempts to open the file *test.txt* in text mode for writing -- it returns a pointer that represents the opened file. The mode, i.e. text/binary, read/write 
etc., is specified by the second argument: `"w"`; *w* simply specifies *write* and the text mode is implicit (it doesn't have to be specified) “if (textFile != NULL)' checks if the file has 
been successfully opened; the function '^fopen' returns `NULL` (the value of "point to nothing" pointers) if there was an error with opening the file (such as that the file doesn't exist). On 
success we write text to the file with a function ^"fprintf' -- it's basically the same as 'printf' but works on files, so it's first parameter is always a pointer to a file to which it should 


write. You can of course also print numbers and anything that ‘printf’ can with this function. Finally we mustn't forget to close the file at the end with '"fclose'! 


Now let's write another program that reads the file we've just created and writes its content out in the command line: 


#include <stdio.h> 
Pt main(void) 
FILE *textFile - fopen("test.txt","r"); // "r" for read 


if (textFile !- NULL) // if opened successfully 


char c; 
while (fscanf(textFile,"%c",&c) != EOF) // while not end of file 
putchar(c); 
else 
puts("ERROR: Couldn't open file."); 
fclose(textFile); 
return 0; 
F 
Notice that in 'fopen' we now specify PU (write) as a mode. Again, we check if the file has been opened successfully (‘if (textFile, != NULL) os If so, we use a ‘while’ loop to read and print 
all characters from the file until we encounter the end of file. The reading of file characters is done with the '"fscanf function inside the loop's condition -- there's nothing preventing us. 
from doing this. 'fscanf' again works the same as 'scanf' (so it can read other types than only '"char's), just on files (its first argument is the file to read from). On encountering end of file 


"fscanf^ returns a special value 'EOF^ (which is macro constant defined in the standard library). Again, we must close the file at the end with “fclose’. 


We will now write to a binary file: 


&include «stdio.h» 
int main(void) 
unsigned char image[] = // image in ppm format 
80, 54, 32, 53, 32, 53, 32, 50, 53, 53, 32, 
255,255,255, 255,255,255, 255,255,255, 255,255,255, 255,255,255, 
255, 255, 255, 0, 0, 0, 255,255,255, 0, 0, 0, 255,255,255, 
255, 255, 255, 255,255,255, 255,255,255, 255,255,255, 255, 255, 255, 
, 0, 0, 255,255,255, 255,255,255, 255,255, 255, , 0, 0, 
" 255,255,255, 0, 0, 0, 0, 0, 0, 0, O0, 0, 255,255,255 
; 
FILE *binFile - fopen("image.ppm","wb"); 


if (binFile !- NULL) // if opened successfully 
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piurite (image, 1, sizeof (image), binFile); 
else 

puts("ERROR: Couldn't open file."); 
fclose(binFile); 


return 0; 


Okay, don't get scared, this example looks complex because it is trying to.do a cool thing: it creates an image, file! When run, it should produce a file named *image.ppm* which is a tiny 5x5 
smiley face Image in {ppm} (ppm md) format. You should be able to open the image in any good viewer (I wouldn't bet on [Windows](windows.md) programs though) - The image data was made manually and 
are stored in the “image” array. We don't need to understand the data, we just know we have some data we want to write to a file. Notice how we can manually initialize the array with values 
using ^(^ and `}` brackets. We open the file for writing and in binary mode, i.e. with a mode ^""wb"', we check the success of the action and then write the whole array into the file with one 
function call. The function is name 'fwrite' and is used for writing to binary files (as opposed to fprintf' for text files). 'fwrite' takes these parameters: pointer to the data to be written 
to the file, size of one data element (in bytes), number of data elements and a pointer to the file to write to. Our data is the 'image' array and since "arrays are basically pointers", we 
provide it as the first argument. Next argument is 1 (‘unsigned char' always takes 1 byte}, „then length of our array ('sizeof' is a special operator that substitutes the size of a variable in 
ytes -- since each item in our array takes 1 byte, 'sizeof(image)' provides the number of items in the array), and the file pointer. At the end we close the file. 


And finally we'll finish with reading this binary file back: 


#include <stdio.h> 
int main(void) 
FILE *binFile = fopen("image.ppm","rb"); 
if (binFile != NULL) // if opened successfully 
unsigned char byte; 


while (fread(&byte,1,1,binFile) ) 
printf("%d ", byte); 


putchar('\n'); 


else 
puts("ERROR: Couldn't open file."); 
fclose(binFile); 


return 0; 


The file mode is now `"rb"` (read binary). For reading from binary, files we.use the '"fread; function, similarly to how.we used `fscanf` for reading from a text file. '"fread': has these 
parameters: pointer where to store the réad data (the memory must have sufficient space allocated!), size of one data item, number of items to read and the pointer to the file which to read 
from. As the first argument we pass '&byte', i.e. the address of the variable ‘byte’, next 1 (we want to read a single byte whose size in bytes is 1), 1 (we want to read one byte) and the file 
pointer. “fread’ returns the number of items read, so the "while' condition holds as long as fread' reads bytes; once we reach end of file, `freadò can no longer read anything and returns 0 
(which in C is interpreted as a false value) and the loop ends. Again, we must close the file at the end. 


## More On Functions (Recursion, Function Pointers) 
There's more to be known about functions. 
An important concept in programming is [recursion](recursion.md) -- the situation in which a function calls itself. Yes, it is possible, but some rules have to be followed. 


When a function calls itself, we have to ensure that we won't end up in infinite recursion (i.e. the. function calls itself which subsequently calls itself and so.on until infinity). This crashes 
our program. There always has to be a **terminating condition** in a recursive function, i.é. an 'if' branch that will eventually stop the function from calling itself again. 


al problems are recursive.in nature. Many things are beautifully described with recursion (e.g. 
i 


man 
[fractals](fractal.md But remember: anything a recursion can achieve can also De achiéved by iteration (loop) and vice versa. It's just that sometimes one is more elegant or more 


But what is this ted 9008 for? Recursion is actually very common in math and programming. 
computationally efficient. 


Let's see this on a typical example of the mathematical function called [factorial (factorial md). Factorial of *N* is defined as *N* x *(N - 1)* x *(N - 2)* x ... x 1. It can also be defined 
recursively as: factorial of *N* is 1 if *N* is 0, otherwise *N* times factorial of *N - 1*. Heré is some code: 


#include <stdio.h> 


unsigned int factorialRecursive(unsigned int x) 


if (x == 0) // terminating condition 
return 1; 
else 


return x * factorialRecursive(x - 1); 


unsigned int factorialIterative(unsigned int x) 
unsigned int result = 1; 
while (x > 1) 
result *= x; 
xi 
J 


return result; 


H 
int main(void) 


printf("%d %d\n", factorialRecursive(5),factoriallterative(5)); 


return 0; 
"factoriallterative: Computes the factorial by iteration. 'factorialRecursive' uses recursion -- it calls itself. The important thing is. the recursion is guaranteed to end because every time the 
function calls itself, it passes a decremented argument so at one point the function will receive 0 in which case the terminating condition ("if (x == 0) 3 will be triggered which will avoid the 


further recursive call. 


It should be mentioned that, performance-wise recursion,is almost always worse than iteration (function calls have certain overhead), so in practice it is used sparingly. But in some cases it is 
very well justified (e.g. when it makes code much simpler while creating unnoticeable performánce loss). 


Another thing to mention is, that we can have **pointers to functions**; this t n 
so called *[čallbacks](callback.md)*: imagine we are using some (eur) (gui md framework and we want to tell it what should happen when a user clicks on a Speci’ 
by giving the framework a pointer to our custom function that it wil e called by the framework whenever the button is clicked. 


is an advanced topic so we'll stay at it, just briefly. Function pointers are pretty powerful, the „allow us tQ create 
ic button’-- this is usually done 


## Dynamic Allocation (Malloc) 


Dynamic memory allocation means the possibility of reserving additional memory ( [RAM] Cram. md) ) for, our program at.run, time, whenever we need it, This is opposed to static memory allocation, i.e. 
reserving memory for use at compile time (when compiling, béfore the program runs). We've already been doing static allocation whenever we created a variable -- compiler automatically reserves 
as much memory for our variables as is needed. But what if we're writing a program but don't yet know how much memory it will need? Maybe the program will be reading a file but we don't know how 
big that Tite is going to be m how much memory should we reserve? Dynamic allocation allows us to reserve this memory with functions when the program is actually rüning and already knows how 
much of it shou e reserved. 


It must be known that dynamic allocation comes with a new kind.of bug known,as a "ab pemory teak] (memor ' leak.md)**. It happens when we reserve a memory and forget to free it after we no longer 
need it. If this happens e.g. in a loop, the program will continue to "grow", eat more and more RAM until operating system has no more to give. For this reason, as well as others such as 
simplicity, it may sometimes be better to go with only static allocation. 


Anyway, let's see how we can allocate memory if we need to. We use mostly, just two functions that are provided by the. *stdlib* library, One is ‘malloc’ which takes as. an argument size of the 
memory we want to allocate (reserve) in bytes and returns a pointer to thi$ allocated memory if successful or "NULL if the memory couldn't be allocated (which in serious programs we should 
always check). The other function is ^free' which frees the memory when we no longer need it (every allocated memory should be freed at some point) -- it takes as the only parameter a pointer to 
the memory we've previously allocated. There is also another function called 'realloc' which serves to change the size of an already allocated memory: it takes a pointer the the allocated memory 
and the new size in byte, and returns the pointer to the resized memory. 


Here is an example: 
&include «stdio.h» 
#include <stdlib.h> 
#define ALLOCATION_CHUNK 32 // by how many bytes to resize 
int main(void) 
int charsRead = 0; 
int resized = 0; // how many times we called realloc 
char *inputChars = malloc(ALLOCATION_CHUNK * sizeof(char)); 


hie (1) // read input characters 


char c - getchar(); 


charsRead++; 
if (c == '\n') 
break; 


if ((charsRead % ALLOCATION_CHUNK) == 0) 


inputChars = // we need more space, resize the array 
realloc(inputChars, (charsRead / ALLOCATION_CHUNK + 1) * ALLOCATION_CHUNK * sizeof(char)); 


resized++; 


183 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


inputChars[charsRead] = c; 


puts("The string you entered backwards:"); 
while (charsRead » 0) 


putchar(inputChars[charsRead - 1]); 
charsRead--; 


free(inputChars); // important! 


putchar('\n'); , y : , 
printf("I had to resize the input buffer %d times.",resized); 


return 0; 


This code reads characters from the input and stores them in an array "inputChars:) -- the array is dynamically resized if, more characters are needed. (We restraing, from calling the array 
inputChars' a string because we never terminate it with 0, we couldn't print it with standard functions like "puts .) At the end the entered characters are printed backwards (tO prove we really 
stored all of them), and we print out how many times we needed to resize the array. 


We define a constant (macro) "ALLOCATION CHUNK'^ that says by how many characters we'll be resizing our character buffer. I.e. at the beginning we create a character buffer of size , 
ALLOCATION CHUNK and start reading input character into it. Once it fills up we resize the buffer by another ^" ALLOCATION CHUNK^ characters and so on. We could be resizing the buffer by single 
characters but that's usually inefficient (the function “malloc” may be quite complex and take some time to execute). 


The line starting with “char *inputChars = malloc(...* creates a pointer to. 'char' -- our character buffer.-- to which we assign a chunk of memory allocated with ^"malloc'. Its size is 
ALLOCATION CHUNK * sizeof(char) . Note that for simplicity we don't check if  inputChars' is not `NULL`, i.e. whether the allocation succeeded -- but in your program you should do it :) Then we 
enter the character reading loop inside which we check if the buffer has filled up (‘if ((charsRead % AL LOCATION. CHUNK) ^). If so, we used the 'realloc' function to increase the size of the 
character buffer. The important thing is that once we exit the loop and print the characters stored in the buffer, we free the memory with '^free(inputChars);^ as we no longer need it. 


## Debugging, Optimization 


Debuggin 
ppi gging 


5 (deb g.md) means localizing and fixing [bugs](bug.md) (erro P) in your program. In practice there are always bu even in very short programs (you've probably already figured 
at ou 


uggin S 
gi (debyggi Some small and insignificant and some pretty bad ones that make your program unusable, vulnerable or even dangerous. 


There are two kinds of bugs: na P YDntactic]l(syntax md) errors** and **[semantic](semantics.md) errors**. A syntactic error is when you write something not obeying the C grammar, it's like a, typo 
or grammatical error in a norma anguage -- these errors are very easy to detéct and fix, a compiler won't be able to understand your program and will point you to the exact place where the 
error occurs. A semantic error can be müch worse -- it's a logical error in the program; the program will compile and run but the program will behave differently than intended. The program may 
crash, leak memory, give wrong results, run slowly, corrupt files etc. These errors may be hard to spot and fix, especially when they happen in rare situations. We'll be only considering 
semantic errors from now on. 


If we spot a bug, how do we fix it? The first thing is to find a way to **replicate** it, i.e. find the exact. steps we need to make with the program to make the bug appear (8:81,71] the, menu 
press keys A and B simultaneously", ...). Next we need to trace and locate which exact line or piece of code is causing the bug. This can either be done with the hélp of specialized [debuggers] 
(debugger .md such as [adb ] (gdb m) or [valgrind](valgrind.md), but there's usually a much easier way of using printing functions such as "printf'. (Still do check out the above mentioned 
ebuggers, they're very helpful. 


Let's say your program crashes and you don't know at which line, You simply put prints such as ;printf("ANn");" and pprint (BAN) i at.the beginning and end of a code you.suspect might be 
causing the crash. Then you run the program: if “A is printed but 'B' isn't, you know the crash happened somewhere between the two prints, SÓ you Shift the 'B' print a little bit up and so on 
until you find exactly after which line ^B' stops printing -- this is the line that crashes the program. IMPORTANT NOTE: the prints have to have newline (^Nn^) at the end, otherwise this method 
may not work because of output buffering. 


Of course, you may use the prints in other ways, for example to detect at which place a value of variable changes to a wrong value. ([Asserts](assert.md) are also good for keeping an eye on 
correct values of variables. ) 


What if the program. isnt exactly crashing but is giving wrong.results? Then you need to trace the program. ste by step (not exact Ly line by line, but, maybe function by function) and check which 
step has a problem in it. If for example your game AI i$ behaving stupid, you firstly check (with prints) if it correctly detects its circumstances, then you check whether it makes the correct 
decision based on the circumstances, then you check whether the pathfinding algorithm finds the correct path etc. At each step you need to know what the correct behavior should be and you try to 


find where the behavior is broken. 


Knowing how to fix a bug isn't everything, we also need to find the bugs in the first place. as iegting]ttesting md) tiis the process of trying to find bugs by simply running and using the 
program. Remember, testing can't prove there are no bugs in the program, it can only prove bugs exist. You can do testing manua Lly or automate the tests. Automated tests are very important for 
preventing so called col regressions) (repression: md ** (so the tests are called regression tests). Regression happens when during further development you break some of its already working 
features lit is very common, don't think it won't be happening to you). Regression test (which can simply be just a normal C program) simply automatically checks whether the already implemented 
Tunertons still give the same results as before (e.g. if *sin(0) = 0* etc}. These tests should be run and pass before releasing any new version of the program (or even before any commit of new 
code). 


Optimization] (optimization,md s also 
foe qulog d ERAAN? 


i ocess of improving an already working program, but here we try to make the program more efficient -- the most common goal is to make the program 
aster, sma or consume les$ [RAI ) r. 


. This can be a Very complex task, šo we'll only mention it iefly. 


The very basic thing we can do is to turn on automatic optimization with a compiler flag: `-03` for speed, '^-Os' for program size (^-02' and ~-01° are less aggressive speed optimizations). Yes, 
it's that simple, you simply add ~-03° and your program gets magically faster. Remember that **optimizations against different resources are often antagonistic**, i.e. speeding up your program 
typically makes it consume more memory and vice versa. You need to choose. Optimizing manually is a great art. Let's suppose you are optimizing for speed -- the first, most important thing is to 
locate the part of code that's slowing down you program the most, so called **[bottleneck](bottleneck.md)**. That is the code you want to make faster. Trying to optimize non-bottlenecks doesn't 
speed up your program as a whole much; imagine you optimize a part of the code that takes 1% of total execution time by 200% -- your program will only get 0.5% faster. Bottlenecks can be found 
using profating] (profiting nd) -- measuring the execution time of different parts of the program (e.g. each function). This can be done manually or with tools such a [gprof](gprof.md). Once you 
know where to optimize, you try to apply different techniques: using algorithms with better [time complexity](time_complexity.md), using [look up tables](lut.md), optimizing 


cache] (cache.md) 
behavior and so on. This is beyond the scope of this tutorial. 


## Final Program 
TODO 


## Where To Go Next 


We haven't nearly covered the whole of C, but ygu should have pretty solid basics_now. Now you just have to go and write a_lot.of C programs, that's the only way to truly master C. WARNING: Do 
not start with an ambitious project such as a 3D game. You won't make it and you'll get demotivated. Start véry simple (a Tetris clone perhaps?). 


You should definitely, learn about common [data structures] (data -strucutre.md) ([linked Tists|( Linked List.md), fbinary trees] (binary tree.md), [hash tables] (hash.md), ...) and algorithms] 
(algorithm.md) ([sorting](sorting.md), [séarching](search.md), ...). As an advanced programmér you should definitely know a bit about | fenory mánagement](mémory manágement.md). AlSo take look 
at basic plicensing](Hicense-md) - Another thing to learn is some [version control system] (vcs ma) preferably [git](git.md), because this is how we manage bigger programs and how we collaborate 
on them. To start making graphical programs you should get familiar with some library such as [S L](sdi.md). 


A great amount of experience can be gained by contributing to some existing project, collaboration really boosts your skill and knowledge of the language. This should only be done when you're at 
least intermediate. Firstly look up à nice project on some git hosting site, then take a look at the bug tracker and pick a bug or feature that's eaSy to fix or implement (low hanging fruit). 
T data hoarding.md ---------- 

& Data Hoarding 

TODO 

T data structure.md ---------- 

# Data Structure 

Data structure refers to a any specific way in which [data] (data. md) is organized in computer memory. A.specific data structure describes. such ghings as order, relationships. (interconnection, 
hierarchy, ...), formats and types] (data ype-ma) of parts of the data. [Programming](programming.md) is sometimes seen as consisting mainly of two things: design of [algorithms] (algorithm. md) 
and data structures these algorithm work with. 

As a programmer dealing with a specific problem you oftentimes have a choice of multiple data structures -- choosing the right one is essential, for performance and efficiency of your program. As 
with everything, each data structure has advantages and also its downsides; some are faster, some take less memory étc 


. For example for a searchable database of text string we can be cho sing 
between a [binary tree](binary tree.md) and a [hash table](hash table.md); hash table offers theoretically much faster search, but binary trees may be more memory efficient and offer many other 
efficient operations like range search and sorting (which hash tables can do but very inefficiently). 


## Specific Data Structures 
These are just some common ones: 


- [array](array.md) 
- [binary,tree](binary tree.md) 
- [bitfield](bitfield.md) 
- [blockchain](blockchain.md) 
- [B* tree](bp us_tree md} 
- [circular buffer](circu ar bugger md) 
- [directed acye Lac graph] (dac.md) 
- gr h (gr pnd) 
- ash table ash table.m 
l h bli d 
- [heap] (heap. md). : 
- [linked list](linked list.md) 
- [N-ary tree](nary tree.md) 
- [record] (record.md) 
- [stack](stack.md) 
- [string](string.md) 
- [tree] (tree md] 
- [queue] (queue.md) 


## See Also 


- data] (data. md) 

- [data type](data type.md) 
T de facto.md ---------- 
* De Facto 


De facto is [Latin] (latin md) for "in fact" or a Y facts", it means that something holds in practice; it is contrasted with [de jure](de jure.md) ("by law"). We use the term to say whether 
o 


something is actually true in reality as opposed "just on paper". 


naturally come opt S0 'às to keép [compatibility](compatibility.md); for example the [Markdown](md.md) format has become e de facto standard for [READMEs](readme.md) in [FOSS](foss.md 
development. Of course it happens often that de facto standards are later made into official standards. On the other hand there may be standards that are created by official standardizing 
authorities, such as the state, which however fail to gain wide adoption in practice -- these are official standards but not de facto one. TODO: example? :) 


For example in [technology] (tech. md) a so called_[de_facto standard] (de Faeroe ante neo] is something that, without it being officially formalized or forced Y law in prior, most deyetopays 
oa 


Regarding politics and societ we often talk about **de facto [freedom] (freedom.md)** vs **de jure freedom**. For example in the context of [free (as in freedom) software](free_software.md) it 
is stres$ed that software oug to bear a free [license](licensé.md) -- this is to énsure de jure freedom, i.e. legal rights to being able to use, study, modify and share such software. Howéver 
in these talks the **de facto freedom of software is often forgotten**; the legal (de jure) freedom is worth nothing if it doesn't imply real and practical (de facto) freedom to exercise the 
rights given by the license; for example if a piece of "free" (having a free license) software is extremely [bloated](bloat.md), our practical abi ity to study and modify it gets limited because 
doing so gets considerably expensive and therefore limits the number of people who can truly exercise those rights in practice. This issue of diminishii f 

addressed e.g. by the [suckless](suckless.md) movement, and of course our [LRS](lrs.md) movement. 
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ng de facto freedom o ree software is 


There is also a similar situation regarding [itee speech] ( free_speech md) : if speech is free only de iure, i.e. we can "in theory" legally speek relatively freely, BUT if then in reality we also 
CANNOT speek freely because e.g. of fear o eing [cancelted](cancel_cul üre.md), **our speech is de facto not free**. 

T deferred shading.md ---------- 

# Deferred Shading 


In computer hgraphics corape md programming deferred shading is a technique for spgeding up the rendering of (mainly) [shaded] (shadin amd) 3D graphig 


e s aphics with textures, 
materials, [nórmal ma (normal mapping.md) et It is nowadays used in many advanced 3| ngines. In principle óf couf$e the idéà may also us 2D ni 


and outside graphics. 


(i.e..g 
graphic: 
The principle is following: in normal forward.shading (non-deferred) the shading gomputation is applied immediately to any. rendered pixel (fragment) as they are r 
overlap, many of these expensively computed pixels mày be overwrittén by pixeis of other objects, So many pixels ehd up being expensively Computed bu sible. 


t invi 
computation. Deferred shading only computes shading of the pixels that will end up actually being visible -- this is achieved by **two rendering passes**: 


endered. However, as objects can 
This is of course waste 


1. At first geometry is rendered without shading, only with information that is needed for shading (for example [normals] (normal. md), material IDs, texture IDs etc.). The rendered image is 
stored in so called G-buffer which is basically an image in which every pixel stores the above mentioned shading information. 
2. The second pass applies the shading effects by applying the pixel/fragment [shader](shader.md) on each pixel of the G-buffer. 


This is especially effective when we're using very expensive/complex pixel/fragment shaders AND we have many overlapping objects. **Sometimes deferred shading may be replaced by simply ordering 
the rendered tode Sn i.e. rendering front-to-back, which may achieve practically the same speed up. In simple cases deferred shading may not even be worth it -- in [LRS](lrs.md) programs we 
may use it only rarely. 


Deferred shading also comes with complications, for example **rasterization, [anti aliasing](anti aliasing md) can't be used** because, of course, anti-aliasing in_G-buffer doesn't really make 
sense, This is Usually solved by some [screen-Space](screen space.md) antialiasing technique such as [F ](fxaa.md), but of course that may be à bit inferior. **Transparency also poses an 
issue 


democracy.md 


# Democracy 


Democracy, stands, for *rule of the people*, it is a.form of [government (government.md) that somehow lets all citizens collectively make political decisions, which is usually. implemented by 
voting but possibly also by other means. The opposite of demócracy is [àütocracy](autócracy.md) (for example [dictatorship](dictatorship.md)), the absolute rule of a single individual. Democracy 
may take different forms, e.g. direct (people directly vote on specific questions) or representative (people vote for officials who then make decisions on their behalf). 


**Democracy does NOT equal voting**, even though this simplification, is too often made. Voting doesn't im ly democracy and democracy doesn't require voting, an alternative to voting may be for 
example a {ectentaficatty] (sciente. hd) Made decision. Democracy in the wide sense doesn't even require a fs ate](state.md) or legislation -- true democracy simply means that rules and actions of 
a society are controlled by all the people and in a way that benefits all the people. Even though we are led to believe we live in democratic society, the truth is that a large scale largely 
working democracy has never been established and that nowadays most of so called democracy is just an illusion as society clearly works for the benefit of the few richest and most powerful 
people while greatly abusing everyone else, especially the poorest majority of people. **We do NOT live in true democracy**. A true democracy would be achieved by ideal models of society such as 
hose advocated by Yetue) [ànarchism](anarchism.md) or TLRS] (less. retarded) society md), however some anarchists may be avoiding the use the term democracy as that in many narrower contexts 
implies an existence of government. 


Nowadays the politics of most first world countries is based on elections and voting by people, but despite this being called democracy by the propaganda the reality is [de facto](de_facto.md) 
not a democracy but rather an Lolagarchy|(olagarchy md) that rules THROUGH (not by) the people, creating an illusion Of democracy which however lacks a real choice Yer. the [US](usa.md) two 
party system in which people can either vote for capitalists or capitalists) or pushes the voters towards a certain choice by huge propaganda, misinformation and manipulation. 


Voting may be highly ineffective and even dangerous. We have to realize that **sometimes voting is awesome, but sometimes it's an extremely awful idea**. Why? Consider the two following 
scenarios: 


- **On simple issues wisdom of the crowd work very well**, as demonstrated by the. famous experiment in, which averaging guesses of many people on.a number of beans in a jar resulted in an 

extremely precise estimate, a much more precise than any man alone could give. This is an example of when voting iš the superior solutio o making a decision. 

- **Non-experts voting on complex issues is a disaster** (which is why we mostly don't have direct democracy but rather representative one). For example when a chess] (chess md) grandmaster 
plays against thousands of people who make moves by voting, the master easily wins, as demonstrated e.g. by the Karpov vs the World (or Twitch plays Pokémon lol) experiment (later projects such 

as Kasparov vs the World had to somehow moderate and filter the move votes to give the world a chance). The reason is that the majority of weak moves voted by nón-experts outweight the few good 

votes of experts, but also ADDITIONALLY even if only expert votes are takes, the result may be inferior because different long-term plans and visions will collide with the tong term plans o 
others, which is probably the reason why e.g. Romans used to elect a single dictator in times of a crisis rather than relying on a council of experts. This is why it's a very bad idea to have 
eople vote directly e.g. on complex economic or diplomatic issues. We have to say [we] (we md) do NOT advocate for dictators (we are anarchists) -- we rather believe in implementing a 
Tüecentralized](decentrálization md), self-regulating society in which we avoid the need for àny dictators or governments. 

---------- demoscene.md ---------- 

# Demoscene 


Demoscene is a hacker] (hacking .md) fart] (art md) subculture revolving around making so called [gemos] (demo. md programs that produce rich and interesting audiovisual effects and which are 
sometimes limitéd by strict size constraints (so called [antros (antro mj): The scéne originatéd in nórthern Eur ope | (europe. md) sometime in 1980s (even though things like screen hacks existed 
long before) among groups of [crackers](cracker.md) who were adding small signature effect screens into their cracked software ike "digital graffiti"); programming of these cool effects later 
became an art of its own and Started to have their own competitions (sometimes with high financial prizes), so called *[compos] compo.md}*. at dedicated real life events called *[demoparties] 
(demoparty.md)* (which themselves evolved from *[cop parties | (copypar ty md) * real life events focused on [piracy](piracy.md)). The community is still centered mostly in the Europe (primarily 
Finland), it is underground, out of the mainstream; Yiikipediay (we ipedia.md) says that by 2010 its size was estimated to 10000 people (such people are called *demosceners*). 


Demoscene is a bittersweet topic: on one side it's awesome, full_of beautiful hacking, great ideas and minimalism, on the other side there e secretive people who don't share their source code 
(most demos are propristary](proprietary nd) ) and ugly unportable programs that exploit quirks of specific platforms -- common ones are [DOS](dos.md), [Commodore Gal (co4 md), [Amiga] (amiga.md) 
or [Windows](windows.md). These guys simply try to make the coolest visuals and smallest programs, with all good and bad that comes with it. Try to take only the good of it. 


Besides "digital graffiti" the scene is also_perhaps a bit similar to the culture of street rap, except that there's less improvisation (obviously, making a pygaram takes Long) and competition 
happens between groups rather than individuals, Nevertheless the focus is on competition, originality, style etc. But demos Should show off technological skills as the highest priority -- trying 
To "win by Von CRI (e md) than programming skills is sometimes frowned upon. Individuals within a demogroup have roles such as a [programmer](programmer.md), visual artist, music artist, 
irector, even [PR](pr.m etc. 


A demo.isn't a video, it is.a,non-[interactive](interactive.md), [real time] (regl-Sime.md) executable that produces the same output on every run.(even though categories outside of, this may also 
appear). [Viznut](viznut.md) has noted that this "static nature" of demos mày be due to the established culture in which demos are made for a single show to the audience. Demos themselves aren't 
really limited by resource constraints (well, sometimes a limit such as 4 MB is imposed), it's where the programmers can show off all they have. However compos are often organized for 
**intros**, demos whose executable size is limited (i.e. NOT the size of the source code, like in [code golfing](golf.md), but the size of the compiled binary). The main categories are 4Kib 
intros and 64Kib intros, rarely also 256Kib intros (all sizes are in [kibibytes](memory units.md)). Apparently even such categories as 256 [byte](byte.md) intro appear. Sometimes also platform 
may be specified (e.g. [Commodore 64](c64.md), [PC](pc.md) etc.). The winner of à compo is decided by voting. 


Some of the biggest demoparties are or were Assembly (Finland), The Party (Denmark), The Gathering (Norway), Kindergarden (Norway) and Revision (Germany). A guy on 
https://mlab.taik.fi/~eye/demos/ says that he has never seen à demo [femáàlé](femalé.md) programmer and that females often have free entry to demópartieS whilé men have to pay because there are 
almost no women anyway xD Some famous demogroups include Farbrausch (Germany, also created a tiny 3D shooter game [.kkrieger](kkrieger.md)), Future Crew (Finland), Pulse (international), Haujobb 
(international), Conspiracy (Hungary) and [Razor 1911](razor_1911.md) (Norway). ( Personally I liked best the name of a group that called themselves *Byterapers*. -drummyfish } There is an 
online community of demosceners at at https://www.pouet.net. 


**On technological side of demos**: great amount of hacking, exploitation of bugs and errors and usage of techniques going against "good programming practices" are made use of in making of 
demos. They're usually made in [C](c.md), [C++](cpp.md) or [assembly](assembly.md) (though some retards even make demos in [ aval (java md n, mao (Hao md) ) In intros it is extremely important 
to save space wherever possible, So things such as [procedural generation](procgen.md) and [compression](compression.md) are heavily used. Manual [assemb yl fassemb ly .md) optimization for size 
can take place. [Tracker music](tracker_music.md), [chiptune](chiptune.md), [fractals (rractal ma) and [ASCII art] {ascia_art md) are very popular. New techniques are still being discovered, 
[bytebeat](bytebeat.md). [GLSL gtstamd) shader source code that's to be embedded in the executable has to be mini 

size optimization (^-Os^), turning off bu 

compression] (executable_compression.md). 


e.g. 
ied or compressed. Compiler flags are chosen so as to minimize size, e.g. smali 
ffer security checks or turning on fast [float](float.md) operations. The final executable is also additionally compressed with [specialized executable 


## See Also 


kkrieger] rieger.md) 

LAN party](lan_party.md) 
T dependency.md ---------- 
# Dependency 


- [ur geri rieger 


Dependency is, something, your program (or similar system) depends on -- dependencies are [bad](shit,md)! Among programmers the term *dependency hell* refers to.a yery; qempon şituation of having 
to deal with the headaches of managing dependencies. Unfortunately dependencies are also unavòidable. we at least try to minimize dependencies as much as possible while keeping our program 
functioning as intended, and those we can't avoid we try to abstract (see [portability](portability.md)) in order to be able to quickly drop-in replace them with alternatives. 


Having.many dependencies_is a.sign of [bloat](bloat.md) and bad design. Unfortunately this is the reality of mainstream programming. For example at the time of writing this [Chromium] 
(chromium.md) in [Debian](debian:md) réquires (recursively) 395 packages LMAO xD And these are just runtime dependencies... 


In [software](saf tware-md) development context we usually talk about software dependencies, typicall [libraries] (library md) and other software [packages](package.md). However, there are many 
other types of dependencies we need to consider when striving for the best programs. Let us list just Some of the possible types: 


libraries](library.md 
compiler](compiler.md) supporting specific language standard 
build system](build system.md) 
GUT] (gui md) Capability | R : F i g ; ; 
(Fil opera Ang ys atem) (operating_system.md) and its services such as presence of a [window manager](file_system.md), [desktop environment](desktop_environment.md), presence of a [file system] 
ile System.md) etc. 
- [Internes i (anternet md) connection 
- [hardware] (hardware .md) E 
- sufficient [computing resources](computing_resources.md) (enough RAM, CPU frequency and cores, ...) 
- graphics card](gpu.m 
- loating point unit](fpu.md) and other [coprocessors](coprocessor.md) 
- CPU features such as special_instructions i 
- [mouse] (mouse md), [speakers](monitor.md) and other I/O devices 
- other: 
- know-how/education: Your program may require specific knowledge, e.g. knowledge of advanced math to be able to meaningfully modify the program, or nonnegligiable amount of time spent 
studying your codebase. 
- running cost: e.g. electricity, Internet connection cost 
- culture: Your program may require the culture to allow what it is presenting or dealing with. 


- [software](software.md) 


ood program will take into account all kinds of these dependencies and try to minimize them to offer freedom, stability and safety while keeping its functionality or reducing it only very 
ittle. 

Why are dependencies so bad? Because your program is for example: 

**less secure** (more [attack surface](attack_surface.md), i.e. potential for vulnerabilities which may arise in the dependencies) 
**more buggy** (more [fuck up surface fuck_up_surface.md)) 
**less [portable] (portability.md)** . f f : , ; : , 
**more expensive to maintaih](maintenance.md) (and create)** (requires someone's constant attention to just keep the dependencies up to date and keeping up with their changing API) 
**less [future proof[(future proof.md)** and **more fragile** (your program dies as soon as one of its dependencies, or any dependency of these dependencies) 

**more bloated] (bloat .md) and so probably less efficient**, i.e. slower, eating up more RAM than necessary etc. 

- Sorese under your acontrel * (in practice it's extremely difficult to modify and maintain a library you depend on even if it's [free](free_software.md), so you're typically doomed to just 
accept whatever it does 


- **more dangerous legally] (law.md) ** (reusing work of other people requires dealing with several to many different licenses with possibly wild conditions and there's always a chance of someone 
starting to make trouble such as threatening tó withdraw a license) 


## How to Avoid Them 


--------- determinism.md ---------- 
# Determinism 


*"God doesn't play dice."* --[some German dude](einstein.md) 


Deterministic system (such as a com uter program or an equation) is one which over time evolves without any involvement of [randomness](randomness.md) and probability; i.e. its current state 
along with the rules according to which it behaves unambiguously and precisely determine its following states. This means that a deterministic [algorithm](algorithm.md) will always give the same 
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result if run multiple times with the same input values. Determinism is an extremely important concept in [computer science](compsci.md) and [programming](programming.md) (and in many other 
fields of science and philosophy). 


Determinism is also a **philosophical theory** and aspect,of physics theories,-- here it signifies that our Universe is deterministic, i.e. that everything is already predetermined by the state 
of the universe and the laws of physics, i.e. that we don't have "[free will](free will.md)" (whatever it means) because our brains are just machines following laws of physics like ahy other 
matter etc. Many normies believe [quantum physics](quantum.md) disproves determinism which is however not the case, there may e.g. exist hidden variables that still make quantum physics 
deterministic -- some believe the Bell test disproved hidden variables but again this is NOT the case as it relies on statistical independence of the experimenters, determinism is already 
possible if we consider the choices of experimenters are also predetermined This is called [superdeterminism](superdeterminism.md)). [Einstein](einstein.md) and many others still believed 
determinism was the way the Universe works even after quantum physics emerged. ( This also seems correct to me. Sabine Hossenfelder is another popular physicist promoting determinism. 
-drummyfish } Anyway, this is already beyond the scope of technological determinism. 


Computers] (computer -md) are mostly deterministic by nature and design, the operate by strict rules and engineers normall UY to eliminate any random behavior as that is mostly undesirable . 
with certain exceptions mentioned below) -- randomness leads to hard to detect and hard to fix [bugs] (bug. Md), unpredictability etc. Determinism has furthermore many advantages, for example if 
we want to record a behavior of a deterministic system, it is enough if we record only the inputs to the System without the need to record its state which saves a great amount of space -- if we 
later want to replay the system s behavior we simply rerun the system with the recorded inputs and its behavior will be the same as before (this is exploited e.g. in recording gameplay demos in 
video [games](game.md) such as [Doom](doom.md)). 


Determinism can however also pose,a problem, notable HE in cryptography where we DO want true randomness e.g. when generating [seeds | (seed .md) - Determinism in this case implies an attacker 
knowing the conditions under which we generated the seed can exactly replicate the process and arrive at the Seed value that's supposed to be random and secret. For this reason some [CPUs] 
(cpu.md) come with special hardware for generating truly random numbers. 


Despite the natural determinism of computers as such, **computer programs nowadays aren't always automatically deterministic** -- if you're writing a typical interactive computer program under 
some operating system, you have to make some extra bit of effort to make it deterministic. This is because there are things such as possible difference in timings or not perfectly specified 
behavior of [floating point ](f loat md) types in your language; for example a game running on slower computer will render fewer jicanes per second](fps.md) and if it has FPS-dependent physics 
the time step of the physics engine will be longer on this computer, possibly resulting in slightly different physics behavior due to rounding errors. This means that such program run with the 
same input data will produce different results on different computers or under slightly different circumstances, i.e. it would be non-deterministic. 


Nevertheless **we almost always want our programs to be deterministic** (or at least deterministic under some. conditions, e.g. on. the specific hardware platform we gre, using). always try to make 
your programs deterministic unless you have VERY good reason not to! **It doesn't take a huge effort to achieve determinism**, it's more of just taking the right design décisions (e.g. 
Separating rendering and physics simulation), i.e. good programming leads to determinism and vice versa, determinism in your program indicates good programming. The reason why we want 
determinism is that such programs have great properties, e.g. that of easier debugging (bugs are reproducible just by knowing the exact inputs), easy and efficient recording of activity (e.g. 
demos in games), sometimes even time reversibility (like undos, but watch out -- is doesn't hold in generat!) Determinism also itself serves as a kind of a [testo test m ) if the program is 
working right -- if your program can take recorded inputs and reproduce same behavior at every run, it shows that it's written well, without things like [undefined 


(undefined behavior.md) affecting its behavior. 


ehavior] 


The, previous paragraph is here because I've talked to people who thought that determinism was, some UBER, feature that requires a lot of work and so on ("OMG Trackmania is deterministic, what a 
eati") -- this is NOT the case. It may intuitively seem so to non-programmers or beginners, but really this is not the case. Non-determinism in softwaré appears usually due to a fuck up, 
ignorance or bad design choice made by someone with a low competence. Trust me, determinism is practically always the correct way of making programs and it is NOT hard to do. -drummyfish } 


**Even if we're creating a program that somehow works with probability, we usually want to make it deterministic!** This means we don't use actual, random numbers but rather [pseudorandom] 
(pseudorandomness.md) nümber génerators that output [chaotic](chaos.md) values which simulate randomness, but which will nevertheless be exactly the same when ran multiple times with the same 
initial seed. This is again important e.g. for [debuggin (debugging ma) the system in which replicating the bug is key to fixing it. If under normal circumstances you want the program to really 
behave differently in each run, you make it so only by altering its initial random [seed](seed.md). 


In theoretical,computer science non-determinism means that a model of computation, such as a Turing machine](turing machine.md), may at certain points decide to make one of, several possible 
actions which is somehow most convenient, e.g. which will lead to finding a solution in shortest time. Or in other words it means that the model makes many computations, each in different path, 
and at the end we conveniently pick the "best" one, e.g. the fastest one. Then we may talk e.g. about how the computational strength or speed of computation differ between a deterministic and 
non-deterministic Turing machine etc. 


**Determinism does NOT guarantee [reversibility] (reversibility md)" i; .i.e. if we know a.state of a deterministic system, it may not always.be possible to say from which state it evolved, or in 
other words: a system that's deterministic may or may not be deterministic in reverse time direction. This reversibility is only possible if the rules of the system are such that no state can 
evolve from two or more different states. If this holds then it is always possible to time-reverse the system and step it backwards to its initial state. This may be useful for things such as 
[undos](undo.md) in programs. Also note that even if a system is reversible, it may be computationally very time consuming and sometimes practically impossible to reverse the system (imagine 
e.g. reversing a cryptographic [hash](hash.md) -- mathematical reversibility of such hash may be arbitrarily ensured by e.g. pairing each hash with the lowest value that produces it). 


specie coating point](float.md) deterministic?** In theory even.floating point arithmetic can of course.be completely deterministic but.there is the question of whether this holds about concrete 
specifications and implementations of floating point (e.g. in different programming languages) -- here in theory non-determinism may arise e.g. by some unspecified behavior such as roundin 
rules. In practice you can't rely on float being deterministic. The common float standard, IEEE 754, is basical deterministic, including rounding etc. (except for possible payload of [NaNs] 
(nan.md), which shouldn't matter in most cases), but this e.g. doesn't hold for floating point types in Te}(e md) ! 

l1 devuan.md ---------- 

# Devuan 


Devuan, is a [GNU (gnu, md) A [Linux] (linux md) distribution] (distro. md) that's practically ideantical to [Debian] (debian md) (it is its, [fork](fork.md but without [systemd systemd.md) as well 
as without packages that dépend on the systemd [malware](malware.md). Devuan offers a choice of several [init $ystems](init system.md), e.g. [openrc](openrc.md), [SySvinit](sysvinit.md) and 
[runit](runit.md). It was first released in 2017. 


Notice how *Devuan* rhymes less with *lesbian* than *Debian*. 


e. [bloat bloat.md) and proprietary blobs), Devuan,is still one of the best, [operating systems](os.md) for most people and it is at 
distro.m not just for avoiding systemd, but mainly for its adoption of Debian [free software free gortware md) definition that 
e 


Despite some flaws (such as being [Linux](linux.md) with all e 
E 
. respecting also [free culture] (free culture md)" It is also a nicely working [unix](unix.md) system that's easy to install and 


this time recommended by [us](us:m over most other [distros] 
requires software to be free as a whole, including its data (i. 
which is still relatively unbloated. 


{ I can recommend Devuan, I've been using it as my main OS for several years. ~drummyfish } 
TI digital.md ---------- 
& Digital 


Digital [technolog n n S 
continuous values aote: do hot confuse things such as [floating point](flo 
data by digits, e.g. in 1s and Os if they work in [binary](binary.md). 


](tech.md) is that which works with whole numbers, i.e, discrete values, as opposed to [analog] (analog md) technology which works with [real numbers](real number.md), i.e. 
at.md) with truly continuous vatues!). The name *digital* i$ related to the word *digit* as digital computers store 


Normies confuse digital with [electronic] (electronic.md) or think that digital computers can_only be eleçtronic, that digital computers can only work in [binary](binary.md) or have other weird 
assumptions whatsoéver. **This is indeed false!** An [abacus](abacus.md) is digital device. Fucking normies. 


The advantage of digital technology is its resilience to noise which prevents degradation of data and accumulation of error -- if a digital picture is copied a billion times, it will very, likely 
remain unchànged, whereas performing the same operation with analog picture would probably erase most of the information it bears due to loss of quality in each copy. Digital technology also 
makes it easy and practically possible to create fully programmable general purpose [computers](computer.md) of great complexity. 


inDigital vs analog, simple example:** imagine you draw two pictures with a pencil: one in a normal fashion on a normal paper, the other one on a grid paper, by filling specific squares black. 
The first picture is analog, i.e. it records continuous curves and position of each point of these curves can be measured down to extremely small fractions of millimetérs -- the advantage is 
that you are not limited by any grid and can draw any shape at any position on the paper. make any wild curves with very fine details, theoretically even microscopic ones. The other picture (on 
a square grid) is digital, it is composed of separate points whose position is descri ed "only. by whole numbers (*x* and *y* coordinates of the filled grid squares), the disadvantage is that you 
are limited by only eing able to fill squares on predefined positions so your picture will look blocky and limited in amount of detail it can capture (anything smaller than a single grid square 
can't be captured properly), the [resolution](resolution.md) of the grid is limited, but as we'll see, imposing this limitations has advantages. Consider e.g. the advantage of the grid paper 
image with regards to copying: if someone wants to copy your grid paper image, it will be relatively easy and he can copy it exactly, simply by falling the exact same squares you have filled -- 
small errors and noise such as imperfectly filled squares can be detected and corrected thanks to the fact_that we have limited ourselves with the grid, we know that even if some square is not 
filled perfectly, it was probably meant to be filled and we can eliminate this kind of noise in the copy. This way we can copy the grid paper image a million times and it won't change. On the 
other hand the normal, non-grid image will become distorted with every copy and in fact even the original image will become distorted by aging; even if that who is copying the image tries to 
trace it extremely precisely, small errors will appear and these errors will accumulate in further copies, and any noise that appears in the image or in the copies is a problem because we don't 
know if it really is a noise or something that was meant to be in the image. 


Of course, digital data may. become distorted too, it is just less likely and it's easier to deal with this. It for example happens that space particles (and similar physics phenomena, e.g. 
electronic interference) flip bits in computer memory, i.e. there is always a probability of some [bit](bit.md) flipping from to 1 or vice versa. We call this **data [corruption] 
corruption.md)**. This may also happen due to physical damage to digital media (e.g. scratches on the surface of cbs), imperfections in computer network transmissions (e.g. packet loss over 
wifi](wifi.md)) etc. However we can introduce further measures to prevent, detect ànd correct data corruption, e.g. Y keeping [redundant](redundancy.md) copies (2 copies of data allow 
etecting corruption, 3 copies allow even its correction), keeping [checksums](checksum.md) or [hashes](hash.md) (which allow only detection of corruption but don't take much extra space), 
employing error correcting codes etc. 


Another way in which digital data can degrade similarly to analog data is **reencoding between lossy [compressed] (compression md) formats** {in the spirit of the famous "needs more jpeg" [meme] 
(meme imd) < A typical example is digital movies: as new standard for video encoding are emerging, old movies are being reconvertéd from old formats to the new ones, however as video is quite 
heavily lossy-compressed, losses and distortion of information happens between the reencodings. fhis is best seen in videos and images circulating on the internet that are constantly being 
ripped and converted between different formats. This way it may happen that digital movies recorded nowadays may only survive into the future in very low quality, just like old analog movies 
survived until today in degraded quality. This can be prevented by storing the original data only with lossless compression and with each new emerging format create the release of the data from 
the original. 

TI digital signature.md ---------- 

& Digital Signature 


Digital signature is a,method of mathematically, (with. cryptographical (cryptography .md) algorithms) proving that, with a very high probability, a digital message or document has been produced 
by' a specific sender, i.e. it is something aka traditional signature which gives a "proof" that something has been written by a specific individual. 


It works on the basis of [asymmetric eryptography] (asymmetric cryptography, md) : _ the signature of a message is a pair of a.public key and a number (the signature) which.can only have been 
produced by the owner of the private key asSocia’ with the public Key. This signaturé is dependent on the message data itself, i.e. if the message is modified, the signature will no longer be 
valid, preventing anyone who doesn't posses the private key from modifying the message. The signature number can for example be a [hash](hash.md) of the message decoded with the private key -- 
anyone can check that the signature encoded with the public key gives the document hàsh, proving that whoever computed the signature number must have possessed the private key. 


Signatures can be computed e.g. with the [RSA](rsa.md) algorithm. 


The nice thing here, is, that cnianonymity](anonymit mg} can be kept with digital signatures**; no priyate information such as, the signer's real name is required to be revealed, only his public 
key. Someone may ask why we thén even sign documents if we don't know by whóm it is signed loi? But of course the answer is obvious: many times we don't need to know the identity of the signer, 
we just need to know that different messages have all been written by the same person, and this is what a digital signature can ensure. And of course, if we want, a public key can have a real 

identity assigned if desirable, it's just that it's not required. 

T dinosaur.md ---------- 

# Dinosaur 


In the [hacker] (hacker md) jargon *dinosaur* is a type of a big, very old, mostly non-interactive ([batch](batch.md)), possibly partly mechanical computer, usually an IBM [mainframe] 
(mainfráme.md) from 1940s and 1950s (so called Stone Age). They resided in *dinoSaur pens* (mainframe rooms). 


{ This is how I understood it from the [Jargon File](jargon_file.md). ~drummyfish } 
I1 distance.md ---------- 
# Distance 


Distance is. a measure of how far away.from each other two points. are. Most, commonly. distance.refers to physical separation in space, e.g..as in distance of planets from the Sun, but more 
generally distance can refer to any kind of parameter space and in any number of [dimensions](dimension.md), e.g. the distance of eventS in time measured in seconds (1D distance) or distance of 
two text strings as the amount of their dissimilarit Levenshtein distance](levenshtein distance.md)). Distances are extremely important in [computer science](compsci.md) and [math](math.md) 


( 
as they allow us to do such things as [clustering] (clustering. md), path searching, physics simulations, various comparisons, [sorting](sort.md) etc. 


Distance is similar/related to [length](length.md), the difference is that distance is computed between two points while length is the distance of one point from some implicit origin. 


There are many ways to define distance within given space. Most common and implicitly assumed distance is the ne LEuc Lidean distance](euclidean distance.md)** (basically the "straight line_from 
point A to point B" whose length is computed with [ Euclidean Theorem](euclidean theorem.md)), but other distancēs are possible, e.g. the [taxicab distancé](táàxicab diStance.md | ength of the 
ind of perpendicular path taxis take between points A and B in Manhattan, usually longer than straight line). Mathematically a space in which distances can be measured are called [metric 
spaces](metric_space.md), and a distance within such space can be any [function](function.md) *dist* (called a *distance* or *metric* function) that satisfies these [axioms](axiom.md): 


*dist(p,p) = 0* (distance from identical point is zero) 

Values given by *dist* are never negative. 

*dist(p,q) = dist( UN ([symmetry TSymmetry md), distance between two points is the same in both directions). 
*dist(a,c) «- dist ea ) + dist(b,c (triangle inequality) 


BONE 


## Approximations 
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Computing Euclidean distance requires multiplication and most importantly [square root](sqrt.md) which is usually a pretty. slow operation, therefore many times we look for simpler 
[approximations] (approximation.md). Note that a possible approach here mày also lead through computing the distance normally but using a fast approximation of the square root. 


Two very basic and rough approximations of Euclidean distance, both in 2D and 3D, are Sees Reena (also Manhattan) and [Cheb shey | (cneSyshev: md) distances. Taxicab distance 
o 


simply adds the absolute coordinate differences along each principal axis (*dx*, *dy* and *dz*) while Chebyshev takes the maximum of them. In [C](c.md) (for generalization to 3D just add one 
coordinate of course): 


Pt distTaxi(int x0, int yO, int xi, int y1) 


x1 > xO ? x1 - xO : xO - x1; // dx 
y1 > yO ? y1 - yO : yO - yi; // dy 


xO 
yo 


return x0 + y0; 


Pt distCheb(int x0, int yO, int x1, int y1) 


xO x1 > x0 ? x1 - x0 : xO - xi; // dx 
yo y1 > yO ? y1 - yO : yO - yi; // dy 


return x0 > yO ? x0 : y0; 


Both of these distances approximate a circle in 2D with a square or.a sphere in 3D with a 
estimate. For speed of execution (Loptimization] (optamization.nid) ) it mày also be importa 
(branch.md) (*if*) in the max function which is usually not good for performance. 


ub the difference is that taxicab is an upper estimate of the distance while Chebyshev is the lower 


cube 
nt that taxicab distance only uses the operation of addition while Chebyshev may resuit in [branching] 


more accuracy can be achieved by averaging the, space and Chebyshev distances which in 2D approximates a circle with an 8 segment polygon and in 3D approximates a sphere with 24 sided 
ce mi g: 


A bit 
[polyhedron](polyhédron.md). The integer-only [ code is following: 


Pt dist8(int x0, int yO, int x1, int y1) 


x0 x1 > x0 ? x1 - x0 : xO - x1; // dx 
yo y1 > yO ? y1 - yO : yO - yi; // dy 


return (x0 + yO + (x0 > yO ? x0 : y9)) / 2; 


{ icsengine](tpe.md). While I measured the average and maximum error of the taxi/Chebyshev average in 3D at about 16% 
al 


ang following is an approximation I came up with when working on [tinyphy 
i 


s 
nd 22% respectively, the following gave me 3% and 12% values. -drummyfish } 


Yet more accurate approximation of 3D Euclidean distance can be made with a 48 sided | [polyhedron] (polyhedron md). The principle is following: take absolute values of all three coordinate  . 
differences and order them by magnitude so that *dx >= dy >= dz >= 0*. This gets us into one of 48 possible slices of space (the other slices have the same shape, they just differ by ordering or 
signs of the coordinates but the distance in them is of Course equal). In this slice we'll approximate the distance linearly, i.e. with a [plane] (plane md). We do this by simply computing the 
distance of our point from a plane that goes through origin and whose normal is approximately {0.8728,0.4364,0.2182} (it points in the direction that goes through the middle of space slice). The 
expression for the distance from this plane simplifies to simply *0.8728 * dx + 0.4364 * dy + 0.2182 * dz*. The following is an integer-only implementation in [C](c.md) (note that the constants 
above have been converted to allow division by 1024 for possible [optimization](optimization.md) of division to a bit shift): 


int32 t dist48( 
int32 t x0, int32 t yO, int32 t zo 
int32 t x1, int32 t y1, int32 t z1) 


eee tee is EU exp dX 
1 > yO ? y1 - yO: yO - y1; 
zI > žo 2 %1 I 8 | Yo - Xil “7 di 


if (x0 < yO) // order the coordinates 
if (x0 « z0) 


if (yO « z0) 
( // x0 < yÔ < zo 

int32 t = x0; x0 = 20; 20 = t; 
else 


( // x0 < z0 < yO 
int32 t t = x0; x0 = y0; yO = t; 
t-z0; z0 = yO; yO = t; 


else 
( // 20 < x0 < yO 
int32 t t = x0; x0 = yO; yO = t; 


else 
i (yO < z0) 
if (x0 « z0) 
( // yO < x0 < zo 


int32 t t = yO; yO = z0; z0 = 
t = x0; xo = yd; yo = ti 


D 
et 


else 
ACTI EU 
ME 2_t t = y0; yO = 20; z0 = t; 


H 
H 


return (893 * x0 + 446 * yO + 223 * z0) / 1024; 


A similar approximation for 2D distance is (from a 1984 book *Problem corner*) this; *sqrt(dx^2 + gy^20 ~= 0.96 * dx + 0.4 * dy* for *dx >= dy >= 0*. The error is <= 4%. This can be optionally 
modified to use the closest power of 2 constants so that the function becomes much faster to compute, but the maximum error increases (seems to be about 11%). C code with fixed point follows 
(commented out line is the faster, less accurate version): 


ae dist2DApprox(int x0, int yO, int xi, int y1) 


x0 = x0 > x1 ? tye - 31) E {xt - 39): 
yO = yO > y1 ? (yO - y1 y1 - yO); 
if (xO < yO) 

X1 = x0; // swap 

x0 = yO; 

yO = x1; 


return (123 * x0 + 51 * yO) / 128; // max error = ~4% 
//return x0 + yO / 2; // faster, less accurate 


TODO: this https://www.flipcode.com/archives/Fast Approximate Distance Functions.shtml 
T dodleston.md ---------- 
# Dodleston Mystery 


The Dodleston m gtery regards a teacher Ken Webster who in 1984 supposedly started exchanging messages with people from the past and future, most notably. people from the 16th and 22nd century, 
via files on a [BBC micró](bbc micro.md) computer. While probably a (Ros | (hoax md) and [Creépypastà](creepypasta.md), there are some interesting unexplained details... and it's a fun story. 


The guy has written a [proprietary](proprietary.md) book about it, called *The Vertical Plane*. 


{ If the story is made up and maybe even if it isn't it may be a copyright violation to reproduce the story with all the details here so I don't know if I should, but reporting on a few facts 
probably can't hurt. Yes, this is how bad the copyrestriction laws have gotten. ~drummyfish } 


l0 dog.md ---------- 


Here is the dog! He doesn't judge you; dog [love](love.md) is unconditional. No matter who you are or what you ever did, this buddy will always love you and be your best friend «3 By this he is 
giving us a gréat lesson. 


He loves when you pet him and take him for walks, but most of all he probably enjoys to play catch :) Throw him a ball! 


Send this to anyone who's feeling down :) 
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## See Also 


watchdog] (watchdog.md) 
- [cat](cat.md) 

mouse] (mouse.md) 
T1. doom.md ---------- 
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Doom is a legendary video [game] (game md) released in 1993, perhaps the most famous video game of all_time, the game that popularized the [first person shooter](first person shooter.md) genre. 
and shocked Dy its at the time extremely advanced [3bish] (pseudo. D.md) graphics. It was màde by [Id Sor EM | software.md), most notably by [John Carmack](jóhn carmack.md) (graphics + engine 
programmer) and [John Romero](john romero.md) (tool programmer * level designer). Doom is sadly [proprietary](proprietary.md), it was originally distributed as [shareware] (shareware md) (a free 
"demo" was available for playing and sharing with the option to buy a full version). However the game engine was later (1999) released as [free (as in freedom) software](free software.md) under 
GPL] (gpl md) which gave rise to many source [ports](port.md). The assets remain non-free but a completely free alternative is offered by the [Freedoom (freedpom.md) project that has created 
rregsas dn incedo free culture md) asset replacements for the game. [Anarch](anarch.md) is an official [LRS](lrs.md) game inspired by Doom, completely in the [public domain] 

public domain.md). 


{ Great books about Doom I can recommend: *Masters of Doom* (about the development) and *Game Engine Black Book: Doom* (details about the engine internals). -drummyfish } 


Partially thanks to the free release of the engine and its relatively [suck less] (suckless md) design (lel ema) language [software rendering] sarender ing md), ...), Doom has been [ported] 
(port.md both otfictatly and unofficially, tō a great number of platforms (e.g. [Gameboy Advance] (gba. ), [PS1] playsta ion.md), even [SN (snes.md)) and has become a kind of **de facto 
standard [benchmark] (benc mark.md)** for computer platforms -- you will often hear the phrase: **"but does it run Doom?"** Porting a Doom to any platform has become kind of a [meme](meme.md), 
Someone a d even ported it to a pregnancy test (though it didn't actually run on the test, it was really just a display). ( Still [Anarchy (Bnarch md) may be even more portable than Doom :) 
-drummyfis 


The Doom engine was revolutionary and advanced (not only but especially) video game graphics by a great leap, Considering its predecessor [Wolf3D](wolf3D.md) was really primitive in comparison 
(Doom basically set the direction for future trends in games such as driving the development of more and more powerful [GPUs](gpu.md) in a race for more and more impressive visuals). Doom used a 
technique called **[BSP rendering](bsp.md)** that was able to render [realtime](realtime.md) 3D views of textured environments with distance fog and enemies and items represented by 2D 
[billboards](billboard.md) (isprites") No [Seu] C u.md) acceleration was used, graphics was rendered purely with [EPU] (cpu.md) (so called [software rendering](sw rendering.md), GPU rendering 
would come with Doom's successor uake] (quake. m 35- This had its limitations, for example the camera could not tilt up and down and the levels could not have rooms above other rooms. For this 
reason some call Doom "[pseudo 3D[(pseudo3d.md)" or 2.5D rather than "true 3D". Nevertheless, though with limitations, Doom did present 3D views and internally it did work with 3D coordinates 
(for example the player or projectiles have 2D position plus height coordinate), despite some dumb YouTube videos saying otherwise. For this reason we prefer to call Doom a **primitive 3D** 
engine, but 3D nonetheless. However Doom was not just a game with good graphics, it had extremely good gameplay, legendary music and art style and introduced the revolutionary [deathmatch] 
(deathmatch.md) multiplayer, as well as a HUGE modding and mapping community. It was a success in every way -- arguably no other game has since achieved a greater revolution than Doom. 


Doom source code is written in [C89](c.md) and is about 36000 [lines of code](loc.md) long. The original system requirements needed roughly a 30 MHz [CPU](cpu.md) and 4 MB [RAM](ram.md) as a 
minimum. It had 27 levels (9 of which were shareware), 8 weapons and 10 enemy types. 


The game only used [fixed point](fixed_point.md), no [float](float.md)! 


Doom also has a [deterministic] (determinism md) [EP] (fps md) - inde endent physics which allows for efficient recording of demos of its gameplay and creating [tool assisted Speedruns] (tas md), 
i.e. the time stép of game simulation is fixed (35 tics per gezond) Such demos can be played back in high quality while being minuscule in size and help uS in many other ways, for example for 
verifying validity of [speedruns](speedrun.md). This is very nice ànd serves as an example of a well written engine (unlike làter engines from the same creators, e.g. those of [Quake](quake.md) 
games which lacked this feature). 


LOL someone created a Doom system monitor for [Unix](unix.md) systems called [psDooM](psdoom.md) where the monsters in game are the operating system [processes](process.md) and killing the 
monsters kills the processes. 

T double buffering.md ---------- 

& Double Buffering 


In [computer graphics] (graphics md) double buffering is_a technique of rendering in which we do not draw directly to [video RAM] (vram.md), but instead to a second "back buffer", and only copy 
the rendered frame from back buffer to the video RAM ("front buffer") once the render ing has been completed; this prevents flickering and displaying of incompletely rendered frames on the 
display. Double buffering requires a significant amount of extra memory for the back buffer, however it is also necessary for how graphics is rendered today. 


here we are this is seen 
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In most libraries and frameworks today you don't have to care about double buffering it's done automatically. For this reason.in many frameworks you often need to indicate the end of rendering 
with some special command such as flip’, ‘endFrame etc. If you're going lower levél, you may need to implement double buffering yourself. 


Though we encounter the term mostly in computer graphics, the principle of using a second buffer in order to ensure the result is presented only when it's ready can be applied also elsewhere. 


Let's take a small example: say we're rendering a frame in a 3D game. First we render the environment, then on top of it we render the enemies, then effects such as explosions and then at the 
top of all this we render ine Tett (Gui cma) Without double buffering we'd Simply be rendering all these pixel into the front buffer, i.e. the memory that is immediately shown on the display. 
This would lead to the user literally seeing how first the environment appears, hen enemies àre drawn over it, then effects and then the GUI. Even if all this redrawing takes an extremely short 
time, it is also the case that the final frame will be shown for a very short time before another one will start appearing, so in the result the user will see huge flickering: the environment 
may look kind of normal but the enemies, effects and GUI May appear transparent because they are only visible for a fraction of the frame. The user also might be able to see "HE enemies that 
are supposed to be hidden behind some object if that object is rendered after the enemies. With double buffering this won't happen as we perform the rendering into the back buffer, a memory 
which doesn't show on the display. only when we have completed the frame in the back buffer, we copy it to the front buffer, pixel by pixel. Here the user may see the display changing from the 
old frame to the new one from top to the bottom, but he will never see anything temporary, and since the old and new frames are usually very similar, this top-to-bottom update may not even be 
distracting (it is addressed by [vertical synchronization](vsync.md) if we really want to get rid of it). 


There also exists [triple buffering](triple. bur fering imd which uses yet another additional buffer to increase feps](f s.md). With double buffering we can't start rendering a new frame into back 
buffer until the back buffer has been copied to the fr buffer which may further be delayed by [vertical synchronization](vsync.md), i.e. we have to wait and waste some time. With triple 
buffering we can start rendering into the other back buffer while the other one is being copied to the front buffer. Of course this Consumes significantly more memory. Also note that triple 
buffering can only be considered if the hardware supports parallel rendering and Copying of data, and if the FPS is actually limited by this... mostly you'll find your FPS bottleneck is 
elsewhere in which case it makes no sense to try to implement triple buffering. On small devices like embedded you probably shouldn't even think about this. 


Double buffering can be made more efficient by so called page flipping, i.e. allowing to switch the back and front buffer without having to physically copy the data, i.e. by simply changing the 
[pointer](pointér.md) of a display buffer. This has to be somehow supported by hardware. 


**when do we actually need double buffering? Not always, we can avoid it or suppress its memory requirements if we need to, e.g. with so called **[frameless rendering] (frameless .md)** -- we. 
may want to do this e.g. in [embedded](embédded.md) programming where we want to save every byte of RAM. The mainstream computers nowadays simply always run on a very St FPS and keep redrawin 
the screen even if the image doesn't change, but if you write a program that only occasionally changes what's on the screen (e.g. an e-book reader), you may simply leave out double buffering an 
actually render to the front buffer once the screen needs to change the user probably won't notice any flicker during a single quick frame redraw. You also don't need double buffering if you're 
able to compute the final pixel color right away, for example wit fray tracing](ray tracing.md) you don't need any double buffering, unless of course you're doing some complex [postprocessing] 
(postprocessing md) - Double buffering is only needed if we compute à pixel color but that color may still change before the frame is finished. You may also only use a partial double buffer if 
that is possible (which may not be always): you can Sat split the screen into 16 regions and render region by region, using only a 1/16th size double buffer. Using a [palette] (palette. nd) can 
also make the back buffer Smaller: if we use e.g. a 256 color palette, we only need J(fg .md). TI 

using a smaller resolution that is the actual native resolution of the screen. 

T downto.md ---------- 

# Downto Operator 


byte for every pixel of the back buffer instead of some 3 bytes for full [RGB e same goes for 


In [C](c.md) the so called "downto" operator is a [joke](jokes.md) played on nubs. It goes like this: Did you know C has a hidden downto operator ^--»'? Try it: 


#include <stdio.h> 
int main(void) 
int n = 20; 


while (n --> 10) // n goes down to 10 
printf ("%d\n",n); 


return 0; 


Indeed this compiles and works. In fact ^--»'^ is just `--` and `>` operators. 
T1 drummyfish.md ---------- 
& Drummyfish 


Drummyfish (also known as *tastyfish*, o drum" *drumy*, *smellyfish* and *i forcefeed my diarrhea to capitalism*) is a programmer [anarchopacifist](anpac md) and proponent of [free J 
software/cu ture] (rree_software md), Who started [this wiki](irs wiki.md) and invented the kind of software it focuses on: [less retarded software](lrs.md) (LRS). Besides others he has written 
fanareh | (anareh.m Jg [smatise tib] (smaL Lsd ib md), [raycastlib](raycastlib.md), [smallchesslib](smallchesslib.md), [tinyphysicsengine](tinyphysicsengine.md), [SAF](saf.md) and [comun] comun.md). 
He has also been creating free culture art and otherwise contributing to free projects such as [OpenMW](openm.md); he's been contributing with [public domain[(pd.md) art of all kind (2D, 3D, 
music, ...) and writings to [Wikipedia](wikipedia.md), [Wikimedia Commons](wm commons.md), [opengameart](oga.md), [libregamewiki](lgw.md), freesound and others. Drummyfish is crazy, suffering 
from anxiety/depression/etcetc. (diagnosed [avoidant personality disorder](avpd.md)), and has no [real life](irl.md), he is pretty retarded when it comes to leading projects or otherwise dealing 
with people or practical life. He is a [wizard](wizard.md). 


He loves all Living beings, even those whose attributes he hates or who hate him. He is a [vegetarian](vegetarianism.md) and here and there supports good causes, for example he donates hair and 
gives money to homéless people who ask for them. 


Drummyfish has a personal website at [www.tastyfish.cz](https://www.tastyfish.cz), and a gopherhole at [self.tastyfish.cz](gopher://self.tastyfish.cz). 


Drummyfish's real name is Miloslav Ciz, he was born on 24.08.1990 and lives in Moravia, Czech Republic bear th] (earth md) (he rejects the concept of a country/[nationalism](nationalism.md), the 
info here serves purely to specify a location). He is a more or less straight [male](man.md) of the [whi e](white.md) [rácé](race.md). He started programming at high school in [Pascal] 

(pascat. md); then he went on to study [compsci](compsci.md) (later focused on [compüter graphics | (graphics md)) in a Brno University of Techno logy and got a [master's degree](mSc.md), however he 
Subsequently refused to find a job in the industry, partiy because of his views (manifested by [LRS](lrs.md)) and partly because of mental health issues (depressions/anxiety/avoidant personality 
disorder). He rather chose to stay closer to the working class and do less harmful [slavery](job.md) such as cleaning and physical [spam](spam.md) distribution, and continues [hacking] 
(hacking.md) on his programming (and other) projects in his spare time in order to be able to do it with absolute freedom. 


In 2019 drummyfish has written a "manifesto" of his ideas called **Non-Competitive Society** that describes the political ideas of an ideal society. It is in the [public domain] 
(public domaih.md) under [CCO](ccO.md) and available for download online. 


{ why doxx myself? Following the [LRS](lrs.md) philosophy, I believe information should be free. [Censorship](censorship.md) -- even in the name of [privacy] (privacy md) -- goes against , 
information freedom. We shoüld live in a sociéty in which people are moral and don't abuse others by any means, including via avai tabi tity of their private information. And in order to achieve 
ideal society we have to actually live it, i.e. slowly start to behave as if it was already in place. Of course, I can't tell you literally everything (such as my passwords etc.), but the more I 
can tell you, the closer we are to the ideal society. ~drummyfish } 


He likes many things.such as animals, peace, freedom, programming, [math](math.md) and [games](game.md) (e.g. [Xonotic](xonotic.md) and [OpenArena](openarena.md), even though he despises 
[competitive (comp tition.md) behavior in real life). 

**Does drummyftsh have [divine intellect |(terry davis .md)?** Hell no, but thanks,to his extreme tendency for isolation, qrgat curiosity and obsession with truth he is possibly the only man. on 
Earth completely immune to propaganda, hé can see the world as it is, not as it is presented, so he feels it is his moral duty to share what he is seeing. He is able to overcome his natural 
dumbness and low [10] (iq.md) by tryharding and sacrificing his Social and sexual life so that he can program more. If drummyfish can learn to program [LRS](lrs.md), so can you. 

T2 dynamic programming.md ---------- 

# Dynamic Programming 


Dynamic programming is a programming technique, that can be used to make many algorithms more efficient (faster): It works on the principle of repeatedly breaking given problem down into smaller 
subproblems and thën solving one by one from the simplest and remembering already calculated results that can be reused later. 


It is usually contrasted to the *[divide and conquer](divide and conquer .md)* (DAC) technique which at the first sight looks similar but is in fact quite different. DAC also subdivides the main 
problem into subproblems, but then solves them [recursively](recursion.md), i.e. it is a top-down method. DAC also doesn't remember already solved subproblem and may end up solving the same 
problem multiple times, wasting computational time. Dynamic programming on the other hand starts solving the subproblems from the simplest ones -- i.e. it is a **bottom-up** method -- and 
remembers solutions to already solved subproblems in some kind of a [table](lut.md) which makes it possible to quickly reuse the results if such subproblem is encountered again. The order of 
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solving the subproblems should be made such as to maximize the efficiency of the algorithm. 


It's not the case that,dynamic.programming is always better than DAC, it depends, on the situation. Dynamic pro ramming is effective **when the subproblems overlap** and so the same subproblems 
WILL be encountered multiple times. But if this is not the case, DAC can easily be used and memory for the look up tables will be saved. 


## Example 


Let's firstly take a look at the case when divide and conquer is, preferable. This is for instance the case with many [gorting](Sorting md) algorithms such as [quicksort] (quicksort md). Quicksort 
recursively divides parts of the array into halves and sorts each of those parts: sorting each of these parts is a different Subproblem as these parts (at least mostly) differ in size, elements 
and their order. The subproblems therefore don't overlap and applying dynamic programming makes little sense. 


ut if we tackle a problem such as computing *N*th [Fibonacci number | (fibonacci number md), the situation changes. Considering the definition of *N*th Fibonacci number as a *"sum of N-1th and N- 
2th Fibonacci numbers"*, we might naively try to apply the divide and conquer method: 


int fib(int n) 
return (n = 0 || n = 1) ? 


n: // start the sequence with 0, 1 
fib(n - 1) + fib(n - 2); // else add two previous 


But we can see this_is painfully slow.as calling. fib(n - 2)', computes all values already computed by calling “fib(n - 1)' all over again, and this inefficiency additionally appears inside these 
functions recursively. Applying dynamic programming we get a better code: 


int fib(int n) 


if (n « 2) 
return n; 


int current - 1, prev - 0; 
for (int i = 2; i <= n; ++i) 
int tmp = current; 


current += prev; 
prev = tmp; 


return current; 


We gan see the gode is longer, but it is faster. In this case we only need to remember the previously computed Fibonacci number (in practice we may need much more memory for remembering the 
partial results). 

T earth.md ---------- 

# Earth 


Well, Earth is the planet] (planet md) we live on. It is the third planet from the [Sun](sun.md) of our Solar system which itself is part of the [Milky Way](milky way.md) [galaxy](galaxy.md). So 
far it is the only known place to have [life](life.md). 


Now behold the grand rendering of the Earth map in [ASCII](ascii_art.md) ([equirectangular](equirectangular.md) projection): 
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fl easier done than said.md ---------- 
# Easier Done Than Said 


Easier done than said is the opposite of [easier said than done](easier said than done.md). 


Example: exhaling, as saying the word "exhaling" requires exhaling plus doing some extra work such as correctly shaping your mouth. 
T easy to learn hard to master.md ---------- 
# Easy To Learn, Hard To Master 


"Easy to learn, hard,to master" (ETLHTM) is a type of design of a [game] (game md) and.by.extension a potential property of any [art](art.md) or [skill](skill.md)) which makes it relatively easy 
to learn to play while mastering the play (playing in near optimal way) rémains very difficult. 


Examples of this are games such as [tetris](tetris.md), [minesweeper](minesweeper.md) or [Trackmania](trackmania.md). 


ERS] (Urs md) sees the ETLHTM design as extremely useful and desirable as it allows for creation of [suckless](suckless.md), simple games that offer many hours of [fun](fun.md). With this 
hilósophy wé get a great amount of value for relatively little effort. 


This is related to a fun coming from **self imposed goals**, another very important and useful concept in games. Self imposed goals in games are goals the player sets for himself, for example 
completing the game without killing anyone (so called "pacifist" gameplay) or completing it very quickly (fspeedrunning](speednun ma) , Here the game serves only as a platform, a playground at 
which different games can be played and invented -- inventing games is fun in itself. Again, a game supporting self imposed goals can be relative fer ye 


y simple and o 
extremely cool. 


ars of fun, which is 


The simplicity of learning a game comes from simple rules while the difficulty of its mastering arises from the complex epergent behavior these simple rules create. Mastering of the game is many 
times encouraged by [comp vic Ton] (competition md) among different people but also competition against oneself (trying to beat own score). In many simple games such as [minesweeper 
(minesweeper.md) there exists a competitive scene (based either on direct matches or some measurement of skill such às [speedrunning](speedrun.md) or achieving high score) that drives people to 
Search for strategies and techniques that optimize the play, and to training skillful execution of such play. 


The opposite is [hard to learn, easy to master](hard to learn easy to master.md). 
## See Also 


- [easier done than said](easier_done_than_said.md) 
- [speedrun] (speedrun.md 

T1. education.md ---------- 

# Education 


*not to be confused with [indoctrination] (indoctrination.md)* 


The Elo system named after Arpad Elo, NOT an facronym) (acronym.md) ) is_a mathematical system for rating the relative strength of players of a certain game, most notably and widely used in 
[chess] (chess.m i but also elsewhere (video game tablé tennis, ...). Based on number of wins, losses and draws against other Elo rated opponents, the system computes a number (rating) for each 
player that highly [correlates](corre ation md) with that player's current strength/skill; as games are played, ratings of players are constantly being updated to reflect changes in their 
strength. The numeric rating can then be used to predict the probability of a win, loss or draw of any two players in the system, as well as e.g. for Constructing ladders of current top players 
and matchmaking players of similar strength in online games. For example if player A has an Elo rating of 1700 and player B 1400, player A is expected to win in a game with player B with the 
[probability](probability.md) of 85%. Besides Elo there exist alternative and improved systems, notably e.g. the [Glicko](glicko.md) system (which further adds e.g. confidence intervals). 


The_Elo system was created specifically for chess (even, though it.can.be applied to other games as 
called *The Rating of Chessplayers, Past and Present*, by which time it was already in use by FIDE. 
more "advanced" systems being around nowadays, Elo remains the most widely used one. 


well, it doesn't rely on any chess specific putes) and described by Arpad Elo in his 1978 book 
t replaced older rating systems, most notably the [Harkness](harkness.md) system. Despite 


**Elo rates only RELATIVE performance**, not absolute, i.e. the rating number of a player says nothing in itself, it is only the DIFFERENCE in rating points between two players that matters, so 
in an extreme case two players rated 300 and 1000 in one rating pool may in another one be rated 10300 and 11000’ (the difference of 700 is the only thing that stays the same, mean value can 
change freely). This may be influenced by initial conditions and things such as **rating inflation** for deflation) -- if for example a [chess](chess.md) website assigns some start rating to new 
users which tends to overestimate an average newcomer's abilities, newcomers will come to the site, play a few games which they will lose, then they [ragequit](ragequit.md) but they've already 
fed their points to the good players, causing the average rating of a good player to grow over time. 


**Keep in mind Elo is a big simplification of reality**, as is any attempt at capturing skill with a, single number, -- even though it is a very good predictor of something akin a "skill" and 
outcomes of games, trying to capture a "skill" with à single number is similar to e.g. trying to capture such a multidimensional thing as intelligence with a single dimensional [IQ](iq.md) 
number. For example due to many different areas of a game to be mastered and different p'aystytes [transitivity](transitivity.md) may be broken in reality: it may happen that player A mostly 
beats player B, player B mostly beats player C and player C mostly beats player A, which Elo won't capture. 


## How It Works 


Initial rating of players is not specified by Elo, each rating organization applies its own method (e.g. assign an arbitrary value of let's say 1000 or letting the player play a few unrated 
games to estimate his skill). 
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Suppose we have two players, player 1 with rating *A* and player 2 with rating *B*. In a game between them player 1 can either win, i.e. score 1 point, lose, i.e. score © points, or draw, i.e. 
Score 6.5 points. 


The expected.score *E* of a game between the two players is, computed using_a [sigmoid function](sigmoid.md) (400 is just a [magic constant](magic constant.md) that's usually used, it makes it so 
that a positive difference of 400 points makes a player 10 timeS more likély to win): 


*E 2 1 / (1 + 10^((B - A)/400))* 


For example if we set the ratings *A = 1700* and_*B = 1400*, we get a result, *E -~= 0.85*, i.e in a series of many games player 1 will get an average of about *0.85* points per game, which, can 
mean that out of 100 games he wins 85 times and loses 16 times ut it can also mean that out of 100 games he e.Q. wins 70 times and draws 30). Computing the same formula from the player 2 
Hacia gives *E -- 0.15* which makes sense as the number of points expected to gain by the players have to àdd up to 1 (the formula says in what ratio the two players split the 1 point of 
the game). 


After playing a game the ratings of the two players are adjusted depending on the actual outcome of the game. The winning player takes some amount of rating points from the loser (i.e. the loser 
loses he same amount of point the winner gains which means the total number of points in the system doesn't change as a result of games being played). The new rating of player 1, *A2*, is 
computed as: 


*A2 SACK * (R - E)* 


where *R* is the outcome of the game (for player 1, i.e. 1 for a. win, O for 
30 but may be different e.g. for new or low rated players). So with e.g. *K 
1409*, note that drawing à weaker player is below the expected result} 


Ka 


0,5 for a draw) and *K* is the change rate which affects how ickly the ratin 
i 


$s, 0 ) gu r gs will change (can be set to 
25 f for our two'players the game ends up being a draw, player takes 9 points from player (*A2 = s T. 


B: 
1691*, *B2 


## Some Code 


Here is a [C](c.md) code that simulates players of different skills playing games and being rated with Elo. Keep in mind the example is_simple, it uses the potentially imperfect `rand` function 
etc., but it Shows the principle quite well. At the beginning each player is assigned an Elo of 1000 and a random skill which is [normally distrubuted](normal distribution.md) a game between 
two players consists of each player drawing a random number in range from from 1 to his skill number, the player that draws a bigger number wins (i.e. a player with higher skill is more likely 
o win). 


&include «stdio.h» 
#include <stdlib.h> 
#include <math.h> 


#define PLAYERS 101 
#define GAMES 10000 
#define K 25 // Elo K factor 


prpedef struct 
unsigned int skill; 
unsigned int elo; 

} Player; 

Player players[PLAYERS] ; 


double eloExpectedScore(unsigned int eloi, unsigned int elo2) 
return 1.0 / (1.0 + pow(10.0,((((double) elo2) - ((double) eloi)) / 400.0))); 


int eloPointGain(double expectedResult, double result) 


return K * (result - expectedResult); 


int main(void) 
srand(100); 
for (int i = 0; i « PLAYERS; ++i) 
t players[i].elo = 1000; // give everyone inital Elo of 1000 


// normally distributed skill in range 0-99: 
players[i].skill = 0; 


for (int j = 0; j < 8; ++j) 
players il-skilu +=' rand() % 100; 


} players[i].skill /= 8; 


for (int i = 0; i < GAMES; ++i) // play games 


unsigned int playeri = rand % PLAYERS, 
player2 - rand % PLAYERS; 


// let players draw number Sr big Pr number wins., GU d 
unsigned int numberi - ran players[playeri].skill + 
number2 = Fondi 96 intaversiavers] kilt * aye 


7 
double gameResult = 0.5; 


if (numberi > number2) 
gameResult = 1.0; 

else if (number2 > number1) 
gameResult = 0.0; 


int pointGain = eloPointGain(eloExpectedScore( 
players[playeri].elo 
players[player2 eloj, gameResult); 


players[playeri].elo += pointGain; 
} players[player2].elo -= pointGain; 
for (int i = PLAYERS - 2; i >= 0; --i) // bubble-sort by Elo 
for (int j = 0; j <= i; **j 
if (players[j].elo < players[j + 1].elo) 


Player tm = prayers HH 


players[j layers[j + 1]; 


} Divers * 1] - tmp; 
for (int i = 0; i < PLAYERS; i += 5) // print 
printf("#%d: Elo: %d (skitt: %d\%)\n",i,players[i].elo,players[i].skill); 
return 0; 


The code may output e.g.: 


#0: Elo: 1134 (skill: 62% 
#5: Elo: 1117 (skill: 63% 


#10: 1102 (skill: 59% 
#15: 1082 (skill: 54% 
#20: 1069 (skill: 58% 
#25: 1054 (skill: 54% 
#30: 1039 (skill: 52% 
#35: 1026 (skill: 52% 
#40: 1017 (skill: 56% 
#45: 1016 (skill: 50% 
#50: 1006 (skill: 40% 
#55: 983 (Skill: 50% 
#60: 974 (skill: 42% 
#65: 970 (skill: 41% 
#70: 954 (skill: 44% 
#75: 947 (skill: 47% 
#80: 936 (skill: 40% 
#85: 927 (Skill: 48% 
#90: 912 (skill: 52% 
#95: i 


Elo: 896 (skill: 35% 
#100: Elo: 788 (skill: 22%) 


We can see that Elo quite nicely correlates with the player's real skill. 
T elon musk.md ---------- 
# Elon Mu$k 


Elon Musk is an enormous [capitalist](capitalism.md) dick. 
TODO 


Musk's company [Neuralink] (neuralink, md) killed 1500 animals in 4 years, was charged with animal cruelty ([sauce](https://me.mashable.com/tech/22724/elon-musks-neuralink-killed-1500-animals-in- 
four-years-now-Under-triat-for-animal-cruelty-report)). 
T1 e.md ---------- 


Euler's number (not to be confused with [Euler number](euler number .md)), Or *e*, is an extremely important and one of the most fundamental [numbers] (number md) in [mathematics] math. md) n 
approximately equal to 2.72, and is almost as famous as [pi](pi.md). It appears very often in mathematics and nature, it is the base of natural [logarithm](log.md), its digits ter the decimal 
point go on forever without showing a simple pattern (just as those of [pay pi md)" and it has many more interesting properties. 


It can be defined in several ways: 
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- Number *e* is such number for which a [runc tionCrune tion- md) *f(x) = e^x* (so called [exponential function](exp.md)) equals its own [derivative](derivative.md), i.e. *f(x) - f'(x)*. 
; Number *e* is a [limit](limit.md) of the infinite series 1/0! + 1/1! + 1/2! + 1/3! + ... (! signifies [factorial](factorial.md)). I.e. adding all these infinitely many numbers gives exactly 
e*, 


- Number *e* is a number greater than 1 for which [integral](integration.md) of function 1/x from 1 to *e* equals 1. 2 
- Number *e* is the base of natural [logarithm](log.md), i.e. it is such number *e* for which *log(e,x) = area under the function's curve from 1 to x*. 


*e* to 100 decimal digits is: 
2.7182818284590452353602874713526624977572470936999595749669676277240766303535475945713821785251664274... 
*e* to 100 binary digits is: 
10.101101111110000101010001011000101000101011101101001010100110101010111111011100010101100010000000100... 


Just as [pil (pi md), *e* isa [reat] creat md) transcendental](transcendental.md) number (it is not a root of any polynomial equation) which also means it is an [irrational](irrational.md) 
T e ii 


number ( cannot expressed as a fraction of integers). It is also not known whether *é* is a [normal](normal_number.md) number, which would means its digits would contain all possible finite 
strings, but it is conjectured to be so. 

TODO 

T1 english.md ---------- 

# English 


*"English Motherfucker, do you speak it?"* 


English is,a natural human, language spoken mainly in thẹ [USA] (usa md), UK and Australia as well as in dozens of other countries and in all parts of the world. It is the default language of the 
world. It is a pretty simple and fsue less](suckless.md) language (even though not as suckless as [Esperanto] (esperanto.md) } even a braindead person can learn it 4 Knowing Czech and léarning 
Spanish, which is considered one of the easier Languages, I Can say English is orders of magnitude simpler. -drummyfish }. is the lingua franca of the tech world and many other worldwide 

communities. Thanks to its simplicity (lack of declension, fixed word order etc.) it is pretty suitable for computer analysis and as a basis for [programming languages](programming language.md). 


If you haven't noticed, this wiki is written in English. 
T entrepreneur.md ---------- 
# Entrepreneur 


Entrepreneur is an individual, practicing legal slavery and legal theft under [capitalism] (capitatism.md ; Capitalists describe those,actions by euphemisms such as "doing [business] 
(business.md)". Successful entrepreneurs can also be Seen as murderers as they consciously firstly hoard resources that poor peon te lack (including basic resources needéd for living) and 
secondly cause and perpetuate situations such as the third world slavery where people die on a daily basis performing extreme 

can buy his ass yet another private jet. 

-- entropy.md -- 
# Entropy 


y difficult, dangerous and low paid work, so that the entrepreneur 


TODO 

## Information Entropy 

TODO 

## Physics Entropy 

TODO 

**But WHY does entropy increase in time-forward direction?** One may ask if laws on nature are time-symmetric, why is the forward direction of time special in that entropy increases in that 
direction? Just WHY is it so? Well, it is not so really, entropy simply increases in both time-forward and time-backward directions from a poane of low entropy. Such point of low entropy may be 
e.g. the [Big Bang] (big bang. md) since which entropy has been increasing in the time direction that's from the Big Bang towards us. Or the low entropy point may be a compressed gas; if we let 


such gas expànd its entropy wi increase to the future, but we may also look to the past in which the gas had high entropy before we compressed it, i.e. here entropy locally increases also 
towards the past. This is shown in the following image: 


time 
^ future 
TUS, higher entropy (gas has expanded) 
low entropy (gas is compressed) 
E ates higher entropy (we start compressing) 
Vs past 


T esolang.md ---------- 
# Esoteric Programming Language 


So called esoteric programming, Languages (esolangs) are highly experimental and [fun](fun.md rogramming languages rogramming language.md) that employ bizarre ideas. Popular languages of 
tR.S^ 18d fRetendcrBrognenmmiqe, ranguages, (gsc tange] ape igo v, exper amentad and fund ( ) [prog g Languages] (prog g. language md) R-S P guag 


There is a wiki for eso Langs the [Esolang Wiki] (https: //esolangs. or ). If you want to behold esolangs in all their beaut see 
https://esolangs.org/wiki/ ello world program in eso eric. languages. ( hóna lp abetic and A-M). The Wiki is published under Ytcád (eco. ma): 


Some notable ideas employed by esolangs are: 


Using images instead of text as [source code](source code.md) (e.g. *Piet*). 
Doing nothing (e.g. *Nothing*). 

Being two or more dimensional (e.g. *Befunge* or *Hexagony*). 
Source code resembling cooking recipes (e.g. *Chef*). 

Trying to be as hard to use as possible (e.g. *Brainfuck*). 
Trying to be as hard to compile as possible (e.g. *Befunge*). 
Adding randomness to program execution (e.g. *Entropy*). 
Having no Linput/output] (io md) (e.g. *Compute*). 

Obligation to beg the compiler to do its job (e.g. *INTERCAL*). 
Using only white characters in source code (e.g. *whitespace* 
Using only a single letter in source code (e.g. zUnary 3 
Using git repository structure as source code (e.g. *legit*). 
Source code resembling dramatic plays (e.g. *Shakespeare*, actual [real-life](real life.md) plays were performed). 
Solely focus on [golfing] ¢ olf.md), i.e. writing the shortest possible programs (e.g. *GoldScript*) 

Using [unicoce |(unicode m 3 characters (e.g. *UniCode*). 

Being infinitely many languages (e.g. *MetaGolfScript*, each one solves a specific program in © bytes). 


Esolangs are great because: 


- **They are [fungi Tun mdp - . ] " : T 
- **They are actually useful research in language design**, even if most of the ideas aren't useful directly, esolangs really teach us about the borders and definitions of what languages are. 
And sometimes, by miStake, actual discoveries are made. 


- **They are great exercise in [programming] (programming.md)** and design. Simple languages that are allowed to not be useful are potentially good for education as they let the programmer fully 
focus on a spécific idea and itS implementation. 


- **They blend technology with [art ](art.md)**, train creativity and thinking "outside the box". 
- **They are a breath of fresh air** in the sometimes too serious area of technology. Hobbyist and non-commercial programming communities are always great to have. 
## History 


INTERCAL, made in 1972 by Donald Woods and James.Lyon, is considered the first esolang.in history: its goal was specifically intended to be different from traditional languages and so for 
example a level of politeness was introduced -- if there weren't enough PLEASE labels in the source codé, the compiler wouldn't compile the program. 


In 2005 esolang wiki was started. 

## Specific Languages 

The following is a list of some notable esoteric languages. 
La LLOSX^&* ( *'**: Source code looks like gibberish. 


Brainfuc brainfuck.md)**: Extremely Simple but hard to program in, arguably the most famous esolang with many forks. 
Sn brainfork.md)**: Brainfuck with added [multithreadin J (mu lea threading md). 
e. 


* 


**[Befun eit efunge.md)**: Two dimensional language that's extremely hard to compi 
n Chef ](c ef.md)**: Source codes look like cooking recipes. 

ntropy**: Adds randomness to programs, data in variables decay. 

**FALSE**: Aims for as small compiler as possible, inspired creation of Brainfuck and other Fon mag Y 


** 


**Gravity**: Executing programs involves solving [differential equations](differential equation.md) related to gravity, which is [uncomputable](computability.md). 
**TINTERCAL](intercal.md)**: Maybe the first esolang, includes such statements as "PLEASE DO' which have to be present in order for the compilation to be successful. 
**Nothing**: Does nothing, guarantees zero bugs. 

**[Ccompute](compute.md)**: Can compute any existing problem in arbitrarily short time, but has no output so the result cannot be printed. 

bots Omgrofl omgrofl.md)**: Source code is composed of internet acronyms such as *lol*, *wtf*, *lmao* etc. 

**Pi**: Source code looks like the number [pi](pi.md), errors encode the program. 

duy Piet](piet.md)**: Source codes are images. 

**Text**: Language that always prints its source code (it is not Turing complete). All [ASCII](ascii.md) files are programs in Text. 

**Polynomial**: Programs are [polynomials](polynomial.md) whose zeros determine the commands. 

+s vnary] unary.md)**: Source code uses on M 1 character: `@`. Each program is just a sequence of zeros of different length. 

**[velato|(velato.md)**: Source codes are g IDI](midi.md) files. 

**[wWhitespace](whitespace.md)**: Source code uses only white characters (spaces, tabs and newlines) so it looks seemingly empty. 

**XENBLN**: [Golfing](golf.md) language, hello world is just `š`. 


T1 everyone does it.md ---------- 
# Everyone Does It 


"Everyone does it" is an argument quite often used by simps to justify their unjustifiable actions. It is often used alongside the "[just doing my job](just doing my job.md)" argument. 


The argument has a valid use, however it is rarely used in the valid way. We humans, as well as other higher organisms, have, evolved to mimic the behavior of others because such behavior is 
tried, others have tested such behavior for us (for example eating a certain plant that might potentially be poisonous) and have survived it, therefore it is likely also safe to do for us. So we 
have to realize that "everyone does it" is an **argument for safety, not for morality**. But peonte nowadays mostly use the argument as an excuse for their immoral behavior, i.e. something 
that's supposed to make bad things they do "not bad" because "if it was bad, others wouldn't be doing it". That's of course wrong, people do bad things and the argument "everyone does it" helps 
people do them, for example during the Nazi holocaust this excuse partially allowed some of the greatest atrocities in history. Nowadays during [capitalism](capitalism.md) it is used to excuse 
taking part unethical practices, e.g. those of corporations. 


So if you tell someone "You shouldn't do this because it's bad" and he replies "Well, everyone does it", he's really (usually) saying "I know it's bad but it's safe for me to do". 
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The effect is of course abused by politicians: once you get a certain number of people moving in a certain shared direction, others will follow just by the need to mimic others. Note that just 
creating an illusion (using the tricks of fmarketingy marketing.md)) of "everyone doing something" is enough -- that's why you see 150 year old grannies in ads using modern smartphones -- it's 
to force old people into thinking that other old people are using smartphones so they have to do it as well. 


Another potentially valid use of the argument is in the meaning of "everyone does it so I am FORCED to do it as well". For example an qmployer could argue, "I have to abuse my employees otherwise 
I'll lose the edge on the market and will be defeated by those who continue to abuse their employees". This is very true but it seems like many people don't see or intend this meaning. 
T0 evil.md ---------- 


*Evil always wins in the end.* 
---------- eXerCises.md ---------- 
# Exercises 


Here let be listed exercises for the readers of the wiki. You can allow yourself to as many helpers and resources as you find challenging: with each problem you should either find out you know 
the solution or learn something new while solving it. 


Problems in each category should follow from easiest to most difficult. The listed solutions may not be the only possible solutions, just one of them. 
## General Knowledge 

1. What is the difference between [free software](free software.md) and [open source](open source.md)? 

### Solutions 


1, The [free software] (free software.md) and [open source] (open, source md Movements are technically very similar but extremely different in spirit, i.e, while most free software licenses are 
also opén source and vice versa (with small exceptions such as [CCO](ccO.md)), free software is fundamentally about pursuing user freedom and ethics while open source is a later capitalist fork 
of free software that removes talk about ethics, aims to exploit free licenses for the benefit of business and is therefore unethical. 


## Programming 

1. Write a [C](c.md) program that prints out all [prime numbers](prime.md) under 1000 as well as the total count of these prime numbers. 
### Solutions 

1: 

// Sieve of Eratosthenes algorithm, one possible way to generate prime numbers 


&include «stdio.h» 
#define N 1000 


char primeMap[N]; 
int main(void) 
int primeCount = 0; 


for (int i = 0; i < N; ++i) 
primeMap[i] = 1; 


for (int i = 2; i < N; ++i) 
i (primeMap[i]) 
BrinEEC RR, i); 
intis i 
while (1) // mark all multiples of i non-primes 
ji; 


if (j >= N) 
break; 


primeMap[j] = 9; // can't be a prime 
J 
printf("prime count under %d: %d\n",N, primeCount); 


return 0; 


## Math 


### Solutions 
l1 f2p.md ---------- 
# Free To Pla 


Free to play (F2P) is a "[business model](business model.md)" of predatory proprietary [games](game.md) that's based on the same idea as giving children free candy so that they get into your van 
so that you can rape them. 

T1 facebook.md ---------- 

# Facebook 


"*Facebook has no users, it only has useds.*" --[rms](rms.md) 
TODO 

T1 faggot.md ---------- 

# Faggot 


Faggot is a synon 
T falla T. 


& Type A/B Fail 


Tyee A and type B fails are two very.common cases of. failing to adhere to the [LRS hoss mdp politics/philosophy by only a small margin. Most people don't.come even close to LRS politically or by 
their life ilosophy -- these are Simply general failures. Then there a few who ALMOST adhere to LRS politics and phi osophy but fail in an important point, either by being/supporting 
[pseudoleft](pseudoleft.md) (type A tail Or being/supporting [right](left right.md) (type B fail). The typical cases are following (specific cases may not fully fit these, of course): 


- natXPe A fail**: Is anticapitalist, anticonsumerist, may incline towards minimalism, supports [free software] (free_software md) and [free culture] (free culture md), may even be a vegan, 
[anarchist](anarchism.md), [C](c.md) programmer etc., however falls into the trap of supporting [pseudoleft](pSeudoleft.md), 8: LGB 1{tabt md) or [feminism](feminism.md) and things such as 
few Teron jnaueraelon (moderation.md)", [COCs](coc.md)), "just violence and bullying" (violence against fascists, e.g. tifa] a.md)), falls for memes such as "[Rust](rust.md) is the 
new [C](c.m r 

- **type B fail**: Is against.[pseudoleft](pseudoleft.md) bullshit and propaganda such as political correctness, is a [racial realist](racial realism md), ,highly supports [suckless (suckless.md) 
software, hacking and minimalism to achieve high freedom, usually also opposés [corporations](corporation.md) and staté, however falls into the trap of being a YeaseRst te scism.md), easily 
accepts violence, believes in "natural selection/wild west as a basis of society", supports and engages in [cryptocurrencies](crypto.md), believes in some form of [capitalism](capitalism.md) and 
that the current form of it can be "fixed" (["anarcho" capitalism](ancap.md) etc.) 


an anti 


Type A/B fails are the "great filter" of the rare kind of people.who show a great potential for adhering to LRS. It may be due to the modern western culture that forces a [right] (right pd) 
[pseudo left] pseudo left amd) false dichotomy that even those showing a high dégree of non-conformance eventually slip into the trap of being caught by one of the two poles. Thése two fails seem 
to be a manifestation of an individual's true motives of [self interest] self interest.md) which is culturally fueled with great force -- those individuals then try to not conform and support 
non-mainstream concepts like free culture or sucklessness, but eventually only, with the goal of self interest. It seems to be extremely difficult to abandon this goal, much more than simply non- 
conforming. Maybe it's also the subconscious knowledge that adhering completely to LRS means an extreme loneliness; being type A/B fail means being a part of a minority, but still a having a 
supportive community, not being completely alone. 


However these kinds of people may also pose a hope: if we could educate them and "fix their failure", the LRS community could grow rapidly. If realized, this Step could even be seen as the main 
contribution of LRS -- uniting the misguided rightists and pseudoleftists by pointing out errors in their philosophies (errors that may largely be intentionally forced by the system anyway 
exactly to create the hostility between the non-conforming, as a means of protecting the system). 


Z N drummyfish 
n f plu i 
normies A/B LRS 
FAIL fail 


l1 fantasy console.md ---------- 
# Fantasy Console 


Fantasy console, also fantasy computer, is a software platform intended mainly for creating and playing simple [games] (game md) which imitates_parameters, Simplicity and [look and feel 
(look ànd feel.md) of classic retro consoles such as [GameBoy](gameboy.md). These consoles are called *fantasy* because they afe not [enulators]temu lator md) of already existing hardwar 
consoles but rather "dreamed up" platforms, [virtual machines vm md) made purely. in software with artificially added restrictions that a real hardware console might have. These restrictions 
limit for example the resolution and color depth of the display, numbe 


r of buttons and sometimes also computational resources. 


The motivation behind creating fantasy consoles is normally.twofold: firstly the enjoyment of [retro|(retro.md) games and retro programming, and secondly the immense advantages of fSimplicity] 
(minimalism.md). It is much faster and easier to create a Simple game than a full fledged PC game, this attracts many programmers, Simple programming is also more enjoyable in ugs and 
headaches) and simple games have many nice properties such as small size (playability over [web](web.md)), easy embedding or enabling emulator-like features. 


Fantasy consoles usually include some kind of simple [IDE](ide.md); a typical. mainstream fantasy console both runs and is programmed in a, [web browser {browser .md) so as to be accessible to 
normies. They also use Some kind of easy scripting language for game programming, e.g. [Lua](lua.md). Even though the games are simple, thé code of su a mainstream console is normally [bloat] 
bloat.md), i.e. we are talking about * [pseudominina Lism (pseudominimalism.md)** d), are truly [suckless](suckless.md), free and highly portable 
it's not à coincidence that SAF is an official [LRS](lrs.md) project). 


Nevertheless some consoles, Such as [SAF](saf.m 
## Notable Fantasy Consoles 
The following are a few notable fantasy consoles. 


| name | license | game lang. |parameters | comment | 
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CToyl(ctoy:md) zlib](zlib.md) C](c.md) 128x128 [suckless](suckless.md) 
LIKO-12](likoi2.md)|[MrIT](mit.md) Lua] (luà.md 192x128 
PICO-8](pico8.md) propr. (proprietary me Lua] ( lua.md 128x128 4b |likely most famous 
PixelVision8 MS-PL](ms pl.md) (FOSS Lua] ( lua.md 256x240 written in C# 
Pyxel MIT](mit.md Python](python.md)|256x256 4b 
SAF](saf.md) CCO](ccO.md ci (eom 64x64 8b [LRS] (lrs.md), suckless 
TIC-80](tic80.md) MIT](mit.md Lua, JS, ... 240x136 4b |paid "pro" version 
Uxn] (uxn.md) MIT](mit.md [Tai] (tal.md) very minimal 
## See Also 


- [open console] (open_console.md) 
- [handheld] (handheld.md) 

- [virtual machine] (vm.md) 

- [IBNIZ](ibniz.md 

- [SAF](saf.md) 


*Not to be confused with [fuck](fuck.md) or [frequently questioned answers](fqa.md).* 

{ answers by ~[drummyfish](drummyfish.md) } 

### Is this a joke? Are you trolling? 

No. Jokes are [here](jokes.md). 

### What the fuck? 

See [WTF](wtf.md). 

### How does LRS differ from [suckless](suckless.md), [KISS](kiss.md), [free software](free_software.md) and similar types of software? 


Sometimes these sets may greatly overlap and LRS is at,times just a slightly different angle of looking at the same things, but in short LRS cherry-picks the best of other things and is much 
greater in scope (it focuSes on the pig picture of whole sociéty). I have invented LRS as my own take On suckless software and then expanded its scope to encompass not just technology but the 
whole society -- às I cannot speak on behalf of the whole suckless community (and sometimes disagree with them a tot), I have created my own "fork" and simply set my own definitions without 
worrying about misinterpreting, misquoting or contradicting someone else. LRS advocates very similar technology to that advocated by suckless, but it furthermore has its specific ideas and areas 
of focus. The main point is that **LRS is derived from an unconditional love of all life** rather than some shallow idea such as "[broductivity productivity cult.md)". In practice this leads to 
such things as a high stress put on [public domain] (pub Lic domain.md) and legal safety, [altruism](altruism.md), selflessness, anti-[capitalism](capitalism.md), accepting software such as 
[games] (game md) as desirable type of software, NOT subscribing to the [productivity cult] (productivity cult md), different view on [privacy](privacy.md), [cryptocurrencies] (crypto.md) etc. 
While suckless is apolitical and its scope is mostly limited to software, LRS speaks not just about technology but about the whole society -- there are two main parts of LRS: [less retarded 
software](lrs.md) and [less retarded society](less retarded society.md). 


One way to see LRS is as a philosophy that takes only the [good](good.md) out of existing phi Losophies/movements/ideologies/ete; and adds them to a single unique [idealist] (ideatism.md) mix, 
without including [cancer](cancer.md), [bullshit](bullshit.md), errors, propaganda and other negative phenomena plaguing basically all existing philosophies/movements/ideologies/etc. 


### Why this obsession with extreme simplicity? Is it because you're too stupid to understand complex stuff? 


I used to be the mainstream, complexity fmbracing pro 
I can say I have some understanding of the "complex" 
realization of its necessity comes after many years o 


grammer. I am in no way saying I'm a genius but, I've put a lot of energy into studying.computer, science full time for many years so I believe 
Stuff. I speak from owh experience and also on behalf of others who shared their experience with me that the appreciation of simplicity and 
f dealing with the complex and deep insight into the field and into the complex connections of that field to society. 


You may_ask: well then but why it's just you and a few weirdos who see this, why don't most good programmers share your opinions? Because they need to make diving or because they simply WANT to 
make a lot of money and so they do what the system wants them to do. Education in techno logy (and generally just being exposed to corporate propaganda since birth) is kind of a trap: it teaches 
you to embrace complexity and when you realize it's not a good thing, it is too late, you already need to pay your student loan, your rent, your mortgage, and the only thing they want you to do 
is to keep this complexity cult rolling. So people just do what they need to do and many of them just psychologically make themselves believe gomething they subconsciously know isn't right 
because that makes their everyday life easier to live. "Everyone does it so it can't be bad, better not even bother thinking about it too much". It's difficult doing something every day that you 
think is wrong, so you make yourself believe it's right. 


[E not that we can't understand the complex. It is that the simpler things we deal with, the more powerful things we can create out of them as the overhead of the accumulated complexity isn't 
urdening us so much. 


Sim licity is crucial not only for the quality of technology, i.e. for example its safety and efficiency, but_also for its freedom. The more complex technology becomes, the fewer people can 
control it. If technology is to serve all people, it has to be simple enough so that as many people as possible can understand it, maintain it, fix it, customize it, improve it. It's not just 
about being able to understand a complex program, it's also about how much time and energy it takes because time is a price not everyone can afford, even if they have the knowledge of 
programming. Even if you yourself_cannot program, if you are using a simple program and it breaks, you can easily find someone with a basic knowledge of programming who can fix it, unlike with a 
very complex program whose fix will require a corporation. 


Going for the simple technology doesn't necessarily have to mean we have to give up the "nice things" such as computer games or.3D graphics. Many things, such as responsiveness and = 
custömizability of programs, would improve. Even if the results won't be so Shiny, we can recreate much of what we are Used to in a much simpler way- ou may now ask: why don't companies do 
things simply if they can? Because complexity benefits them in creating de facto monopolies, as mentioned above, by reducing the number of people who can tinker with their creations. And also 
because capitalism pushes towards making things quickly rather than well -- and yes, even non commercial "FOSS" programs are pushed towards this, they still compete and imitate the commercial 
programs. Already now you can see how technology and society are intertwined in Complex ways that all need to be understood before one comes to realize the necessity of simplicity. 


### How would your ideal society work? Isn't it utopia? 
See the article on [less retarded society](less_retarded_society.md), it contains a detailed FAQ especially on that. 
### Why the name "less retarded"? If you say you're serious about this, why not a more serious name? 


I don't know, this is not so easy, to answer because I. came up with the name back when the project was smaller in scope and I didn't think about a name too hard: this name was playful, catchy, 
politically incorrect {keeping SJWs away) and had a kind of reference to *suckless*, potentially attracting attention of suckless fans. It also has the nice property of being unique, with low 
probability of name collision with some other existing project, as not many people will want to have the word "retarded" in the name. Overall the name captures the Spirit of the philosophy and 
is very general, allowing it to be applied to new areàs without being limited to certain means etc. 


Now that the project has evolved a bit the name actually seems to have been a great choice and I'm pretty happy about it, not just for the above mentioned reasons but also because it is NOT some 
generic boring name that politicians, PR people and_ other tryhárg populists woüld come up with. In à way it's rying to stimulate thought and make you think (if only by making you ask WHY anyone 
u enti 


would choose Such a name). Yes, in a way it's a small protest and showing we stay away from the rotten mainstream, t it's definitely NOT an attempt at catching a on at any cost or trying 
a 


to look like cool rebels -- such mentality goes against our basic principles. Perhaps the greatest reasons for the name is to serve as a test -- truth should prevail no matter what name it is 
given and we try to test and prove this, or rather maybe prevent succeeding for wrong reasons -- we are not interested in success (which is what mere politicians do); if our ideas are to become 
accepted, they have to be accepted for the right reasons. And if you refuse to accept truth because you don't like its name, you are retarded and by own ignorance doom yourself to live in a shit 


society with shit technology. 
### Who writes this wiki? Can I contribute. 
You can only contribute to this wiki if you're a straight [white](white.md) male. Just kidding, you can't contribute even if you're a straight white male. 


At the moment it's just me, [drummyfish](drummyfish.md). This started as a collaborative wiki name *based wiki* but after some disagreements I forked it feverything was, practically written by me 
at that point) and made it my own wiki where I don't have to make any compromises or respect anyone else's opinions. I'm not opposed to the idea of collaboration but I bet we disagree on 
something in which case I probably don't want to let you edit this. I also resist allowing contributions because with multiple authors the chance of legal complications grows, even if the work 
is under a Aet eea nis or waiver (refer to e.g. the situation where some Linux developers were threatening to withdraw their code contribution license]. But you can totally fork this wiki, it's 
public domain](ccO.md). 


If.you want.to contribute to the cause, just create your own website, spread the ideas you liked here, -- you may or may not refer to LRS everything's up to you. Start creating software with LRS 
phy osophy if you can -- together we can help evolve and spread our ideas in a decentralized way, without me or anyone else being an authority, a potential censor. That's the best way forward I 
think. 


### Why is it called a wiki when it's written just by one guy? Is it to deceive people into thinking there's a whole movement rather than just one weirdo? 
Yes. 


No, of, course not you dumbo. There is.no,intention of deception, this project started as a collaborative wiki. with multiple contributors, named. *Based Wiki*, however I (drummyfish] forked. my 
contributions (most of the original Wiki) into my own Wiki and renamed it to *Less Retarded Wiki* because I didn't like the direction of' the original wiki. At that point I was still allowing and 
looking for more contributors, but somehow none of the original people came to contribute and meanwhile I've expanded my LRS Wiki to the point at which I decided it's simply a snapshot of my own 
views ànd so I decided to keep it my own project and kept the name that I established, the *LRS Wiki*. Even though at the moment it's missing the main feature of a wiki, i.e. collaboration of 
multiple people, it is still a project that most people would likely call a "wiki" naturally (even if only a personal one) due to having all the other features of wikis (separate articles linked 
via hypertext, non-linear structure etc.) and simply looking like a wiki -- nowadays there are many wikis that are mostly written by a Single man (see e.g. small fandom wikis) and people still 
call them wikis because culturally the term has simply taken a wider meaning, people don't expect a wiki to absolutely necessarily be collaborative and so there is no deception. Additionally I 
am still open to the idea to possibly allowing contributions, so I'm simply keeping this a wiki, the wiki is in a sense waiting for a larger community to come. Finally the ideas I present here 
are not just mine but really do reflect existing movements/phi Losophies with significant numbers of supporters (suckless, free software, js 


### Since it is public domain, can I take this wiki and do anything with it? Even something you don't like, like sell it or rewrite it in a different way? 


Yes, you can do anything 
don't (you DON'T have to 
that's your original crea 


well, anything that's not otherwise illegal like falsely claiming authorship (copyright) of the original text. This is not because I care about being credited, I 
ve me any credit), but because I care about this wiki not being owned by anyone ou Can however claim copyright to anything you add to the wiki if you fork it, as 
on. 


### Why not keep politics out of this Wiki and make it purely about technology? 


Firstly for us technological progress is secondary to the primary type of progress in society: the social progress. The goal of our civilization is to provide good conditions for life -- this is 
social progress and mankind's main goal. Technological progress only serves to achieve this, so technological progress follows from the goals of social progress. So, to define technology we have 


to first know what it should help achieve in society. And for that we need to talk politics. 

Secondly. examining any existing subject in depth requires also understanding its context anyway, Politics and technology nowadays are very much intertwined and the politics of a_society 
ultimately significantly affects what its technology looks like capitalist Sw](capitalist software.md), [censorship (ensorship .mdj [bioat](bloat.md), [s yware] (Spyware md), [DRM] 

drm.md), Be what goals it serves (consumerism, Tproductivity productivity cult.md), control, war, peace, ...) and how it is developed ([COCs](cos.md f ree software 

free software.md), ...), so Studying techno logy ultimately requires understanding politics around it. I hate arguing about politics, sometimes it litera ty make me suicidal, but it is 
inevitable, we have to Specify real-life goals Clearly if we're to create good technology. Political goals guide us in making important design decisions about features, [tradeoffs](tradeoff.md) 


and other attributes of technology. 


of Course, you can fork. this wiki and try to remove politics from it, but I think it won't be possible to just keep the technology part alone so that it would still make sense, most things will 
be left without justification and explanation. 


### What is the political direction of LRS then? 


In three words basically [anarcho pacifist] anpac.md) {gommunism] (communism. md), however the word [culture](culture,md) may be more appropriate than "politics" here as we aim for removing 
traditional systems of government based on power and enforcing complex laws, there shall be no politicians in today's Sense in our society. For more details see the article about [LRS](lrs.md) 
itself. 


### Why do you blame everything on capitalism.when most of the issues you talk about, like propaganda, surveillance, exploitation of the poor and general abuse of power, appeared also under 
practically any other systems we've seen in history? 


This iş a good point, we talk about capitalism simply because it is the system of today's world and an immediate threat that needs to be addressed, however we always try to stress that the root 
issue lies deeper: it is **competition** that we see as causing all major evil. Competition between peop te is what always caused the main issues of a society, no matter whether the system at the 
time was called capitalism, feudalism or pseudosocialism. While historically competition and conflict between people was mostly forced by the nature, nowadays we've conquered technology to a 

degree at which we could practically eliminate competition, however we choose to artificially preserve it via capitalism, the glorification of competition, and we see this as an extremely wrong 
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direction, hence we put stress on opposing capitalism, i.e. artificial prolonging of competition. 


### How is this different from Wikipedia? 


In many Ways. Our wiki is better e.g. by, being more [free] (free culture md) completely l ublic domain] (public domain.md), no.[fair use] (fair use mdi [proprietary] (proprietary md) images etc.), 
less [bloated](bloat.md), better accessible, not infécted by (pseudo lertis ](psedoleft.m ) [fascism](fascism.md) and cenSorship (we only censor absolutely necessary things, e.g. Copyrighted 
things or things that would immediately put us in jail, though we still say many things that may get us in jail), we have articles that are better readable etc. 


### WTF I am offended, is this a nazi site? Are you racist/Xphobic? Do you love Hitler?!?! 


We're not fascists, we're in fact the exact opposite: our aim is to create technology that benefits everyone equally without any discrimination. I (drummyfish) am personally a pacifist 
anarchist, I love all living beings and believe in absolute social equality of all {ife forms. We invite and welcome everyone here, be it gays, communists, rightists, trannies, pedophiles or 


murderers, we love everyone equally, even you and Hitler. 


Note that, the fact that we. love someone (e.g. Hitler) does NOT mean we embrace his ideas (e.g. Nazism) or even that we e.g. like the way he looks. You may hear us say someone is a stupid ugly 
fascist, but even such individuals are living beings we love. 


What we do NOT engage in is political correctness, censorship, offended culture, identity politics and pseudoleftism. We dọ NOT support f SC. 


: d ascist groups such as feminists and LGBT and we will NOT 
practice bullying and [codes of conducts](coc.md). We do not pretend there aren't any differences between people and we will make jokes that k d 


maké you feel offended. 
### Why do you use the [nigger](nigger.md) word so much? 


To counter its censorship, we mustn't be afraid of words. The more they censor something, the more I am going to uncensor it. They have to learn that the only wey to make me not say that word so 
often is to stop censoring it, so to their action of censorship I produce a reaction they dislike. That'S baSically how you train a dog. (Please don't ask who "they" are, it's pretty obvious). 


It also has the nice side effect of making this less likely to be used by corporations and SJWs. 
### How can you say you love all living beings and use offensive language at the same time? 


The culture of being offended is foylishit] bullshit.md), it is a [pseudo leftist] (pseudo left .md) fascist) invention that serves as a weapon to justify censorship. canceling and bullying of 
people. Since I lové all people, don't support any weapons against anyone (not éven against people I dislike or disagree with). People are offended by language because théy're taught to be 
offended by it by the propaganda, I am helping them unlearn it. 


### But how can you so pretentiously preach "absolute love" and then say you hate capitalists, fascists, bloat etc.? 


OK, firstly we do NOT love *everything*, we do NOT advocate against hate itself only against hate of living beings (note we say we love *everyone*, not neverything*)- Hating other things than 
living beings, such as some bad ideas or malicious objects, is totally acceptable, theré's no problem with it. We in fact think hate of some concepts is necessary for finding better ways. 


Now when it comes to *"hating"* people, there's an important distinction to be stressed: we never, hate a living being as such, we may only hate their properties. So when we. say we. *hate*. 
someone, it's merely a matter of language convenience -- saying we *hate* someone never means we hate a person as such, but only some thing about that person, for example his Opinions, his work, 
actions, behavior or even appearance. I can hear you ask: what's the difference? The difference is we'll never try to eliminate a living being or cause it suffering because we love it, we may 
only try to change, in non-violent ways, their attributes we find wrong (which we *hate*): for example we may try to educate the person, point out errors in his arguments, give him advice, and 
if that doesn't work we may simply choose to avoid his presence. But we will never target hate against him. 


And yeah, of course sometimes we make ]iekegy (3okes md) and sarcastic comment it is relied on your ability to recognize those yourself. We see it as retarded and a great insult to intelligence 
i 


E 
to put disclaimers on jokes, that's really thé worst thing you can do to a joke. 
### So you really "love" everyone, even dicks like Trump, school shooters, instagram influencers etc.? 


Yes, but it may.need an elaboration. There are many different kinds of love: love of a sexual partner, love of a parent, love of a pet, love of a hobby, love of nature etc. Obvious Ly we can't 
love everyone with the same kind of love we have e.g. for our life partner, that's impossible if we've actually never even seen most people who live oh this planet. The love we are talking about 
-- our universal love of everyone -- is an unconditional love of life itself. Being alive is a miracle, it's beautiful, and as living beings we feel a sense of connection with all other living 
beings in this universe who were for some reason chosen to experience this rare miracle as well -- we know. what it feels like to live and we know other living beings experience this special, 
mysterious privilege too, though for a limited time. This is the most basic kind of love, an empathy, the happiness of seeing someone else live. It is sacred, there's nothing more pure in this 
universe than feeling this empathy, it works without language, without science, without explanation. While not all living beings are capable of this love (a virus probably won't feel any 
empathy), we believe all humans have this love in them, even if it's being suppressed by their environment that often forces them compete, hate, even kill. Our goal is to awaken this love in 
everyone as we believe it's the only way to achieve a truly happy coexistence of us, living beings. 


### I dislike this wiki, our teacher taught us that global variables are bad and that [OOP](oop.md) is good. 


This is not a question. you dummy, Have you even read the title of this page? Anyway, your teacher is stupid, he is, very likely unknowingly, just spreading the capitalist propaganda. He probably 
believes what he's saying but hé's wrong. 


### Lol you've got this fact wrong and you misunderstand this and this topic, you've got bugs in code, your writing sucks etc. How dare you write about things you have no clue about? 


I want a public domain encyclopedia that includes topics of new technology, and also one which.doesn't literally make me want to kill myself, due to inserted propaganda of evil etc. Since this 
supposedly [modern] (modern md) Society failed to produce even a single süch encyc lopedia and since every idiot on this planet wants to keep his copyright on everything he writes, I am forced to 
write the encyclopedia myself, even for the price of making mistakes. No, US public domain doesn't count as world wide public domain. Even without copyright there are still so called [moral 
rights](moral rights.md) etc. Blame this society for not a towing even a tiny bit of information to stip into public domain. Writing my own encyclopedia is literally the best I can do in the 
situation I am in. Nothing is perfect, I still believe this can be helpful to someone. You shouldn't take facts from a random website for granted. If you wanna help me correct errors, email me. 


### How can you use [CCO](ccO.md) if you, as anarchists, reject laws and intellectual property? 


We use it to **remove** law from our project, it's kind of like using a weapon to destroy itself. Using a fuicense] (license md) such_as [GFDL](gfdl.md) would mean we're keeping our_copyright and 
are wi lung to execute enforcement of intellectual property laws, however using a CCO [waiver](waiver.md) means we GIVE UP all’ lawful exclusive rights that have been forced on' us. This’ has no 
negative effects: if law applies, then we use it to remove itself, and if it doesn't, then nothing happens. To those that acknowledge the reality of the fact that adapting proprietary 
information can lead to being bullied by the state we give a guarantee this won't happen, and others simply don't have to care. 


A simple analogy is this: a.law is so fucked up nowadays that it forces us to point a gun at anyone by default when we create something. It's as if they literally put a gun in our hand and force 
point it at someone. We decide to drop that weapon, not merely promise to not Shoot. 


### What software does this wiki use? 

[Git](git.md), the articles are written in [markdown](md.md) and converted to [HTML](html.md) with a simple script. 
### I don't want my name associated with this, can you remove a reference to myself or my software from your wiki? 
No. 

### Are you the only one in the world who is not affected by propaganda? 

It definitely seems so. 

### How does it feel to be the only one on this planet to see the undistorted truth of reality? 

Pretty lonely and depressing. 

### Are you a crank? 

Depending on exact definition the answer is either "no" or "yes and it's a good thing". 

### Are you retarded? 


:( Maybe, but even stupid people can sometimes have smart ideas. 
TI-------- fascism.md ---------- 
* Fascism 


Fascist groups are subgroups of society: that strongly pursue [self interest (self interest md) on the detriment of others (those who are not part of said group). Fascism is a [rightist] 

(left right.md), [competitive](competition.md) tendency; fascists aim to make themselves as strong, as powerful and as rich as possible, i.e. to weaken an osSibly eliminate Sompeting groups 
to have power over them, enslave them and to Seize their resources. The means of their operation are almost exclusively [evil](evil.md), including (viotence] (violehce md), [bullying] (bu ly.md), 
[wars](war.md), [propaganda](propaganda.md), [eye for an eye](revenge.md), [slavery](slavery.md) etc. 


A few examples of fascist groups are [corporations] (corporation.md), [nations](nationalism,md), NSDAP ([Nazis](nazi.md)), [LGBT](lgbt.md), [feminists](feminism.md), [Antifa](antifa.md), [KKK] 
(kkk.md), Pwarxists](marxigm mH) and, of course, the infamous Italian fascist party of Benito Mussolini. 


Fascism is always bad and we have to aim towards eliminating it (that is eliminating fascism, NOT fascists -- fascists are people and, Living, beings to whom we wish no harm). However here comes a 
great warning: **in eliminating fascism be extremely careful to not become a fascist yourself**. We purposefully do NOT advice to *[fight]( agnt_culture. md) fascism as fight implies violence, 
the tool of fascism. **Elimination of fascism has to be done in a [non-violent](nonviolence.md) way**. Sadly, generation after generation keeps repeating the same mistake over and over: they 
keep opposing fascism by fascist means, eventuall taking the oppressors place and becoming the new oppressor, only to again be dethroned by the new generation. This has happened e.g. with 
[feminism] (feminism.md) and other [pseudo lertist ]{ pseudo eft snd) movements. This is an endless cycle of stupidity but, more importantly, endless suffering of people. This cycle needs to be 
ended. We must choose not the easy way of violence, but the difficult way of non-violent rejection which includes loving the enemy as we [love](love.md) ourselves. Fascism is all about loving 
one's own group while hating the enemy groups -- if we can achieve loving all groups of people, even fascists themselves, fascism will have been by definition eliminated. 


**[Fear](fear culture.md) is the fuel of fascism**. when fear of an individual reaches certain level -- which is different for everyone -- he turns to fascism. Even that who is normally anti 
fascist has a breaking point, under extreme pressure of fear one starts to seek purely selfish goals. This is why e.g. [capitalism capitalism.md) fuels [fear culture](fear_culture.md): it makes 
people fascists which is a prerequisite for becoming a capitalist. When "leaders" of nations need to lead [war](war.md), they start spreading propaganda of fear so as to turn people into 
fascists that easily become soldiers. This is why [education](education.md) is important in eliminating fascism: it is important to e.g. show that we need not be afraid of people of other 
cultures, of sharing information and resources etc. The bullshit of fear propaganda has to be exposed. 

T fascist.md ---------- 

# Fascist 


See [fascism](fascism.md). 
T feminism.md ---------- 
# Feminism 


*This article is a part of series of articles on [fascism](fascism.md).* 


Feminism As,g,Lfescistl(fascism md) [terrorist] (terrorism .md) [pseudoleftist] (pseudo left md movement aiming for the establishing female as the superior gender, for social revenge on men and 
aining political power, e.g. that over [langu gel (political rrectness.md). Similarly to EBT] (Tgbt md), feminism is violent, [eoxic |(toxic md) and [harmful](harmful.md), baséd on 
férainwashing] (brainwashing md), mass hysteria, [bullying](bullying.md) (e.g. the [metoo](metoo.md) campaign) and [propaganda] (propaganda.md). 


If anything's clear, then that feminism is not at all about gender equality but about hatred towards men, Firstly feminism is not called ogendes equality movement* but *feminism*, i,e. for- 
female, and as we know, [name plays a huge role](name_is_important.md). To a feminist man is what a [jew](jew.md) was to the Nazi; the whole story is repeated again, we have yet again not 
learned a bit from our history. Indeed, women have historically been oppressed and needed support, but once women reach social equality -- which has basically already happened a tong time ago 
now -- feminist movement will, if only by [social inertia](social_inertia.md), keep pursuing more advantages for women (what else should a movement called *feminism* do?) i.e. at this point the 
new goal has already become female superiority. In the age of capital no one is going to just dissolve a movement because it has already reached iti goal such a movement preseng political 

u 


capital one will simply not throw out of window, so feminists will forever keep saying they're being oppressed and will forever keep inventing new lshit issues to keep fighting] 
(fight culture.md). Note for example that feminists care about things such as wage gap but of course absolutely don't give a damn about opposite direction inequality, such as men yin on 
average much younger than women etc. -- feminism cares about women, not equality. And of course, when men establish "men rights" movements, suddenly feminists see those as "fascist", "toxic" and 


"violent" and try to destroy such movements. 


Part of the success, of feminism is also [capitalism] (capitalism md) -- women with priviledges, e.g. those of not having to work as much as men, are not accepted under capitalism; everyone has to 
be exploited as much as posszb le: everyone has to bé a work slave. Therefore capitalist própagandà promotes ideas such as "women not having to work is Sppression by men and something a woman 
should be ashamed of", which is of course laughable, but with enough brainwashing anything can be established, even the most ridiculous and obvious bullshit. 


194 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


Apparently in Korea feminists already practice segregation, they, separate parking spots for men and women so as to prevent women bumping into men or meeting a man late at night because allegedly 
men are more aggressive and dangerous. Now this iš pretty ridiculous, this is exactly the same as if they separated e.g. parking lots for black and white péople because black people are 
statistically more often involved in crime, you wouldn't want to meet them at night. So, do we still want to pretend feminists are not fascist? 

T1 femoid.md ---------- 


See [woman](woman.md). 
- ------ fight culture.md -- 
& Fight Culture 


Fight culture is the [harmful] (harmful.md) mindset of seeing any endeavor as a fight against something. Even such causes as aiming for establishment of [peace] ( eace,md) are. seen as fighting. the 
people who are against peace, which is [funny](fun.md) but also sad. Fight culturé keeps, just by the constant repetition of the word *fight*, a subconscious validation’ of violence as justified 
and neces saly means for achieving any goal. Fight culture is to a great degree the culture of [capitalist](capitalism.md) society (of course not exclusively), the environment of extreme 
competition ànd hostility. 


We](lrs.md), of course, see fight culture as inherently undesirable for a good society as_that needs to be based on peace, love and [collaboration](collaboration.md), not competition] 
con gon: For this reasons we never say we "fight" anything, we rather aim for goals, look for solutions, educate ànd sometimés reject, refüse and oppose bad concepts (e.g. fight culture 
itse 


firmware.md ------- -- 


# Firmware 


Firmware is a type of very basic software | (softwar e.md) that's usually preinstalled on a device from factory and serves to provide the most essential functionality of the device. On simple 
devices, like mp: players or remote controls, firmware may be all that's ever needed for the device's functioning, while on more complex ones, such as [personal computers] (pe md), firmware (e.g. 
BIOS](bios.md) or [UEFI](uefi.md)) allows basic configuration and installation of more complex software (such as an [operating system](os.md)) and possibly provides functions that the installed 


Software can use. Firmware is normally not meant to be rewritten by the user and is installed in some kind of memory that's not very easy to rewrite, it may even be hard-wired in which case it 
becomes something on the very boundary of software and [hardware] (hardware.md). 


T1 fixed point.md ---------- 
# Fixed Point 


Fixed point.arithmetic is a simple and often gogod grough] (good enough md) method of computer representation of [fractional] {rational number md) numbers (i.e. numbers with higher precision than 
integers](integer.md), e.g. 4.03), as opposed to [floating point |(r oat.md) which is a more complicated way of doing this which in most cases we consider a worse, [bloated](bloat.md) 
alternative. Probably in 99% cases when you think you need floating point, fixed point will do just fine. 


Fixed point has at least these advantages over floating point: 


- **It doesn't require, a special hardware coprocessor** for efficient execution and so doesn't introduce.a [dependenc | (dependency. md). Programs using. floating point will run extremely.slowly on 
systems without float hardware support as they have to emulate the complex hardware in software, while fixed point wi run just as fast as integer arithmetic. For this reason fixed point is 
very often used in [embedded](embedded.md) computers. 

- It is **natural, easier to understand and therefore better predictable**, less tricky, [KISS](kiss.md), [suckless](sukless.md). (Float's IEEE 754 standard is 58 pages long, the paper *What 
Every Computer Scientist Should Know About Floating-Point Arithmetic* has 48 pages.) 

- Is easier to implement and so cup orted in many more systems**. Any language or format supporting integers also supports fixed point. . 

- Isn't ugly and in [two's complemen tuos compiehent .md) **doesn't waste values** (unlike IEEE 754 with positive and negative zero, denormalized numbers, many [NaNs](nan.md) etc.). 


## How It Works 


Fixed point uses a, fixed (hence the name) number of digits (pits in binary) for the integer part and the rest for the. fractional part (whereas floating point's fractional part varies in size). 
I.e. we split the binary representation of the number into two parts (integer and fracti nal) by IMAGINING a radix point at some place in the binary répresentation. That's basically it. Fixed 
point therefore spaces numbers [uniformly](uniformity.md), as opposed to floating point whose spacing of numbers is non-uniform. 


So, **we.can just use an integer data type as a fixed point data type**, there is no need for libraries or special hardware, support. We can also perform Qperations such as addition the same way 
as with integérs. For example if we have a binary integer number represented as '00001001', 9 in decimal, we may say we'll be considering, a radix point after let's say the sixth place, i.e. we 
get 7000010.01' which we interpret as 2.25 (2^2 + 2^(-2)). The binary value we store in a variable is the same (as the radix point is only imagined), we only INTERPRET it differently. 


We may look at it this Way: we still use integers but we use them to count smaller fractions than 1., For example in a 3D, game where. our basic spatial unit is 1 meter our variables may rather 
contain the number of centimeters (however in practice we should use powers of two, so rather 1/128ths of a meter). In thé example in previous paragraph we count 1/4ths (we say our **scaling 
factor** is 1/4), so actually the number represented as '00000100' is what in floating point we'd write as '1.0' (°00000100° is 4 and 4 * 1/4 = 1), while ~00000001° means '0.25'. 


This has just one consequence: **we have to {normalize | (normalize md) results of multiplication and division** (addition and subtraction work just _as with integers, we can normally use the `+` 
and ^-' operators). I.e. when multiplying, we have to divide the result by the inverse of the fractions we're counting, i.e. by 4 in our case (1/(1/4) = 4). Similarly when dividing, we need to 
MULTIPLY the result by this number. This is because we are using fractions as our units and when we multiply two numbers in those units, the units multiply as well, i.e. in our case multiplying 
two numbers that count 1/4ths give a result that counts 1/16ths, we need to divide this by 4 to get the number of 1/4ths back again (this works the same as e.g. units in physics, multiplying 
number of meters by number of meters gives meters squared.) For example the following integer multiplication: 


700001000' * `00000010` = 700010000" (8 * 2 = 16) 

in our system has to be normalized like this: 

(7000010.00' * '000000.10') / 4 = '000001.00' (2.0 * 0.5 = 1.0) 

SIDE NOTE: in practice you may see division replaced by the shift operator (instead of ^/4^ you'll see “>> 2°). 


With this normalization we also have to **think about how to bracket expressions to prevent rounding errors and [overflows](overflow.md)**, for example instead of '(x / y) * 4^ we may want to 
write (x * 4) / y ; imagine e.g. *x* being 00000010 (9.5) and *y* being ‘00000100° (1.0), the former would result in © (incorrect rounding error) while the latter correctly results in 0.5. 

The bracketing depends on what values you expect to be in the variables so it can't really be done automatically by a comps ler or library (well, it might probably be somehow handled at [runtime] 
a 


(runtime.md), but of course, that will be slower). There are also ways to prevent overflows e.g. with clever [bit cks](bit_hack.md). 


The normalization is þasically the only thing you have to think about, apart from this everything works as with integers. Remember that **this all also works with negative number in [two's 
complement](twos complement.md)**, so you can use a signed integer type without any extra trouble. 


Remember to **always use a power of two scaling factor** -- this is crucial for performance. I.e. you want to count 1/2th, 1/4th, 1/8ths etc., but NOT 1/10ths, as might be tempting. Why are 
power of two good here? Because computers work in binary and so the normalization operations with powers of two (division and multiplication by the scaling factor) can easily be optimized by the 
compiler to a mere [bit shift](bit shift.md), an operation much faster than multiplication or division. 


## Code Example 


For start let's compare basic arithmetic operations in [C](c.md) written with floating point and the same code written with fixed point. Consider the floating point code first: 


.0; 


multiplication 
addition 
division 
subtraction 
division 


printf('"?fNn",a); 


Equivalent code with fixed point may look as follows: 


#define UNIT 1024 // our "1.0" value 


int 
a = 21 * UNIT 
b= (3 * UNIT) / 4, // note the brackets, (3 / 4) * UNIT would give 0 
c = (-10 * UNIT) / 3; 
a = (a * b) / UNIT; // multiplication, we have to normalize 
a GH // addition, no normalization needed 
a (a * UNIT) / b; // division, normalization needed, note the brackets 
a 10 * UNIT; // subtraction 
a /= 3; // division by a number NOT in UNITs, no normalization needed 
printft d Nddxd Nn", // writing a nice printing function is left as an exercise :) 
a UNIT 


a * 10) / UNIT) % 10, 
a * 100 


a * 100) / UNIT) * 10 
Q) / Mart) % 16); 


These examples output ~2.185185° and ~2.184°, respectively. 


Now consider another example: a simple [C](c.md) program using fixed point with 10 fractional bits, computing [square roots](sqrt.md) of numbers from © to 10. 


#include <stdio.h> 
typedef int Fixed; 
#define UNIT_FRACTIONS 1024 // 10 fractional bits, 2410 = 1024 
#define INT_TO_FIXED(x) ((x) * UNIT_FRACTIONS) 
Fixed fixedSqrt(Fixed x) 
t // stupid brute force square root 
int previousError = -1; 
for (int test = 0; test <= x; ++test) 


int error = x - (test * test) / UNIT_FRACTIONS; 


if (error == 0) 
return test; 

else if (error « 0) 
error *- -1; 


if (previousError » 0 && error » previousError) 
eturn test - 1; 
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previousError - error; 
return 0; 


void fixedPrint(Fixed x) 


printf("*d.X03d",x / UNIT FRACTIONS, 
((x % UNIT FRACTIONS) * 1000) / UNIT FRACTIONS); 


int main(void) 
for (int i = 0; i <= 10; ++i) 
printf("%d: ",i); 
fixedPrint(fixedSqrt(INT TO FIXED(i))); 
} putchar('\n'); 


return 0; 


The output is: 


# FizzBuzz 


TODO 


#include <stdio.h> 
int main(void) 


for (int i = 1; i <= 100; ++i) 
pete ((i % 3 == 0) + (1 % 5 == 0) * 2) 


case 1: printf("Fizz\n"); break; 
case printf ("Buzz\n" break; 

case 3: printf("FizzBuzz\n"); break; 
default: printf("9&dNn",i); break; 


return 0; 


T float.md ---------- 
& Floating Point 


Floating point arithmetic (colloquially just *float*) is a method of computer representation of {fractional ] (rational number.md) numbers and approximating [real numbers](real number.md), i.e. 
numbers with higher than [integer ](integer.md) preciSion (such as 5.13), which is more complex than e.g. [fixed point [(fixed_point.md) ; The core idea of it is to use a ràdix ("decimal" oint 
that's not fixed but can move around so as to allow representation of both very small and very big values. Nowadays floating point is the standard way of [approximating] (approximation md [real 
numbers](real_number.md) in computers (floating point ypes are called *real* in some programming languages, even though they represent only [rational numbers](rational_number.md), floats can't 
e.g. represent [pi](pi.md) exactly}: basically all of the popular [programming languages] (programming. language md) have a_floating point [data type] (datatype md) that adheres to the IEEE 754 
standard, all personal computers also have the floating point hardware unit (FPU) and so it is widely used in all [modern](modern.md) programs. However most of the time a simpler representation 
of fractional numbers, such as the mentioned [fixed point](fixed point.md), suffices, and weaker computers (e.g. [embedded]|(embedded.md)) may lack the hardware support so floating point 
operations are emulated in software and therefore slow -- remember, float rhymes with [bloat](bloat.md). Prefer fixed point. 


Mu point is tricky**, it works most of the time but a ganger lies in programmers relying on this kind of [magic] (magic. md) too much, some new generation, programmers may not even be very 
aware of how float works. Even though the principle is not so hard, the emergent complexity of the math is reatly complex. One floating point expression may evaluate differently on different 
systems, eg due to different rounding settings. One possible pret is working with big and small numbers at the same time -- due to differing precision at different scales Small values 
simply get lost when mixed with big numbers and sometimes this has to be worked around with tricks (see e.g. [this](htt artho witness ne t/news/ £0227 02/ a: shader- Trick) devlog of The Witness 
where a float time variable sent into [shader](shader.md) is periodically reset so as to not grow too large and cause the mentioned issue). Another famous trickiness of float is that you 
shouldn't really a5 comparing them for equality with a normal ~==" operator as small rounding errors may make even mathematically equal expressions unequal (i.e. you should use some range 
comparison instead). 


And there is more: floating point behavior really.depends on the Language You pt, using (and, possibly even compiler, its setting etc.) and it may not be always completely defined, leading to 
possible [Róndetermintstic](Beterminism.md) behavior which can cause real trouble e.g. in physics engines. 


Í Really as I'm now getting down the float rabbit hole I'm seeing what a huge mess it all is, I'm not near ly an expert on this so maybe I've written some BS here, which just confirms how messy 
loats are. Anyway, from the articles I'm reading even being an expert on this issue doesn't seem to guarantee a complete understanding of it :) Just avoid floats if you can. -drummyfish } 


Is floating pgigt literal evil? Well, of course not, but it is extremely overused. You may need it for precise. scientific simulations, HT [numerical integration](pumerica] integration.md), but 
as our [smáll3dlib](small3dlib.md) shows, you can comfortably do even [3D rendering](3d réndering.md) without it. So always consider whether you REALLY need float. You mostly do not. 


## How It Works 


The very basic idea is following: we have digits in memory and in addition we have a ppsition of the radix point among these digits, i.e. both digits and position of the radix point can change. 
The fact that the radix point can move is reflected in the name *floating point*. In the end any number stored in float can be written with a finite number of digits with a radix point, e.g. 

12.34. Notice that any such number can also always be written as a simple fraction of two integers (e.g. 12.34 = 1 * 10 +2 * 1+ 3 * 1/10 + 4 * 1/100 = 617/50), i.e. any such number is always a 
rational number. This is why we say that floats represent fractional numbers and not true real numbers (real numbers such as [pi](pi.md), [e](e.md) or square root of 2 can only be approximated). 


More precisely floats represent numbers by representing two main parts; the, *base* -- actual encoded digits, called **mantissa** {or significand ete.) -- and the position of the radix point, The 
position of radix point is called the **exponent** because mathematically the floating point works similarly to the scientific notation of extreme numbers that use exponentiation. For example 
instead of writing 0.0000123 scientists write 123 * 10^-7 -- here 123 would be the mantissa and -7 the exponent. 


Though various numeric bases can be used, in [computers](computer.md) we normally use [base 2](binary.md), so let's consider it from now on. So our numbers will be of format: 
*mantissa * 2^exponent* 
Note that besides mantissa and exponent there may also be other parts, typically there is also a sign bit that says whether the number is positive or negative. 


Let's now consider an extremely simple floating point format based on the above. Keep in mind this is an EXTREMELY NAIVE inefficient format that wastes values. We won't consider negative 
numbers. We will use 6 bits fof our numbers: 


- 3 leftmost bits for mantissa: This allows us to represent 2^3 = 8 base values: 0 to 7 (includin both p ; 4 
- 3 rightmost bits for exponent: We will encode exponent in [two's complement](twos comp ement md) so that it can represent values from -4 to 3 (including both). 


30 for example the binary representation ^110011' stores mantissa “110° (6) and exponent “011° (3), so the number it represents is 6 * 243 = 48. Similarly ~001101° represents 1 * 24-3 = 1/8 = 


Note a few things: firstly our format is [shit](shit.md) because some numbers have_multiple representations, TAL 0 can be represented as /000000', '000001', '000010', `000011` etc., in fact we 
have 8 zeros! That's unfofgivable and formats üsed in pfactice address this (usually by prepending an implicit to mantissa). 


Secondly notice the non-uniform distribution of our numbers: while we have a nice resolution close to 9 (we can.represent, 1/16, 2/16,, 3/16, ...), our resolution in high numbers, is low (the 
highest number we can represent is 56 but the second highest is 48, we can NOT represent e.g. 50 exactly). Realize that obviously with 6 bits wé' can still represent only 64 numbers at most! So 
float is NOT a magical way to get more numbers, with integers on 6 bits we can represent numbers from © to 63 spaced exactly by 1 and with our floating point we can represent numbers spaced as 
close as 1/16th but only in the region near 0, we pay the price of having big gaps in higher numbers. 


Also notice that thing like simple addition of numbers become more difficult and time consuming, you have to include conversions and [rounding] (rounding. md) -- while with fixed point addition is 
a single machine instruction, same as integer addition, here with software implementation we might end up with dozens of instructions (specialized hardware can perform addition fast but still, 
not all computer have that hardware). 


Rounding errors will appear and accumulate during computations: imagine the operation 48 + 1/8. Both numbers can be represented in our system but not the result (48.125). We have to round the 
result and end up with 48 again. Imagine you perform 64 such additions in succession (e.g. in a loop): Mathematically he result should be 48 + 64 * 1/8 = 56, which is à result we can represent 
an Sur system, but we wall nevertheless get the wrong result (48) due to rounding errors in each addition. So the behavior of float can be **non intuitive** and dangerous, at least for those who 
on't know how it works. 


## Standard Float Format: IEEE 754 


IEEE 754 is THE.standard that basically all computers use for floating point nowadays -- it specifies the exact representation of floating point numbers as well as rounding rules, required 
Operations applications should implement etc. However note that the standard is **kind of [shitty](shit.md)** -- even if we want to use floating point numbers there exist better ways such as 
so LposiEs] (posit. md) ^ that outperform this standard. Nevertheless IEEE 754 has been established in the industry to the point that it's unlikely to go anytime soon. So it's good to know how it 
works. 


Numbers in this,standard are signed, have, positive, and negative zero {oops) can represent plus and minus infinity] (infinity md) and different [NaNs](nan.md) (not a number). In fact there are 
thousands to billions of differént NaNs which are basically wasted values. These inefficiencies are addressed by t mentioned [posits](posit.md 


Briefly the representation iş following (hold on to your chair): leftmost bit is the sign bit, then exponent follows £thg number of bits depends on the specific format), the rest of bits is 
mantissa. In mantissa implicit 1. is considered (except when exponent is all 0s), i.e. we "imagine" “1.° in front of the mantissa bits but this 1 is not physically stored. Exponent is in so 
called biased format, i.e. we have to subtract half (rounded down) of the maximum possible value to get the real value (e.g. if we have 8 bits for exponent and the directly stored value is 120, 
we have to subtract 255 / 2 = 127 to get the real exponent value, in this case we get -7). However two values of exponent have special meaning; all Os signify so called denormalized (also 
subnormal) number in which we consider exponent to be that which is otherwise lowest posSible (e.g. -126 in case of 8 bit exponent) but we do NoT consider the implicit 1 in front of mantissa (we 
instead consider ial i.e. this allows storing [zero](zero.md) (positive and negative) and very small numbers. All 1s in exponent signify either [infinity](infinity.md) (positive and negative) 
in case mantissa is all 0s, or a [NaN](nan.md) otherwise -- considering here we have the whole mantissa plus sign bit unused, we actually have many different NaNs ([WTF](wtf.mf)), but usually we 
only distinguish two kinds of NaNs: quiet (qNaN) and signaling (sNaN, throws and [exception](exception.md)) that are distinguished by the leftmost bit in mantissa (1 for qNaN, 0 for sNaN). 


The standard specifies many formats that are either binary or decimal and use various numbers of bits. The most relevant ones are the following: 


| name |M bits|E bits| smallest and biggest number | precision «- 1 up to | 


196 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


binaryi6 (half preci ) 10 5 2^(-24), 65504 2048 

binary32 single precision, float) 23 8 2^ -149] 2127 * (2 - 2^-23) ~= 3 * 10^38| 16777216 
binary64 (double precision, double)| 52 11 2^ -1074) ~104308 9007199254740992 
binary128 (quadruple precision) 112 15 2^ -16494), ~1044932 ~10434 


**Example?** Let's say we have float (binary34) value ~11000000111109000090000000000000': first bit (sign) is 1 so the number is negative, Then we have 8 bits of exponent; ~10000001° (129) which 
converted from the biased format (subtracting 127) gives exponent value of 2. Then mantissa bits follow: '11100000000000000000000' . As we're dealing with a normal number (exponent bits aré 
neither all is nor all Os), we have to imagine the implicit ^1.' in front of mantissa, i.e. our actual mantissa is ~1.11100000000000000000000° = 1.875. The final number is therefore -1 * 1.875 * 
2^2 = -7.5. 


## See Also 


- FESSES POET ESP 


# FLOSS 


FLOSS ([free] (free sof tware.md) [libre](libre.md) and [open source](open source.md)) is basically [FOSS](foss.md). 
Te. ootball.md ---------- 
# Football 


*Not to be confused with any [American](usa.md) pseudosport.* 


Football is one of the most famous |sPort](sport md) [games] (game, md) in which two teams face each other and try to score goals by kicking an inflated ball. It is one of the best sports not only 
because it is genuinely [fun](fun.md) to play and watch but also because of its essentially simple rules, accessibility (not for rich only, all that's really needed is something resembling a 
ball) and relatively low discrimination -- bàsicall anyone can play it, unlike for example basketball in which height is key; in amateur football even fat people can take part (they are usually 
assigned the role of a goalkeeper). [Idiots](usa.md) call football *soccer*. 


We, FERS] (Irs md), highly, value football, as it's a very [KISS](kiss.md) sport that can be played by anyone anywhere without needing expensive equipment. It is the sport of the people, very 


poputar in poor parts of the world. 
Football can be implemented as a video [game](game.md) or inspire a game mode -- this has been done e.g. in [Xonotic](xonotic.md) (the Nexball mode) or [SuperTuxKart](supertuxkart.md). 
## Rules 


As football is so widely played on all levels and all around the world, there are many versions and rule sets of different games in the *football* family, and it can sometimes be difficult to 
even say what classifies as football and what's a different sport. There are games like futsal and beach football that may or may not be seen as a different sport. The most official rules of 
what we'd call football are probably those known as *Laws of the Game* governed by International Football Association Board (IFAB) -- these rules are used e.g. by FIFA, various national 
competitions etc. Some organizations, ei: some in the [US](usa.md), use different but usually similar rules. We needn't say these high level rules are pretty complex -- *Laws of the Game* have 
over 200 pages and talk not just about the mechanics of the game but also things such as allowed advertising, political and religious symbolism, referee behavior etc. 


Here is a simple ASCII rendering of the football pitch: 


C1 c2 


| "8| 
o 


cá ` ca 


In amateur games simpler rules are used -- a sum up of such rules follows: 


- There are **two teams** of players facing each other in.a match, officially 11 players on each team (10 "normal" players and one goal keeper), but of course, this can wildly differ in just, for 

fun games (street rules may also state that there is no fixed goat keeper; goal keeper is the one currently closest to own goal, or there may Simply be no goal keeper at all, especially with 

small goals). Each team usually wears different colors so they're easily distinguished 

- The match is played on a flat **rectangular field** (officially between, 100x64 and, 110x75 meters, but for fewer Player this can of course be much smaller) where there are **two goals** in the 

center of the shorter sides. Each team hás one goal (which may bé as simple as two shoes marking the goal borders) into which the opponent team tries to scóre goals. 

- There, is, **one ball** in the game, players move the ball.by Kicking it with their feet -- they may use other body parts too **except for their arms**, The exception is goal keeper who may 

touch the ball also with his arms and hahds, but only within the small area near the goal he protects. If no ball is available other things resembling it may be used. 

- The game starts with both teams on their half of the field, one is given the possession of the ball (this is usually decided by coin toss, but sometimes e.g. one team is given the choice of 

goal and other one gets the ball). 

- If the ball ends up in one team's goal, the opposite team **scores a point** and the game is restarted. ; : : 2 

- If the ball leaves the play field on one of the longer sides, the team who's player didn't touch the ball last gets a **throw-in** -- one player takes the ball in his hands and throws it to 

the play field from the point at which the ball left the field. If a game is played in an environment which the bàll cannot leave (e.g. a small sport hall), this rule is simply ignored. 

- If the ball leaves the play field.on,one of the shorter sides, then two things may happen. If the ball was last touched by the team whose goal is on the side at which the ball left the field 

the opposite team gets a **córner kick** (a free kick from the nearest corner Of the field). Otherwise the goal keeper of the goal on the side where the ball left the play field gets a kick off 
rom near his goal. 

- **Offside**: this is the infamous rule that [women] (woman md) don't get. This rule basically states that it is illegal for a player to get the ball while_he's.on the opponent's half and at the 

time the ball started to be passed to him he was closer to the’ opponent's goal than the second to last opponent's player (usually the back-most defender). This is so that one player doesn't just 

camp in front of the opponent's goal and wait for a long pass to score and easy goal. However in fun games this rule may be just ignored. 

- There are **punishments** for breaking the rules (e.g. playing with arm, attacking the opponent player or stalling the gane) which include a free kick (from the spot at which an offense 

happened), a penalty kick (one player géts a free kick on the opponent's goal with goal keeper from certain distance), yellow card (warning to a player), red card (given after yellow card, the 

player hàs to leave the game) etc. 

- The game is played in **two halves**, each one officially 45 minutes long,, but in fun games the number of parts and their duration is pretty arbitrary. After the first half there is a short. 

rest pause and the teams switch sides. After the second half whichever team has scored more points wins. If the score is equal, the match may be prolonged as a tie breaker, either just by adding 

more time or playing the instant death. If no winner is decided here, there may eventually be penalty kicks to decide the winner. 

- It's good if there's a referee, but if there is none, players just enforce the rules collectively. 


Fork is a branch that splits from the main branch of a project and continues to develop in a different direction as a separate version of that project, possibly. becoming a completely new one. 
This may happen with any "intellectual work" or idea such as [software](software.md), movement, theory, literary universe, religion or, for example, a [database](databaSe.md). Forks may later be 
*merged* back into the original project or continue and diverge far away, forks of different projects may also combine into a single project as well. 


For example the [Android](android.md) [operating system](os.md) and [Linux-libre](linux libre.md) [kernel] (kernel md) have both been forked from [Linux](linux.md). [Linux distributions] 
(distro.md) high Y utilizé EUH e.g. veutturel (Free culi or nd) "and fsucktess l and, [Mint jn .md) are forked from [Debian](debian.md). [Free software movement (i eipedia Adj alà was forked 
7 suckless](suckléss.m 


into [open source , and sückless was more or less forked into TENERA [Wikipedia](wikipedia.md) also has forks 
asis of forking. 


(free culture.md) and 
such as [Metapedia 


open source.md [free culture 
) evolve a lot on the 


(metapedia.md). [Memes](meme.m 


Forking takes advantage of the ability to freely duplicate [information] (information .md), i.e. if.someone sees how to improve an intellectual work. or use it in.a_novel way, he may simply copy it 
r e y icially 


and start developing it in a new diverging direction whil e original continues to exist and going its own way. That iS **unless copying and modification of information is arti 
prevented**, ed: by [intellectual property] (inte llectüal property md) laws or purposeful obscurity standing in the way of remixing. For this reason forking is very popular in [free culture] 
(free_culture.md) and [free software](free_software.md) where it is allowed both legally and practically -- in fact it plays a very important role there. 


In software development temporary forking is used for implementing individual features which, when completed, are merged back into the main branch. This is called **[branching](branch.md)** and 
is supported by [version control systems] (ves md) such as [git](git.md). 


There are two main kinds of forks: 


-.**soft forks** (also. dynamic forks}: Soft fork introduces changes that. somehow stay compatible with the original project, and can otentially even be merged back later, the fork exists as a 
different but synchronized version of the original project and aš the original get üpdates, the fork automatically gets these updates as well. Temporary git] (gat md) forks during development 
are soft forks, also for example (Linux: Libre] (Linux libre. m) is a_soft fork of [Linux](linux.md) as it adds a set of scripts that automatically remove proprietary blobs from the current 
version of Linux; [patches ](patch md of [suc ess 1 (suckless-ma) software can also be seen as soft forks. It is typical that a soft fork somehow maintains just a set of changes against the 
original, e.g. in a form of a [diff](diff.md) or [Script](script.md), i.e. soft fork is kind of a lightweight fork for which the original project stays a [dependency] (dependency.md). 

- **hard forks**: Hard fork splits from the original project in, such a way that it can no longer be gasily merged back, it diverges iņ a very different way and_stops being synchronized with the 
original. For example [darkplaces](darkplaces.md) is a hard fork of the [ uake | (quake md) 1 engine. Hard fork typically just copies all the data of the original project tó a new repository and 
start modifying them freely. This has the disadvantage of having to repeat work on the original and the fork (e.g. if a new bug is discovered in the original after the split, it has to be 
manually fixed in both verSions). This is one of the reasons why hard forks very often split off of projects that aren't actively developed anymore. 


**Is forking good?** Yes, to create anything new it is basically necessary to build on top of someone else's work, stand on someone else's shoulders. Some people criticize too much forking; for 
example somë čry about [Linux] (Linux. md) [gstro](distro.md) fragmentation, they say there are too many of distros and that people should rather focus their energy on creating a single or at 
least fewer good operating systems, i.e. that forking is kind of "wasting effort". YLRSI (irs ma) supports any kind of wild forking and experimentation, we believe the exploration of many 
EE taane necessary in order to find the right one, in a [good society](less retarded society.md) waste of work won't be happening -- that's an issue of a [competitive society] 
capitalism.md), not forking. 


In fact we think that (at least soft) forking should be incorporated on a much more basic level, in the way that the [sugk less] (Suckless md) community popularized. In suckless **everyone's copy 
of software is a personal fork**, i.e. software is distributed in source form and is so extremely easy to Compile and modify that every user is Supposed o do this as part of the installation 
process (even if he isn't a programmer). Before compilation user applies his own selected patches, custom changes and specific configuration (which is done in the source code itself) that are 
unique to that user and which form source code that is the user's personal fork. Some of these personal forks may even become popular and copied by other users, leading to further development of 
these forks and possible natural rise of very different software. This should lead to natural selection, survival and development of the good and useful forks. 

T1 formal language.md ---------- 

# Formal Language 


The field of formal languages tries to [mathematically](math.md) and rigorously view problems as languages; this includes probably most structures we can think of, from human languages and 
computer languages to visual patterns and other highly abstract structures. Formal languages are at the root of theoretical [computer sezence }(compsc1-md)- and are important Eige or the theory 
es [computabit y gomputapi ty. md )decidaps Tity; computational complexity, [security] (security md) and [compilers](compiler.md), but they also find use in linguistics and other fields of 
science](science.md). 


A **formal language"? is defined as a (potentially infinite) set of strings (which are finite but unlimited in length) over some alphabet (which is finite). I.e. a language is a subset of E* 
where E is a finite alphabet (a set of *letters*). (* is a *Kleene Star* and signifies a set of all possible strings Over E). The string belonging to a language may be referred to as a *word* or 
perhaps even *sentence*, but this word/sentence is actually a whole kind of *text* written in the language, if we think of it in terms of our natural languages. The [C](c.md) programming 
anguage can be seen as a formal language which is a set of all strings that are a valid C program that compiles without errors etc. 


**For example**, given an alphabet [asbl a possible formal language over it is [a,ab,bc,c]. Another, different possible language over this alphabet is an infinite language 
[b,ab,aab, aaab, aaaab,...] which we Can also write with a [regular expression] (regex md) as a*b. We can also see e.g. English aS béing a formal language equivalent to a sët Of all texts over the 
English alphabet (along with symbols like space, dot, comma etc.) that we would consider to be in English as we speak it. 


**what is this all good for?** This mathematical formalization allows us to classify languages and understand their structure, which, is, necessary e.g. for creating efficient compilers, but also 
to understand computers as such, their power and limits, as computers can be viewed as machines for processing formal languages. With these tools reSearches are able to come up with [proofs] 
(proof.md) of different properties of languages, which we can exploit. For example, within formal languages, it has been proven that certain languages are uncomputable, i.e. there are some 
problems which a computer cannot ever solve (tybical example is the [halting problem](halting problem.md)) and so we don't have to waste time on trying to create such algorithms as we will never 
find any. The Knowledge of formal languages can also guide us in designing computer languages: e.g. we know that regular languages are extremely simple to implement and so, if we can, we should 
prefer our languages to be regular. 


## Classification 
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We usually classify formal languages according to the ** Chomsky ] (chomsky <md) hierarchy sg by their computational "difficulty". Each, level of the hierarchy has associated models of computation 
([grammar$] (grammar mà) [automatons] automaton.md), ...) that are able to compute **all** languages of that level (remember that a level of the hierarchy is a superset of the levels below it 
nd so also includes alt the "simpler" languages). The hierarchy is more or less as follows: 


- **all languages**: This includes all possible, languages, even those that computers. cannot analyze (e.g. the language representing the [halting problem](halting problem.md)). These languages 
can only be computed by theoretical computers that Cannot physically exist in our universe. 

- **type 0**, **recursively enumerable languages**: Most "difficult"/general languages that computers in our universe can analyze. These languages can be computed e.g. by a **[Turing machine] 
(turing machine.md)**, [lambda calculus](làmbda calculus.md) or a general unrestricted [grammar](grammar.md). Example language: a^n where *n* iS not a [prime](prime.md). 


~_**type 1**, **context sensitive languages**: Computed e.g.,by a linearly bounded non-deterministic Turing machine or a context sensitive grammars. Example language: a^(n)b^(n)c^(n), n >= 0 
(strings of *n* *a*s, followed by *n* *b*s, followed by *n* *c*s). 

- **type 2**, **context free languages**: Computed by e.g. non-deterministic pushdown automata or context free grammars. (Deterministic pushdown automata compute a class of languages that is 
between type 2 and type 3). 


-.**type 3**, **regular languages**: The *easiest*, *weakest* kind of languages, computed e.g. by [finite state automata](finite state automaton.md)s or [regular expressions](regexp.md). This 
class includes also all finite languages. 


Note that here we are basically always examining **infinite languages*?.as finite languages are trivial, If a language is finite (i.e, the set of all strings of the language is finite), it can 
automatically be computed by any type 3 computational model. In [real life](irl.md) computers are actually always equivalent to a finite state automaton, i.e. the *weakést* computational type 
(because a computer memory is always finite and so there is always a finite number of states a computer can be an}: However this doesn't mean there is no point in studying infinite languages, of 
course, as we're still interested in the structure, computational methods and approximating the infinite models of computation. 


**NOTE**: When trying to classify a [programming lan vage] (programming language md], we have to be careful about what we classify: one thing is what a program written in given language can 
compute, and another thing is thé language's [s ntax]i syn àx.md). To tne fórmér all strict general purpose programming languages’ such as [E] (end or [JavaScript](javascript.md) are type 0 

( [Turing complete] (turing complete.md]). From the syntax point of view it's a bit more complicated and we need to further define what exact Y a syntax is (where is the line between syntax and 
semantic errors): it may be (and often is) that syntactically the class will be lower. There is actually a famous [meme](meme.md) about [Perl](perl.md) syntax being undecidable. 

T forth.md ---------- 

# Forth 

Forth is a based [minimalist](minimalism.md) stack-based untyped programming language with [postfix](notation.md) (reverse Polish) notation. 

{ It's kinda like usable [brainfuck](brainfuck.md). -drummyfish } 

It is usually presented as [interpreted](interpreter.md) language but may as well be [compiled](compiler.md), in fact it maps pretty nicely to [assembly](assembly.md). 

There are several Forth standard, most notably ANSI Forth from 1994. 

A free interpreter is e.g. GNU Forth ([gforth](gforth.md)). 

## Language 

The language is case-insensitive. 


The language operates on an evaluation **stack**; £18; the operation + takes the two values at the top of the stack, adds them together and pushed the result back to the stack. Besides this 
there are also some "advanced" features like variablés living outside the stack, if you want to use them. 


The stack is composed of **cells**: the size and internal representation of the cell is implementation defined. There are no data types, or rather everything is just of type signed int. 


Basic abstraction of Forth is so called **word**: a word is simply a string without spaces like ‘abc’ or `1mm#3`. A word represents some operation on stack (and possible other effect such as 
printing to the console), for example the word “1° adds the number 1 on top of the stack, the word `+` performs the addition on top of the stack etc. The programmer can define his own words 
which càn be seen as "fünctions" or rather procedures or macros (words don't return anything or take any arguments, they all just invoke some operations on the stack). A word is defined like 
this: 


i omyword operationi operation2 ... ; 

For example a word that computes and average of the two values on top of the stack can be defined as: 
i "Average * 2 

Built-in words include: 


GENERAL: 


* add a b -> (a+b 

- subtract a b -> (b -a 

* multiply a b -> (a* b 

/ divide ab -> (b/a 

= equals a b -> (-1 if a = b else 0 

< less than a b -> (-1 if a « b else 0 

> greater than ab -> (-1 if a > b else 0 

mod modulo a b -> (b % a) 

dup duplicate a->aa 

drop pop stack top a-> 

swap swap items ab->ba 

rot rotate 3 abc->bca 

. print top & pop 

key read char on top 

Hu print stack 

emit print char & pop 

cr print newline 

cells times cell width a -» (a * cell width in bytes) 

depth pop all & get d. a... -» (previous stack size) 

bye quit 

VARIABLES/CONSTS : 

variable X creates var named X (X is a word that pushed its addr) 

NX! stores value N to variable X 

N X+! adds value N to variable X 

xX @ pushes value of variable X to stack 

N constant C Creates constant C with value N 

c pushes the value of constant C 

SPECIAL: 

() comment (inline) 

N comment (until newline) 

QUISOM print string E : 

X if C then if X, execute C // only in word def. 

X if C1 else C2 then if X, execute C1 else C2 // only in word def. 

do C loop loops from stack top value to stack second from, 
. d top; special word "i" will hold the iteration val. 

begin C until like do/loop but keeps looping as long as top = 0 

begin C while like begin/until but loops as long as top !- 

allot allocates memory, can be used for arrays 


example programs: 


10012 *7 * / . \ computes and prints 100 / ((1 + 2) * 7) 
cr.." hey bitch " cr \ prints: hey bitch 


: myloop 5 0 do i . loop ; myloop \ prints 01234 


FOSS ([Freq](free_software md). and Lopen Source] open source.md) Software, sometimes also [FLOSS (floss md), adding aeaores)s is a kind. of neutral term for software that is both free as in 
freedom and open source. It's just another term for this kind of software, as if there werén't enough of them :) Péople normally use this to stay neutral, to appeal to bo free and open source 
camps or if they simply need a short term not requiring much typing. 

T1 fga.md ---------- 

& Frequently Questioned Answers 


TODO: figure out what to write here 
---------- fractal.md ---------- 
# Fractal 


Informally speaking fractal is a shape that's geometrically "infinitely complex" while being described in an extremely simple way, „e.g. with a very simple formula or [algorithm](algorithm.md). 
Shapes found in thé nature, such as trees, mountains or clouds, are often fractals. Fractals show self-similarity, i.e. when "zooming" into an ideal fractal we keep séeing it i$ composed, down 
to an infinitely small scale, of shapes that are similar to the shape of the whole fractal; e.g. the branches of a tree look like smaller versions of the whole tree etc. 


Fractals are the [beauty](beauty.md) of mathematics, they can impress even complete non-mathematicians and so are probably good as a motivational example in [math](math.md) education. 


Eractal is formed by [iteratively] (iteration md) or j'ggursively]trecursion md) (repeatedly) applying its defining rule -- once we repeat the rule infinitely many times, we've got a perfect 
fractal. [In the real world](irl.md), of course, both in nature and in computing, the rule is just répeat many times as we can't repeat literally infinitely. The following is ah example of how 
iteration of a rule creates a simple tree fractal; the rule being: *from each branch grow two smaller branches*. 
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iteration © iteration 1 iteration 2 iteration 3 


Mathematically fractal is a shape whose [Hausdorff dimension](hausdorff dimension.md) (the "scaling factor of the shape's mass") is non-integer. For example the [Sierpinski triangle] 
(Sierpinski triangle md) can normally be seen as a 1D or 2D shape, but its Hausdorff dimension is approx. 1.585 as if we scale it down twice, it decreases its "wéight" three times (it becomes 
one of the three parts it is composed of); Hausdorff dimension is then calculated as log(3)/log(2) ~= 1.585. 


[tosystems] (l system. md) are one possible way of creating fractals. They describe rules in form of a [formal grammar] (grammar md) which is used to generate a string of symbols that are 
Subsequently in erprered as drawing commands (e.g. with fturt ie gráphics](turtle graphics md) ) that rénder the fractal. The above shown tree can be described by an L-system. Among similar famous 
o 


fractals are the [Koch snowflake](koch snowflàke.md) and [Sierpinski Triangle](sierpinski triàngle.md). 
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Sierpinski Triangle 


Fractals don't have to be [deterministic] (determinism.md), sometimes there can be [randomness](random.md) in the rules which will make the shape be not perfectly self-similar (e.g. in the above 
shown tree fractal we might modify the rule to *from each branch grow 2 or 3 new branches*). 


Another way of describing fractals is by iterative mathematical formulas that work with points in [space] (space md). One of the most famous fractals formed this way is the y-[Mandelbrot set] 
mandelbrot.md)**. It is the set of [complex numbers](complex number.md) *c* such that the series *z\_next = (zM pfevious)^2 + c*, *zO = 0* does not diverge] (divergence. md) o [infinity]. 
infinity.md). Mendelbrot set can nicely be rendered by assigning each iteration's result a different color; this produces a nice colorful fractal. [Julia sets](julia set.md) are very similar 

and there is infinitely many of them (each Julia set is formed like the Mandelbrot set but *c* is fixed for the specific set and *z0* is the tested point in the complex plain). 


Fractals can of course also exist in 3 and more dimensions so we can have also have animated 3D fractals etc. 
## Fractals In Tech 


[Computers] (computer md) are.good for exploring and rendering fractals as they can repeat given rule millions of times in a very short time. Programming fractals is quite easy thanks to their 
imple rules, yet this Can highly impress noobs. 


However, as shown by Code Parade (https://yewtu.be/watch?v=Pv26QA0cb6Q), complex fractals could be rendered even before the computer era using just a projector and camera that feeds back the 
picture to the camera. This is pretty neat, though it seems no one actually did it back then. 


3D fractals can be rendered with [ray marching](ray-marching.md) and so called *distance estimation*. This works similarly to classic [ray tracing] ray tracing md) but the rays_are traced 
iteratively: we step along the ray and at each step use an estimate of the current point to the surface of the fractal; once we are "close enough below some specified threshold), we declare a 
hit and proceed as in normal ray tracing (we can render shadows, apply materials etc.). The distance estimate is done by some clever math. 


[Mandelbulber](mandelbulber.md) is a [free](free_software.md), advanced software for exploring and rendering 3D fractals using the mentioned method. 


[Marble Racer](marble racer.md) is a [Eos] (foss md) [game ] (game md) in which the player races a glass ball through levels that are animated 3D fractals. It also uses the distance estimation 
method implemented as a [GPU](gpu.md) [shader](shader.md) and runs in real-time. 


Fractals are also immensely useful in [procedural generation](procgen.md), they can help generate complex art much faster than human artists, and such art can only take a very small amount of 
storage. 


There also exist such things as fractal antennas and fractal transistors. 
---------- frameless.md ---------- 
# Frameless Rendering 


Frameless rendering is a technique of ,frendering] (rendering md? animation by continuously updating an image on the screen by updating single "randomly" selected pixels rather than by showing a 
quick sequence of discrete frames. This is an alternative to the mainstream [double buffered](double_buffering.md) frame-based rendering traditionally used nowadays. 


Typically this is done with [image order](image_order.md) rendering methods, i.e. methods that can immediately and independently compute the final color of any pixel on the screen -- for example 
with [raytracing](raytracing.md). 


The main advantage of frameless rendering is of course saving a huge amount of memory.usually needed for double buffering, and usually also increased performance (fewer pixels are processed per 
second). The animation may also seem moré smooth and responsive -- reaction to input is seen faster. Another advantage, and possibly à disadvantage as well, is a **[motion blur] 

(motion blur.md)** effect that arises as a side effect of updating by individual pixels spread over the screen: some pixels show the scene at a newer time than others, so the previous images 
Kind of blend with the newer ones. This may add realism and also prevent temporal [aliasing](aliasing.md), but blur may sometimes be undesirable, and also the kind of blur we get is "pixelated" 
and noisy. 


Selecting the pixels to update can be done in many ways, usually with some [pseudorandom] (pseudorandom .md) selection ([jittered sampling](j 


(ha LEor Sequence md), Poisson Disk sampling, ...), but regular patterns may also be used. There have been papers that implemented maTi 
update pixels to achie' 


ittered sampling,md) [Hatton sequence] ME 
frameless rendering that detected wheré it is best to 
ve low noise. 


Historically similar [though different) techniques were used on computers that didn't have enough memory for a double buffer or redrawing the whole screen each frame was too intensive on the 
( : programmers dd o idéntify which pixels had to be redrawn and only update those. This resülted in techniques like *adaptive tile réfresh* used in scrolling games such as [Commander Keen] 
commander keen.md). 

T1 framework.md ---------- 

# Framework 


Software framework is a collection of tools such as [environments](environment.md), LHbraries] (library. md), [cgmpilers] (compiler .md) and editors] (editor mq), that together allow fast and 
comfortable implementation of other software by plugging in relatively small pieces of code. While a simplé [ dorary|(laprary md) is something that's plugged às a helpér into programmer's code, 
framework is a bigger system into which programmer plugs his code. Frameworks are generally [bloated](bloat.md) and harmful, [LRS](1lrs.md) doesn't recommend relying on them. 

T free culture.md ---------- 

# Free Culture 


Free (as in. freedom) culture is a movement aiming for the relaxation of [intellectual Peper ya (inte Ltectue L-proper cy md) restrictions,, mainly that of [copyright l(copyright.md), to allow free 
usage, reusing and Sharing of [artworks](art.md) and other kind of [information](information.md). Free culture argues that our society has gone too far in Torcefully restricting the natural 
freedom of information by very strict laws (e.g. by authors holding copyright even 100 years after their death) and that we're hurting art, creativity, education and progress by continuing to 
strengthen restrictions on using, modifying ({remixing] (remix md) ) and sharing things like [books](book.md), [music](music.md) and scientific papers. The word "free" in free culture refers to 
freedom, not just price -- free cultural works have to be more than just available gratis, they must also give its users some specific legal_rights. Nevertheless free culture itself isn't 
against commercialization of art, it just argues for rather doing so by other means than selling legal rights to it. The opposite of free culture is [permission culture](permission_culture.md) 
(culture requiring permission for reuse of intellectual works). 


The. promoters of free culture want to relax intellectual property laws (Toopyri ht] (copyright .md), [ atents {patent md) [trademarks] (Em-md) etc.) but also promote an ethic of sharing and 
remixing being good (e$ opposed to the demonizing anti-" [piracy ] (piracy: d)" propaganda’ of today), ey sométimes mark their works with words **"Some rights reserved"** or even "no rights 
reserved", M 


as opposed to the traditional "all rights reserved 


Free culture is kind of, a.younger sister movement to the **[free software] (free eof ware md) '* movement, in fact it has been inspired by it (ws, could call it its [fork] (fork md)) a While free 
software movement, established in 1983, was only concerned with freedoms relating to computer program source code, free culture later (around 2000) took its ideas and extended em to all 
information including e.g. artworks and scientific data. There are **clearly defined criteria** for a work to be considered free (as in freedom) work, i.e. part of the body of free cultural 
works. The criteria are very similar to those of free software (the definition is at https://freedomdefined.org/Definition) and can be summed up as follows: 


A free cultural work must allow anyone to (legally and practically): 


i: «iuo it an any way and for any purpose, even commercially. 

: udy it**. 

3. **Share it**, i.e. redistribute copies, even commercially. 

4. **Modify it** and redistribute the modified copies, even commercially. 


Some of these conditions may e.g, further require a source code of the work to be made available (e.g. sheet music, to allow studying and modification), Some conditions may however still be 
imposed, as long as they don't violate the above -- E if a work allows all the above but requires crediting the author, it is Still considered free (as in freedom). [Copy tert (copy ler E md). 
(also share-ali e, requirement of keeping the license for derivative works) is another condition that may be required. This means that many (probably most) free culture promoters actually rely 
and even support the concept of e.g. copyright, they just want to make it much less strict. 


It was in .2001 when ta jawrence Lessig] (lessig.md **, an American lawyer who can be seen as the movement's founder, created the ga qereative Fommons] (creative commons.md)**, a non-profit 
rganization which stands among the foundations of the movement and i$ very much connected to it. By this time he was already educating people about the twisted inteilectual property laws and 
had a few followers. Creative Commons would create and publish a set of [licenses] (License .md) that anyone could use to release their works under much less restrictive conditions than those that 
lawfully arise by default. For example if someone creates a song and releases it under the [CC-BY](cc_by.md) license, he allows anyone to freely use, modify and share the song as long as proper 
attribution is given to him. It has to be noted that **NOT all Creative Commons licenses are free culture** (those with NC and ND conditions break the above given rules)! It is also possible to 
use other, non Creative Commons licenses in free culture, as long as the above given criteria are respected. 


In 2004 Lessig published his **book** called Free Culture that summarized the topic as well as.proposed solutions -- the book itself is shared under, a Creative Commons license and can be 
downloaded for free (however the license is among the non-free CC licenses so the book itself is not part of free culture [lmao](lmao.md), big fail by Lessig). 


{ I'd recommend reading the Free Culture book to anyone whose interests lie close to free culture/software, it's definitely one of the essential works. ~drummyfish } 


In the book Lessig.gives an overview of the history of copyright -- it, has been around, since about the time, of invention of [printing press] (printing press md) tg give some publishers exclusive 
rights (an artificial [monopoly](monopoly.md)) for printing and publishing certain books. The laws evolved but at first were hot so restrictive, they only applied to very specific uses 
(printing) and for limited time, plus the copyright had to be registered. Over time corporations pressured to make it more and more restrictive -- nowadays copyright applies to basically 
everything and lasts for 70 years AFTER the death of the author i !!). This is combined with the fact that in the age of computers any use of information requires making a copy (to read 
something you need to download it), i.e. copyright basically applies to ANY use now. I.e. both scope and term of copyright have been extended to the extreme, and this was done even AGAINST the 
US constitution -- Lessig himself tried to fight against it in court but lost. This form of copyright now restricts culture and basically only serves corporations who want to e.g. **kill the 
[public domain (pub lic domain. md) (works that run out of copyright and are now "free for everyone") by repeatedly prolonging the copyright term so that people don't have any pool of free 
works that wou compete (and often win simply by being gratis) with the corporate created "content". In the books Lessig also mentions many hard punishments for breaking copyright laws and a 


lot of other examples of corruption of the system. He en goes on to propose solutions, mainly his Creative Commons licenses. 


Free culture has become a relative success, the free Creative Commons licenses are now widely used -- e.g. 1 wikipedia] (wikipedia md) is part of free** culture under the [CC-BY-SA](cc by sa.md) 
license and its sister project [Wikimedia Commons (wm commons.md) hosts over 80 million free cultural works! There are famous promoters of free culture such as [Nina Paley (nina. pa ey.md), 
webcomics, books, songs etc. In development of libre [games] (game md) free cultural licenses are used (alongside free software licenses) to liberate the game assets -- e.g. the [Freedoom 
(freedoom.md) project creates free culture content replacement for the 


game [Doom](doom.md). There are whole communities such as fopengamear t ] (oga md) or Blendswap for sharing free art, even 
sites with completely public domain stock photos, vector images, music and many other things. Many scientists release their data to public domain under [CCO](ccO.md). And of course, [LRS] 
(lrs.md) highly advocated free culture, specifically [public domain](public_domain.md) under [CCO](ccO.md). 


**BEWARE of fake free culture**: there are many resources that look like or eveņ call themselves "free culture" despite not adhering to its rules. This may be, by intention or not, some people 


just don't know too much about the topic -- a Common mistake is to think that all Creative Commons licenses are free culture -- again, this is NOT the case (the NC and ND ones are not). Some 
think that "free" just means "gratis" -- this is not the case (free means freedom, i.e. respecting the above mentioned criteria of free cultural works). Many people don't know the rules of 
e of a non-free work and so cannot 


copyright and think that they Can e.g. create a remix of some non-free pop song and license it under CC-BY-SA -- they CANNOT, they are making a derivative wor 
license it. Some people use licenses without knowing what they mean, e.g. many use CCO and then ask for their work to not be used commercially -- this can't be done, CCO specifically allows any 
commercial use. Some try to make their own "licenses" by e.g. stating "do whatever you want with my work" instead of using a proper waiver like CCO -- this is with high probability legally 
unsafe and invalid, it is unfortunately not so easy to waive one's copyright -- DO use the existing licenses. Educate yourself and if you're unsure, ask away in the community, people are glad to 
give advice. 
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## See Also 


free universe] (free_universe.md 
---------- free Rardware.md ----- 
# Free/Freedom-Friendly Hardware 


- Hres universe] (free-universe ` md) 


Free (as in freedom) hardware is a form of ethical [hardware] (hardware. md) aligned with the philosophy of [free (as in freedom) software](free_software.md), i.e. having a free [licensed] 
License. tid) designed that allows anyone to study, use, modify and share Such designs for any purpose and so prevent abuse of users by techno logy. Let us note the word *free* refers to User 
reedom, not price! Sometimes the term may be more broadly and not completely correctly used even for hardware that's just highly compatible wi purely free software systems -- let us rather 

call these a **freedom friendly hardware** -- and sometimes people misunderstand the term *free* as meaning "gratis hardware"; to avoid misunderstandings [GNU] (gnu md) recommends using the term 

i t 


**free design hardware** or **libre hardware** for free hardware in the strict sense, i.e. hardware with free licensed design. Sometimes -- nowadays maybe even more often -- the term *"[open 
source] (open-source, md)" hardware* or *open hardware* with very similar meaning is encountered, but that is of course a [harmful](harmful.md) terminology as open source is an inherently harmful 
alist](capitalism.md) movement ignoring the ethical question of freedom -- hence it is recommended to prefer using the term free hardware. Sometimes the acronym FOSH (free and open source 


capit 
[capitali is used neutrally, similarly to [FOSS](foss.md). 


[GNU] (gny md) just like [us (irs.md), highly advocates for free hardware, though, unlike with software, they don't completely reject using non-free hardware nowadays, not just_for practical 
easons (purély free hardwaré almost doesü't exist), but also because hardware is’ fundamentally different from software and it is possible to use *some* non-free hardware (Usually the older one) 
relatively safely, without sacrificing freedom. The [ESE I(r se md) issues so called **[Respects Your Freedom] (ryt -md ** (RYF) certification for non-malicious hardware products, both free and non- 
free, that can be used with 100% free software (even though RYF has also been a target of some criticism of free software activists). 


We 


Ce EERS Cons md advocate for more strict criteria than just a free-licensed hardware design, for example we prefer complete [public domain](public_domain.md) and advocate high [simplicity] 
iss.m 


which is a prerequisite of true freedom -- see [less retarded hardware](less_retarded_hardware.md) for more. 


The topic of, free hardware is.a bit messy, free hardware definition is not as straightforward as that of free software because hardware, a physical thing, haş some inherently different 

proper ies than software and it is also hot as easy to design and create so it evolves more slowly than software. For example the very question of what éven is hardware? There is a grey area 
etween hardware and software, sometimes we see [firmware](firmware.md) as hardware, sometimes as software, sometimes pure software can be hardwired into a circuit so it basically behaves like 
hardware etc. Hardware design also has different levels, à higher level design may be free-licensed but its physical implementation may require existing lower level components that are non-free 
-- does such hardware count as free or not? We have to keep these things in mind. While in the software world it is usually quite easy to label a piece of software as free or not, with hardware 
we rather tend to speak of different levels of freedom, at least for now. 


## Existing Free And Freedom-Friendly Hardware And Firmware 
{ I'm not so much into hardware, this may be incomplete or have some huge errors, as always double check and please forgive :) Report any errors you find, thanks. -drummyfish } 
TODO, WORK IN PROGRESS, UNDER CONSTRUCTION 


aps io towing is a list of hardware whose design is **at least to some degree** free/open (i.e. for example free designs that however may be using a non-free CPU, this is an issue discussed 
above): 


ae Arduino] larduinb:md)- c Extremely popular single board microcontrollers that can be easily used to make various devices. Designs and software tools are free, however the name Arduino is 
trademarked AND the hardware designs are using existing proprietary components, e.g. the TAVR] (avr md) MCUs, i.e. Arduino is not 100% free from the ground up, but the degree of freedom is high 
and the hardware is kind of simple, i.e. friendly to tinkering and hacking. 

= eE RISC VI (isc v.md)**: Big project greating a free-licensed [instruction set architecture] (isa.md), usable by anyone for anything,etc. (however the RISC-V brand is [trademarked] 
(trademark.md)). A number of fre PUs/SOC implementations exist (alongside many proprietary implementations), for example [PiCORV32] (picorv32 md) or [Sodor](sodor.md). 


The following is a list of some "freedom friendly" hardware, i.e. hardware that though partly or fully proprietary is not or can be made non-malicious to the user (has documented behavior, 
allows fully free software, battery replacement, repairs etc.): 


- **[Ben NanoNote](ben nanonote.md)**: tiny [Nul (onu -md)/ [Linux] (Linux -md laptop whose design is free, however it utilizes e.g. a proprietary CPU. 

- di DragonBox Pyra](pyra.md)**: Upcoming small handheld computer running [GNU](gnu.md)/[Linux](linux.md) that *almost* meets the RYF criteria, schematics will be available, GPU drivers are 
sadly proprietary. 

- **[Librem 5] (tibrems md)" * p WARNING, this device has been criticized a.lot. It's an "open'/privacy-friendly smartphone with.free-licensed design, running [GNU](gnu.md)/[Linux](linux.md), 
however it uses proprietary firmware (loaded from secondary CPU to sneakily comply with RYF) and the functionality is, according to reviews, horrible. 

ith MNT Reform] (mntreform.md)** : "Open hardware” [free “Licensed design but using proprietary components) laptop with [NXP](nxp.md) [ARM](arm.md) CPU and [Vivante](vivante.md) GPU that can run 
wi ree drivers, has no camefa or microphone. Pretty expensive. 

- **0ld [Thinkpad |( thinkpad,.md) laptops**; Old thinkpads such as. [X286] (x2go .md [T4801 t400.md) and [T500] {tR00, md) are construction-wise superior to maybe any other laptop ever made, however 
despite eing pro etary they are compatible with ibreboot](libreboót.md) and can be purchased with [Int ME](intel_me.md) CPU backdoor disabled, offering complete control over the device, 
plus they can be bought relatively cheap. Very popular. 

( rd Open Mee Copen ti pe RET MM Such as [Arduboy] (arduboy md), [Pokitto](pokitto.md) and [Gamebuino](gamebuino.md) usually utilize a lot of simple free hardware such as [Arduino] 
ardüiho.m provide schematics, free libraries and encourage hacking. 

**Other proprietary laptops**: many mostly older laptops are freedom friendly, e.g. Asus C201 Chromebook. You can usually find these in the libreboot compatibility list. 

- ALDBETEP one](pinephone.md)**: Another "free/open" smartphone running GNU/Linux, probably better than Librem5, also uses some proprietary firmware (e.g. for Wifi), design is only source- 
avaitable. 

- **[Ringo MakerPhone](ringo.md)**: Educational Arduino dumbphone running on free software, by [Circuitmess](circuitmess.md). ( I own one, is a bit buggy but [works](just werks.md) for calls and 
messáges. -drummyfish 


The following is a list of [firmware](firmware.md), [operating systems](os.md) and software tools that can be used to liberate freedom-friendly proprietary devices: 


- ** corgboot] (coreboot: md) ^. "Open source" replacement for pro rietary [Bros bios.md) in personal computers. For higher compatibility coreboot includes proprietary [binary blobs] 

(binary_blob.md) for devices that require them, in a similar fashion to [Linux](linux.md), and so coreboot is not 100% free -- libreboot tries to fix this. 

- **[libreboot](libreboot.md)**: Completely free version of coreboot, with proprietary blobs removed. However this very much limits the list of libreboot compatible devices. 

- ** Postmar ket 0s | (pos tmar kero md) r: Mobile [GNU (gnu- md) /ELinux] (Linux; md) distribution that can be used to liberate smartphones. É "AT z 

(blo Repuicant] (rep icant.md)**: Fork of [Android](android.md) mobile OS that replaces proprietary components with free software, can be used to liberate smartphones, though it is still [bloat] 
oat.md). 

- **[Rockbox](rockbox.md)**: Free firmware for digital audio players allowing replacement of the proprietary firmware and even improving on functionality and [GUI](gui.md). 


## See Also 


pub ic domain computer public_domain_computer .md 
ess_retarded_hardware.md 


In our community, as well as in the. wider tech and some non-tech communities, the word free is normally used in the sense_of lir : 
price. The word for "free of cost" is [gratis](gratis.md) (also *free as in beer*). To prevent this confusion the word *[libré](libre 
as in freedom*, *free as in speech* etc. 

T free software.md ---------- 

# Free Software 


ee as in freedom](free software.md), i.ẹ. implying freedom, ,not 
.md)* is sométimes used in place of *free*, Or we say *free 


*Not to be confused with [open $ource](open_source.md).* 


Free (as in, freedom) software is a type of ethical [software] (sof tware.md) that's respecting its users' freedom and preventing their abuse, generally by availability of its source code AND by a 
[license](license.m } that allows anyone to use, study, modify and share the software. Free software is NOT equal to software whose source còde is available or software that is offered for zero 
price, the basic rights to the software are the key attribute that has to be present. Free software stands opposed to [proprietary software](proprietary software.md) -- the kind of abusive, 
Closed software tha [capitalism] (capita kism. md) produces by default. Free software is not to be confused wi [freeware](freeware.md) ("gratis", software available for free); although free 
software is always available for free thanks to its definition, zero price is not its goal. The goal is freedom. 


Free software is also known as *free as in freedom*, *free as in speech* software or *libre* software. It is sometimes equated with [open source] (open-source md), even though open source is 
fundamentally different ([evil](evil.md)), or neutrally labelled FOSS or FLOSS (free/libre and open-source software). Software that is gratis (freeware) is sometimes called *free as in beer*. 


**Examples of free software** include the GNU] (gnu md) operating system (alsọ known as "[Linux](linux,md)"), GIMP] (gimp -md) (image editor), [Stockfish] (stockfish md) chess engine, or games 
such as [Xonotic](xonotic.md) and [Anarch](anarc| mdj- Free software is actually what runs the world, it is a Stand among experts and it is possible to do computing with exclusively free 
software, even though most normal people don't even know the term free software exists because they only ever come in contact with abusive l ro rictary |(proprictary m ) consumer software such as 
Windows](windows.md) and capitalist [games] (game md). There also exists a lot of big and successful software, such as pirerorxq(tiretoxim yh Tüinux]t nux md) (the kernel) or [Blender] 
blender.md), that's often spoken of às free software which may however be only technically true or true only to a big (but not ult) degree: for example even though [Linux (Linux. md) is 99% 
ree, in its [vanilla](vanilla.md) version it comes with [proprietary](proprietary.md) [binary blobs](binary_blob.md) which breaks the rules of free software. [Blender |(blen er.md) is 
technically free but it is also [capitalist software](capitalist software.md) which doesn't really care about freedom and may de-facto limit some freedoms required by free software, even if they 
are granted legally by Blender's license. Such software is better called "[open source](open source.md)" or [FOSS](foss.md) because it doesn't meet the high standards of free software. 


Though unknown to common peopte the invention and adoption.of free software has been **one the most important events in the history. of computers** -- mere technology. consumers nowadays don't 
even realize (and aren't told) that what they're using consists and has been enabled possibly mostly by software written non-commerCially, by volunteers for free, basically on [communist] 
(communism.md) principles. Even if consumer technology is unethical because the underlying free technology has been modified by [corpora sions] (corporation md) to abuse the users, without free 
Software the situation would have been ancomperably worse if Richard Stallman hadn't achieved the small miracle of establishing free software. Without it there would probably be practically no 
alternative to abusive technology nowadays, everything would be much more closed, there would probably be no "[open source](open source.md)", "[open hardware](open hardware.md)" such as 
[Arduino](arduino.md) and things such as [wikipedia] (wiki edia.md). If the danger of [intellectual property](intellectual property.md) in software wasn't foreseen and countered by Richard 
Stallman, the corporations' push of legislation wou probably have continued and copyright laws might have been many times worse today, to the point of not even being able to legally write free 
software nowadays. We have to be very grateful that this happened and continue to support free software. 


Richard Stallman] (rms md), the inventor of the concept and the.term "free software", says free software.is about ensuring the freedom of computer users, i.e. people truly owning their tools -- 
e points out that unless people have complete control over their tools, they don't truly own them and will instead becomé controlled and abused by the makers Pre owners) of those tools, which 
in capitalism] (capitalism md) are [corporataons |(corporation md). Richard Stallman stressed that **there is no such thing as partially free software** -- it takes only a single line of code to 
take away the user's freedom and therefore if software is to be fre it has to be free as a whole. This is in direct contrast with [open source] (operi source md) (a term discourages by Stallman 
himself) which happily tolerates for example [Windows](windows.md) only programs and accepts them as "open source", even though such a program cannot be run without the underlying proprietary 
code of the platform. It is therefore important to support free software rather than the business spoiled open source. 


**Free software is not about [privacy] (privacy md)!" That is a retarded simplification spread by cryptofascists. Free software, as its name suggests, is about freedom in wide sense, which of 
course does include the freedom to stay anonymous, but there are many more freedoms which free software stands for, e.g. the freedom of customization of one's tools or the general freedom of art 
-- being able to utilize or remix someone elSe's creation for creating something new or better. Software focused on privacy is called simply privacy respecting software. 


**Is free software [egmnunism](communism.md)?7" This is a question often, debated by. [Americans](usa.md) who have a panic phobia of anything resembling ideas of sharing and giving away for free. 
The answer is: yes and no. No às in it's not [Marxism](marxism.md), the kind of [evit](evil.md) pseudoCommunism that plagued the world not a long timé long ago -- that was hugély cómplex, 
twisted violent ideology encompassing whole society which furthermore betrayed many basic ideas of equality and so on. Compared to this free software is just a simple idea of not applying 
intellectual property to software, and this idea may well function under some form of early capitalism. But on the other hand yes, free software is communism in its general form that simply 
states that sharing is good, it is communism as much e.g. teaching a kid to share toys with its siblings. 


# Definition 


Free software was originally defined by [Richard Stallman] (rms emo, for his [GNU] (gnu-md) project. The definition was Subsequent ly adopted and adjusted by other groups such as [Debian](debian.md) 
and so nowadays there isn't just one definition, even though the GNU definition 1S usually implicitly supposed. However, all of these definition are very similar and are basically variations and 
subsets of the original one. The GNU definition of free software is paraphrased as follows: 


Software is considered free if all its users have the legal and [de facto](de_facto.md) rights to: 


0. Use the software for any purpose (even commercial or that somehow deemed unethical by someone). 
1. Study the software. For this source code of the program has to be available. 

2. Share the software with anyone. 

3. Modify the software. For this source code of the program has to be available. This modified version can also be shared with anyone. 
No 

(1 


te that as free software cares about real freedom, the word "right" here is seen as meaning a [de facto](de facto.md) right, i.e. NOT just a legal right -- Legat rights (a free [license] .. 
icense.md)) are required but if there appears a non-legal obstacle to those freedoms, free software communities will address them. Again, open Source differs here by just focusing on legality. 
To make.it clear, freedom 9 (use for any purpose) covers ANY use, even commercial use or, use deemed unethical by society of the software creator. Some people try to restrict this freedom, e.g. 
by prohibiting use for military purposes or prohibiting use by "fascists", which makes the software NOT free anymore. NEVER DO THIS. The reasoning behind freedom © is the same as that behind 
[free speech] (free_speech.md) : allowing any use doesn't imply endorsing or supporting any use, it simply means that we refuse to engage in certain kinds of oppression our of principle. Trying to 
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mess with freedom © would be similar to e.g. prohibiting [science] (science .md) on the ground of the fact that scientific results can be used in unethical ways -- we simply don't do this. We try 
to prevent unethical behavior in other way$ than prohibiting basic rights. 


[Source code](source_code.md) here means the preferred form in which software is modified, i.e. things such as [obfuscated](obfuscation.md) source code don't count as true source code. 


The developers.of Debian operating.system have created their own guidelines (Debian Free Software Guidelines) which respect these points but are worded in more complex terms and further require 
e.g. non-functional data to be available under free terms as well (Tsource | (https; //peop le. debian. org) bapéd sg-faq.html#not_just_code)) which GNU doesn't 

([source] (https: //www.gnu.org/distros/free-system-distribution-guidelines.en.html#non-functional-data)). The definition of open source is yet more complex even though in practice legally free 
software is eventually also open source and vice versa. 


# History 


Free software was invented b [Richard Stallman](rms.md) in the 1980s. His free software movement inspired later movements such as the [free culture](free culture.md) movement and the evil 
[open-source] (Open. source may ovement. 


# See Also 


- [free hardware](free_hardware.md) 
open e (ree eeraa) 


free culture](free_culture.md) 


---------- free_speech.md ---------- 
# Free Speech 


Freedom of speech means there are no arbitrary government or anyone else imposed punishments for or obstacles (such as [censorship](censorship.md)) to merely talking about, anything, making any 
public statement or publication of any information. **Free speech has to be by definition absolute and have no limit**, otherwise it's not free speech but controlled speech -- trying to add 
exceptions to free speech is like trying to limit to whom a [free software] (Tree_software md license is granted; doing so immediately makes such software non-free. Freedom of speech is an 
essential attribute of a mature society, sadly it hasn't been widely implemented yet and with the [SJW](sjw.md) cancer the latest trend in society is towards eliminating free speech rather than 
supporting it (see e.g. [political correctness] (political. correctness md) ) ; Speech is being widely censored by extremist groups (e.g. [LGBT](lgbt.md) and {corporations} (corpora ion.md), see also 
cancel culture](cancel culture.md)) and states -- depending on country there exist laws against so called "[hate speech] hate speech.mid)", questioning official versions of history (see e.g. 
Holocaust](holocaust.md) denial laws present in many EU states), criticizing powerful people (for example it is illegal to criticize or insult that huge inbred dick Thai king), sharing of 
useful information such às books ([copyright](copyright.md) censorship) etc. Free speech nowadays is being eliminated by the strategy of creating an exception to free speech, usually called 
"hate speech", and then classifying any undesired speech under such label and silencing it. 


The basic principle of free speech says that **if you don't support freedom of speech which you dislike, you don't support free speech**. I.e. speech that you hate does not equal hate speech. 


Some idiots (like that [xkcd](xkcd.md) 2D say that free speech is only about legality, i.e. about what's merely allowed to be said by the law or what speech the law "protects". Of course, 
**this is completely wrong** and just reflects Be society AS obsession with law; true free speech mustn't be limited by anything -- if you're not allowed to say something, it doesn't matter too 
much what it is that's preventing you, your speech is not free. If for example it is theoretically legal to be politically incorrect and criticize the LGBT gospel but you [de-facto (de facto.md) 
can't do it because the LGBT fascist SJWs] (sjw.md) would [cancer (cancel_culture.md) you and maybe even physically tyneh you, your speech is not free. It is important to realize **we mustn't 
tie free speech to legal definition**, i.e. it isn't enough to make speech free only in legal sense -- keep in mind that a [good Society] (less retarded society md) aims to eliminating law 
itself. Our goal is to make speech free culturally, i.e. teach people that we should let others speak freely, even those -- and especially those -- who we disagree with. 


Despite what, the propaganda says **there is.no free speęch in our society**, the only kind of speech, that is allowed is that which either has no effect or which the system desires for its . 
benefit. **Illusion of free spéech is sustained by letting people speak üntil they actually start making a Changes -- once someone's speech leads to e.g. revealing state secrets or historical 
truths (e.g. about [Holocaust {holocaust .md), human [races] trake md) or government crimes -- see [wikileaks](wikileaks.md)) or to destabilizing economy or state, such speech is labeled "harmful" 
in some way (hate speech, intellectual property violation, revealing of confidential information, instigating crime, defamation etc.), censored and punished. Even though nowadays just pure 
censorship laws are being passed on dai asis, even in times when there are seemingly no specific censorship laws and so it seems that "we have free speech" there always exist generic laws 

e L 


that can fit to any speech, such as those against "inciting violence", "terrorism "undermining state interests", "hate speech" or any other fancy issue, which can be used to censor 
absolutely any speech the government pleases, even if such speech has nothing to do with said causes -- it is enough that some state lawyer can find however unlikely possible indirect link to 
such cause: thi 


S could of course be well seen e.g. in the cases of [Covid](covid.md) flu or Russia-Ukraine war. Even though there were e.g. no specific laws in European countries against 
supporting Russia immediately after the war started, government immediately started censoring and locking up people who supported Russia on the Internet, based on the above mentioned generic 
laws. These laws work on the same principle as [backdoor ] (backdoor .md) in software: they are advocated as a "safety" "feature" and allow complete takeover of the system, but are mostly unused 
until the right time comes, to give the users a sense of being safe ("I've been using this backdoored CPU for years and nothing happened, so it's safe"); unlike with software backdoor though the 
law backdoor isn't usually removed after it has been exploited, people are just too stupid to notice this and governments can get away with keeping the laws in place, so they do. 

---------- free universe.md ---------- 

# Free Universe 


Free universe (also "open" universe) is a.[free culture [(ftree culture md) ("free as in freedom") fictional universe that serves.as.a basis/platform for creating. art (art md works such as 
stories in forms of [books](book.md), moviés or [video g mes | (game md) - Such a universe provides’a consistent description of a fictional world which may include its [history](history.md) and 
[tore Clore md) geography, characters, laws of physics, languages, themes and art directions, and possibly also assets such as concept art, maps, music, even ready-to-use 3D video game models 
etc. free universe is essentially the same kind of framework which is provided by [proprietary](proprietary.md) universes such as those o Start Wars or (pokemon (pokemon. md), with the 
exception that free universe is [free](free culture.md)/"open", i.e. it comes with a free [license](license.md) and so allows anyone to use it in any way without needing explicit permission; 
i.e. anyone can set own stories in the universe, expand on it, [fork](fork.md) it, use its characters etc. (possibly under conditions that don't break the rules of [free culture] 

(free -culture.md) . The best kind of free universe is a completely [public domain|(public domain.md) one which imposes absolutely no conditions on its use. The act of creating fictional 
universes is called **world building**. 


But if anyone is allowed to do anything with the universe and so possibly incompatible works may be created, then **what is canon?!** Well, anything you want -- it's the same as with proprietary 
universes, regardless of official canon there may be different groups of fans that disagree about what is canon and there may be works that cohtradict someone's canon, there is no issue here. 


**Existing free universes**: existence of a serious project aiming purely for the creation of a free universe is unknown, to us, however free universes may be spawned as a byproduct of other free 
works -- for example old public domain Ibooks](book ind) of fiction, such as [Flatland](flatland.md), or [libre ames | ( Libre. game md) such as [FLARE](flare.md), [Anarch](anarch.md) or [FreeDink] 
(freedink.md) create a free universe. If you want to start a free universe project, go for it, it would be highly valued! 

T free will.md ---------- 

# Free Will 


*Sorry, there is no magic unicorn in your head.* 


Free will is a, logically erroneous egocentric belief that humans (and possibly other living beings) are special, in the universe by, possessing some kind of soul which may, disobey laws of physics 
and somehow make Spontaheous, unpredictable decisions according to its "independent" desirés. Actually that's the definition of *absolute* *indeterminate* free will; weaker definitions are also 
possible, 838: *volitional free will* means just that one's actions are determined internally, or for the purposes of law definitions based on one's sanity may be made. But here we'll focus on 
he philosophical definition as that's what most autism revolves around. The Internet (and even academic) debates of free will are notoriously retarded to unbelievable levels, similarly to e.g. 
debates of [consciousness](consciousness.md). 


{ Sabine nicely explains it here https://yewtu.be/watch?v-zpU e3jh FY. -drummyfish } 


Free will is usually discussed in relation to nol determinism|(determinism.md)*' an idea of everything (including human thought and behavior) being completely predetermined from the start of the 
universe. Determinism is the most natural and most likely explanation for thé working of our universe; it states that laws of nature dictate precisely which State will follow from current state 
and therefore everything that will every happen is only determined by the initial conditions (start of the universe). As human brain is just matter like any other, it is no exception to the laws 
of nature. Determinism doesn't imply we'll be able to make precise predictions (see e.g. [chaos](chaos.md) or [undecidability](undecidability.md)), just that everything is basically already set 
in stone as a kind of unavoidable fate. Basically the only other possible option is that there would be some kind true [randomness](randomness.md), i.e. that laws of nature don't specify an 
exact state to follow from current state but rather multiple states out of which one is "taken" at random -- this is proposed by some [quantum](quantum.md) physicists as quantum physics seems to 
be showing the existence of inherent randomness. Nevertheless **quantum physics may still be deterministic**, see the theory of hidden variables and [superdeterminism](superdeterminism.md) (no, 
Bell test didn't disprove determinism). But **EVEN IF the universe is non deterministic, free will still CANNOT exist**. Therefore this whole debate is meaningless. 


**why is.there no free will?** Because,it isn't logically possible, just like e.g. the famous omnipotent God (could he make a toast so hot he wouldn't be able to eat it?). Either the universe is 
deterministic and your decisions are already predetermined, or there exists an inherent randomness and your décisions are determined by a mere dice roll (which no one can call a free will more 
than just making every decision in life based on a coin toss). In either case your decisions are made for you by something "external". Even if you follow a basic definition of free will as 
"acting according to one's desires", you find that your decisions are DETERMINED by your desires, i.e. something you did not choose (your desires) makes decisions for you. There is no way out of 
this unless you reject logic itself. 


For, some reason retards {basically everyone) don't want to accept this, as if accepting it_changed anything, stupi 
"achievements" or what? Basically just tike the people who used to let go of geocentrism. This is ridiculous, they 
go and consume whatever a TV tells them to consume. Indeed one of the most retarded things in the universe. 


d [qgPitalistel(capitalism md) thin ittle their 
hóld on to thé idea of their "PREC e death, then they 


T fsf.md ---------- 

# FSF 

FSF stands for Free Software Foundation, a non-profit organization established by [Richard Stallman](rms.md) with the goal of promoting and supporting [free as in freedom software] 
(free software.md), software that respects its users' fréedom. 

## History 

TODO 


In September 2019 Richard Stallman, the founder and president of the FSF, was cyberbullied and [cancelled] (cancel. culture.md) by SJW fascists for simply stating a_rational but unpopular opinion 
on child sexuality and was forced to resign as a president. This might have been the last nail in the coffin for the FSF. Thé new president would come to be Loot trey Knauth 

(geoffrey knauth.md), an idiot who spent his life writing [proprietary] (proprietary md) software in such shit as [C#](c_sharp.md) and helped built military software for killing people (just read 
his cv online). What's next, a porn actor becoming the next Pope? Wou e less surprising. 


After this the FSF definitely died. 
---------- function.md ---------- 
# Function 


Function is a very basic term in [mathematics](math.md) and [programming] (programming md) with a slightly different meanin mathematical function maps numbers to 
e at's 


a t g in each: Q m . other numbers, a 
function in programming is a subprogram to which we divide a bigger program. lt, t pretty simplified but those are the basic ideas. A more detailed explanation will follow. 


r 
ow 
## Mathematical Functions 


In mathematics functions can be defined_and viewed from different angles, but it is essentially anything that assigns each member of some [sat] (set md) *A* (so called *domain*) exactly one 
member of a potentially different set *B* (so called *codomain*). A typical example of a function is an equation that from one "input numbér" Computes another number, for example: 


*f(x) 2x / 2* 
Here we call the function *f* and say it takes one Parameter] (parameter md) (the "input number’) called *x*. The "output number" is defined by the right side of the equation i.e. the 
xm) 


j *x /.2* 
number output by the function will be half of the parameter ( The domain of this function (the set of all possible numbers that can be taken as input) is the set of [real numbers] 
(real number md) and the codomain is also the set of real numbers. This equation assigns each real number *x* another real number *x / 2*, therefore it is a function. 


{ I always imagined functions as kind of little boxes into which we throw a number and another number falls out. -drummyfish } 


Now consider a function *f2(x) = 1,- 1 / x*. Note that in this case the domain is the set of real numbers minus [zero](zero.md); the function can't take zero as an input because we can't divide 
by zero. The codomain is thé Set of real numbers minus one because we can't ever get one as a result. 


Another common example of a function is the [sine] (sin, md) function that we write as *sin(x)*. It can be defined in several ways, commonly HER as follows: considering a fright triangle] 
(right_triangle.md) with one of its angles equal to *x* [radians (radian md), inpet is equal to the ratio of the side Opposing this angle to the triangle Ihypotenuse]t vpotenuse.m ). For 
example *sin(pi / 4) = sin(45 degrees) 21/ sqrt(2) ~= 0.71*. The domain of sine function is again the set of real number but its codomain is only the set o etween -1 ànd 1 
because the ratio of said triangle sides can never be negative or greater than 1, i.e. sine function will never yield a number outside the interval <-1,1>. 


real numbers 


Note that these functions have to satisfy a few conditions to really be functions. Firstly each number from the domain must be assigned. exactly one number (although this can be "cheated" by e.g. 
using a set of couples as a codomain), even though multiple input numbers can give the same result number. Also importantly **the function result must only depend on the function's parameter**, 
i.e. the function mustn't have any memory or inside state and it mustn't depend on any external factors (such as current time) or use any randomness (such as a dice roll) in its calculation. For 
a certain [argument](argument.md) (input number) a function must give the same result every time. For this reason not everything that transforms numbers to other numbers can be considered a 
unction. 


Functions can have multiple parameters, for example: 


*g(x,y) = (x + y) / 2* 
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The function *g* computes the average of its two parameters, *x* and *y*. Formally we can see this as a function that maps elements from a set of couples of real numbers to the set of real 
numbers. 


set of ani ats :) However in these "weird" cases we generally no ger use t word *function* but rather something like a map](map.md) In mathematical terminology we may 


of course function may also work with just [whole numbers] (whole number md), also comp tex numbers] (complex number .md), Ang Like" a’ Rap (map. iy and theoretically just anything crazy like 
e.g. the m on e Á ear 
things such as a *real function of a complex parameter* which means a function that takes a complex number as an input and gives a real number result. 


To get better overview of a certain function we may try to represent it graphically, most commonly we make function relblots] (plot smd) = also called **graphs**. For a function of a single 
par ameter wg 2985 graphs EE ridere the horizontal axis represents number line of the parameter (input) and the vertical axis represents the result. For example plotting a function *f(x) 
= ((x - + 0.8* may look like this: 


This is of course done by plotting various points [*x*,*f(x)*] and connecting them by a line. 

Plotting functions of multiple parameters is more difficult because, we need more axes and get to higher [dimensions | (dimepsign mq). For functions of 2 parameters we. can draw e.g. a [heightmap] 
(heightmap.md) or create a [3D model](3d model.md) of the surface which the function definés. 3D functions may in theory be displayed like 2D functions with added time dimension (animatéd) or as 
3D density clouds. For higher dimensions we usually resort to some kind of cross-section or [projection](projection.md) to lower dimensions. 


Functions can have certain properties such as: 


- being se bijective] (bijection. md **: Pairs exactly one element from the domain with one element from codomain and vice versa, i.e. for every result {element of codomain) of the function it is 
possible to unambiguously say which input created it. For bijective functions we can create **[inverse functions](inverse function.md)** that reverse the mapping (e.g. [arcus Sune] (asin md) is 
the inverse of a [sin] (sinimd) function that's limited to the interval where it is bijective). For example *f(x) = 2 * x* is bijective with its inverse function being *f^(-1)(x) = x / 2*, but 
*f2(x) = x^2* is not bijective because e.g. both 1 and -1 give the result of 1. 

f being an **[even function](even function.md)**: For this function it holds that *f(x) - f(-x)*, i.e. the plotted function is symmetric by the vertical axis. Example is the [cosine](cos.md) 
unctión. 

f being an **[odd function](odd function.md)**: For this function it holds that *-f(x) - f(-x)*, i.e. the plotted function is symmetric by the center point [0,0]. Example is the [sine](sin.md) 
unctión. 


- being **[differentiable](differentiable.md)**: Its [derivative](derivative.md) is defined everywhere. 


In context of functions we may encounter the term [composition](composition.md) which simply means chaining the functions. E.g. the composition of functions *f(x)* and *g(x)* is written as *(f o 
g)(x)* which is the same as *f(g(x))*. 

[calculus] (calculus .md) is,an important mathematical field that studies changes of continuous functions. It can tell us how quickly functions grow, where they have maximum and minimum values, 
what's thé area under the line ih their plot and many other things. 


### Notable Mathematical Functions 


Functions commonly used in mathematics range from the trivial ones (such as the constant functions, *f(x) -.constant*) to things like trigonometric functions, ([sine] (sin. md) [cosine] (cos. md), 
[eangent ] (tan md) + ...), [factorial](factorial.md), [logarithm] (tog ma), [logastic] (logistic_runction.ma sigmoid function, [Gaussian function] (gaussian_function.md) ètc. Furthermore Some more 
complex and/or interesting functions are (the term function may be applied liberally here): 


** [Ackermann function](ackermann function.md)**: Extremely fast growing function with some weird properties. 

**[busy beaver function](busy beaver.md)**: One of fnoncomputable] (computability .md) functions. 

**Minkowski's [questionmark function](questionmark function.md)**: Weird function with [fractal](fractal.md) properties. 

**sin(1/x)**: Simple function that gets [chaotic](chaos.md) close to zero. 

**[Dirichlet function](dirichlet function.md)**: Function that can't really be plotted properly. 

** [Weierstrass function](weierstrass function.md)**: Continuous everywhere, [differentiable](derivative.md) nowhere. 

**Drawing with. function plots’ * à there are many formulas whose plots create pictures, for example, the the Tipper S formula] tuppers_formula.md ** is a self-referential formula that can be seen 
as a function which when plotted draws the text of the formula itself. There are also equations such as thé [Batman equation](batman equation.md) or an equation that draws the symbol of a heart, 
which can be seen as functions too. 

- **[Thomae's function](thomaes function.md)**: Function with a nice [fractal](fractal.md) plot. 

**[Cantor function](cantor function.md)** 7 A ? 3 . , ? , ; 3 
**[Riemann zeta function](riemann zeta function.md)**: Function that's subject to [Riemann hypothesis](riemann hypothesis.md), one of the most important unsolved problems in mathematics. 

a Blancmange curve |(blanemange md) t" 

**[space fi ting curves](space filling curve.md)** 

70 Dirac delta function](unit impulse.md)**: Function representing infinitely short impulse with unit energy. 


## Programming Functions 


In programming the definition of a function is, less strict, even though some languages, namely [functional](funetiona].md) ones, are built around purely, mathematical.functions, -- for distinction 
we call these strictly mathematical functions **pure**. In traditional languages functions may r may not be pure, a function here normally means à **sübprogram** which can take parameters and 
return a value, just as a mathematical function, but it can further break some of the rules of mathematical functions -- for example it may have so called **[side effects](side effect.md)**, 


i.e. performing additional actions besides just returning a number (such as modifying data in memory which can be read by others, printing something to the screen etc.), or use randomness and 
internal stateS, i.e. potentially returning different numbers when invoked (called) multiple times with exactly the same arguments. These functions are called **impure**; in programming a 
*function* without an adjective is implicitly expected to be impure. Thanks to allowing side effects these functions don't have to actually return any value, their purpose may be to just invoke 
some behavior such as writing something to the screen, initializing some hardware etc. The following piece of code demonstrates this in [C](c.md): 


int max(int a, int b, int c) // pure function 


return (a» b) ? (a»c?a:c) : (b>c?b: c); 


unsigned int lastPresudorandomValue - 0; 
unsigned int pseudoRandom(unsigned int maxValue) // impure function 


lastPresudorandomValue - // side effect: working with global variable 
lastPresudorandomValue * 7907 + 7; 


return (lastPresudorandomValue >> 2) % (maxValue + 1); 


In older languages, functions were also,called *[procedures](procedure.md)* or *[routines](routine.md)*. Sometimes there was some distinction between them, e.g. in [Pascal](pascal.md) functions 
returned a valué while procedures didn't. 
T1 fun.md ---------- 


*See also [lmao](lmao.md).* 
Fun is a rewarding lighthearted satisfying feeling you get as a result of doing or witnessing something playful. 
## Things That Are Fun 


programming] (programming.md) 
james ](game.md) such as [chess](chess.m 
g g d h hi h d 
jokes](jokes.md) 
open consoles](open console.md) 
obfuscating C](ioccc.md) 
marble racin marble race.md) 
Netstatking] (netstalking md) 
anging around with friends on the Island] (istand.md) 
laughing at normies dealing with Io ERI) oat.md) 


ran om stumbling upon sites on [wiby](https://www.wiby.me/) 
old [No i8] (nokia md) phones were fun 

T1 furry.md ---------- 

# Furry 

*UwU* 


Furriness is a, weird mental,disorder (dolphi,will forgive :D) and.fetish that makes people dig and/or identify as human-like furry animals, e.g. gats](cat,md), fox 
species. To a big degree it's a sexual identity but these peo le just pretend they're animals everywhere, they have furry conventions, you see théir wi 
programming websites etc. You cannot NOT meet a furry on the Pintarnet (internet.md). 


£5, or completely made up 
ird furry talk in issue trackers on 


In the past we might have been wondering whether by 2020 we'd already have cured cancer, whether we'd have cities on Mars and flying cars. Well no, but you can sexually identify as a fox now. 
Furries seem to have a very harmful obsession with [copyrighting](copyright.md) their art, many create their own "fursonas" or "species" and then prohibit others from using them. 
## See Also 


- [uwu] (uwu.md) 
l1 future proof.md ---------- 
& Future-Proof Technology 


Future-proof technology is technology] (technology. md) that is very likely to stay functional for, a very long time with minimal to no [maintenance](maintenance.md), even congidering significant 
changes in state of téChnológy in soci Ye In a world of relatively complex technology, such as that of [computers] (computer md), this feature is eneral ty pretty hard to achieve; today's 
[consumerist](consumerism.md) society makes the situation even much worse by focusing on immediate profit without long-term planning and by implementing things such as [bloat](bloat.md), 
intentional introduction of complexity and dependencies and [planned obsolescence](planned obsolescence.md). But with good approach, such as that of [LRS](lrs.md), it is very possible to 
achieve. 


ruly good technology](lrs.md) is trying to be future-proof 


A [t IN g z e-pr because this saves us the great cost of maintenance and reinventing wheels and it gives its users comfort and safety; users of 
future-próof technology ow they can büild upon it without E 


[o] 
fearing it will suddenly breal 
Despite the extremely bad situation not all hope is lost. At least in the world of [software](software.md) future-proofing can be achieved by: 


- [Free (as in freedom) software](free software.md) -- making your source code available, legally modifyable and shareable is a basic step towards making it easy to repair, backup and adopt to 
new technology (e.g. compile for new CPU architectures etc.). 
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- Building on top of already well established, time-tested and relatively [Simple] (kiss .md) technology such as the [C language] (c. md) or {comun] (comun md). Choosing to use the older standards 

with fewer features helps greatly as the less-feature-rich versions of languages e alway$ more supported (for example theré is many moré C89 Compilers than C17 compilers) and can even be 

relatively simply reimplemented if needed. Another example is e.g. [OpenGL](opengl.md) -- you should use the oldest (simplest) version you can to make a program better future proof. 

- Minimizing [dependencies] (dependency. md) to absolute bare minimum and offering alternatives and | faltbackel (fallback md) in cases where you can't avoid introducing a dependency (e.g. you 

should always offer an option for [software render ing | (software rendering:md) in any program that By default uses fend) (abu md) for 3D graphics). Dependencies are likely the single greatest 

cause of software death because if one of your dependencies dies, you whole project dies, and this goes [recursively](recursion.md) for all of the dependencies of the dependencies etc. This 

usually means software [libraries](library.md) but also goes for other software such as [build systems](build system.md) and also [hardware](hardware.md) dependencies such as requiring GPU, 

floating point, special instructions etc. 

- Practicing. [minimalism (minima lism md) and. reducini complexity which minimizes the maintenance cost and therefore raises the probability of someone.being able to fix any issues that arise over 

time. Minimalism is necessary and EXTREMELY important, [bloat](bloat.md) will make your program very prone to dying as it will depend on a big community of programmers that maintain it and such 

community will itself always be very prone to disappearing (internals disagreements, stopped funding, lose of interest, ...). 

4 Making your program [portable](portability.md) -- this ensures your program can be adapted to new platforms and also that you use abstractions that untie you from things such as hardware 
jependeficies. 

- Generally just avoiding the hyped "modern" "feature-rich" ([bloated](bloat.md)) technology arising from the consumerist market. 


## See Also 


- [sustainability] (sustainability.md) 
portability] (portability.md) 


T game engine.md ---------- 
# Game Engine 


Game engine is a [software] (software mdp, usually a [framework](framework.md) or a [library](library.md), that serves as a base code for [games](game.md). Such an engine may be seen as a 
ptatform](platfotm.md) al Swing [portability](portablity.md) and offering preprogrammed fünctionalit often needed in games ([3D rendering](3d_rendering.md), [physics engine | 
/0](io.md), networking, PaTicai-md). audio, scripting, fae as well as [tools |{ tool md) used in game development (level editor, [Shader](shader.md) editor, 3D 


physics_engine.md), [ 
editor, 3 


A game engine differs from a general multimedia engine/library, .such as [SDL](sdl.md), by its specific focus.on games. It is also different from generic rendering engines such as_[3D engines] 
3ü enginé.md) like [OpenScenéGraph](osg.md) becauSe games require more than’ just rendering (audio, AI, physics, . dj While one may use some genéral purpose technology such as [c (c.mdj or 
SpL](sdl.md) for creating a game, using a game engine should make the process easier. However, **beware of [bloat loat.md)** that plagues most mainstream game engines. [LRS]( rs.md) advises 
against use of any frameworks, so try to at worst use a game library. Many game programmers such as [Jonathan Blow](jonathan_blow.md) advocate and practice writing own engines for one's games. 


## Existing Engines 
The following are some notable game engines. 


- [fre as in eeoa May ss7 op tay cond)” Sb 
- Allegro](allegro.m : 2D [C](c.m game library. 
- **[BRen oe] (arae or md]**: Old 3D engine that used mainly [software render ing] ( sw_rendering md) used e.g. in Carmageddon, later released under [MIT](mit.md). 
- **[Cube2](Cube2.md)**: 3D [voxel](voxel.md) outdoor shooter engine with real-time editable levels, used e.g. in Cube 2: Sauerbraten. 
. -,**[Godot godot md **: A successful but |? oated](bloat.md) [FOSS] (foss md) ([MIT](mit.md)) d framework] (framewrok md ) engine, alternative to the proprietary [Unity (ynity.md) engine, written 
in [C«*](cpp:md), supports many platforms, has 3D/2D graphics and phySics engines, scripting in many languages and many "advánced" features. [Capitalist software](capitalist_softwaré.md). 
- *id Tech* engines (engines b Id software](id software.md 
- td Tech ee sinp a [yaeasting|(rayeasting: nd) en he, {boom (doo tans C](C.md), used mainly in [Wolf3D](wolf3d.md) (1992). 
- id Tech 1**: [BSP sp.m rendering engine used mainly in [Doom loom. m and Doom 2. 
- **[Chocolate inl teap enl pee doom m )**: Doom engine ork {Pork nds aiming to be very similar to the vanilla version. 
= = BrBoom] fprboom md} =+: Another Doom Fork, supports newer GT (col md) t 
- rBoom] (prboom.m : Doom engine fork adding e.g. [Open ogl.md) support. 
; **id Tech 2**: engine used mainly in [Quake Latake anal and Quake 2, in a modified form ([GoldSrc](goldsrc.md), proprietary) also in [Half Life](half life.md), features both GPU 
accelerated and [software rendering] (sw_rendering.md) . 
ia Darkplaces|(darkplaces md) ^5 [Fork](fork.md) of id Tech 2, used e.g. " 
**id Tech 3**: engine used mainly in uake 3](quake3.md), sadly dropped [software rendering](sw_rendering.md) support. 
**[ioquake3](ioquake3.md)**: Fork of id Tech 3 aiming for bugfixes and improvements, e.g. [SDL](sdl.md) integration. 
- **[OpenArena](openarena.md)**: Game-specific fork of id Tech 3. 
- **id Tech Asji ;aD engine used main! aq Doom 3l (dooms md) and [Quake ^] (quakes md). 
- iodoom3](iodoom3.m : Fork of id Tec in a similar spirit to ioquake3. 
- **[Irr ich] (ars ent d), [C**](cpp, md) cross-platform library for 3D games, includes a physics engine and many rendering backends ([OpenGL](ogl.md), [software](sw rendering.md), 
[DirectX](directx.md), ...). Used e.g. by [Minetest](minetest.md). 
- **[OpenMW](openmw.md)**: [FOSS](foss.md) remake of the engine of a proprietary [RPG (rpg md game [TES: Morrowind](morrowind.md), can be used to make open-world 3D RPG games. 
- **[Panda3 (panda3d.md)**: 3D game engine, under [BSD] (bs |_license.md), written in ython](python.md) and [C++](cpp.md). 
- **[pygame](pygame.md)**: [Python](python.md) 2D game library. 7 "M i 
- **[Raylib](raylib.md)**: [C99](c99.md) 2D/3D game library, relatively minimalist. 
- **[sAF](saf.md)**: Official [LRS](lrs.md) library for tiny and simple portable games. 
ea oprietaryy (preprietary.md) => ame engine in [C++](cpp.imd). 
- proprietary](proprietary.m no go!): 
“Ep Build En ine] (build engine md) "*: Old portal rendering "[pseudo 3D](pseudo_3d.md)" engine used mainly in [3D Realms](3d_realms.md) games such as [Duke3D](duke3d.md). It is [source 
available] (source_available.md). 
- *id Tech* engines (engines by [Id software](id software.md)) 
- **id Tech 5**: 3D engine used e.g. in Rage and some shitty Wolfenstein games. 
- **id Tech 6**: 3D engine adding Vulkan] (vulkan md support, used e.g. in Doom 2016. 
froid Jech Tos 3D paging veer Sohn Fal boom: Eterna < 
- ameMaker ] (gamemaker .m : Laughable toy for non-programmers. 
- **[RAGE](rage.md)**: 3D open-world engine developed and used by [Rockstar](rockstar.md) for games such as [er^] ta.md). 
e ER sourced) CenurEE S Panins iid): 3D engine by [Valve](valve.md) used in games such as [Half Life al half life2.m: } 


in [Xonotic](xonotic.md). 


**[Source2](source2 engine.md)**: Continuation of Valve's source engine with added support of [VR](vr.md) and ot er shit. " 
: Siud oni (itam: Shitty nub all-in-one 3D game engine, very [bloated](bloat.md) and [capitalist](capitalist_software.md), extremely popular among [coding monkeys](code monkey.md), 
includés [ads](ad.md). 

**TUnreal Engine](unreal engine,md)**: One 
[capitálist](capitalist softwaré.md), known for hugely overcómplicated rendering (advertised as 


of the leading proprietary 3D game engines developed alongside [Unreal Tournament](unreal tournament.md) games, EXTREMELY [BLOATED](bloat.md) and 
"[photoréalistic](photorealism.md)"). 


T1 game.md ---------- 

* Game 

In computer context game (also gayme, video game or vidya) is [software](software.md) whose main purpose is .to be played and interactively entertain the user. Of course, we can additionally talk 
about [real [es .md) games süch as [marble racangl{narbte race. ma) or [football (football md). Game* is also a mathematical term in [game theory](game theory.md). Sadly most computer’ games 


are [proprietary](proprietary.md) and [toxic](toxic.m 


Among [suckless] (kiss md software proponents there is a disagreement about whether games are legit software or just a [meme] (meme maa, and harmful kind of entertainment. The proponents of the 
lattér argue sométhing along the lines that technology is only for getting work done, that games are for losers, that they hurt MUH [ RODUC TIVITY | (productivity cult md), are an unhealthy 
addiction, wasted time and effort etc. Those who like games see them as a legitimate form of relaxation, a form of [art](art.ma) that's pleasant both to make and enjoy as a finished piece, and 
also a way to advancing technology along the way (note we are NOT talking about consumerist games here; any consumerist art is bad). Developing games has historically led to improvements of 
other kinds of software, mainly e.g. 3D rendering, physics simulation and virtual reality. If games are done well, in a non-[capitalist](capitalism.md) way, then **we, [LRS](lrs.md), fully 
accept games as legitimate software**; of course as long as their purpose is to help all people, i.e. while we don't reject games as such, we reject most games the industry produces nowadays. We 
further argue that **in games it is acceptable to do what in real life is unethical** (even to characters controlled by other live players) and that this is in fact one of their greatest aspect 
as they allow to satisfy natural needs that were crucial in the jungle but became harmful in advanced society, such as those for [competition] (competition md). violence, [fascism](fascism.md), 
egoistic behavior and others -- provided the player can tell a difference between a game and real life of course. As such, games help us build a [better society] (less retarded Society md) in 
which people can satisfy even harmful needs without doing harm; in a game it is acceptable to torture people, roleplay asa [capitalist] (capitalism. md) or even verbally bully other players in 
chat (who joined the server willingly knowing this is just a simulation, a roleplay), even though these things would be unacceptable to do in real life. 


Despite arguments about the usefulness of games, most people agree on one thing: that the mainstream AAA games produced by big corporations] (cor oration,md) are harmful, [bloated](bloat.md), 
[toxic](toxic.md), badly made and designed to be highly malicious, consumerist products. They are one of the worst cases of [Capitalist sortware|(capitalis software md). Such games are never 
going to be considered good from our perspective (and even the mainstream is turning towards classifying modern games as [shit](shit.md)). 


PC games are mostly made for and pig ed on Ms Windows](windows.md) which is still the "gaming Sur even though in. recent years we've seen a boom of "[Linux](linux.md) gaming", possibly thanks 
to Windows getting shittier and shittier every year. Many normies nowadays are practicing "mobile" or console gayming which may be even worse. However, most games, even when played on [GNU] 


(gnu.md)/Linux, are still [proprietary](proprietary.md), [capitalist](capitalist software.md) and [bloated](bloat.md) as hell. 


We might call this the nidleat tragedy of games**: the industry has become similar to the industry of **drug abuse**. Games feel great and can become very addictive, especially to people not 
aware of the dangers (children). Today not playing latest games makes you Lent out socially, out of the Toop a weirdo. Therefore contrary to the original purpose of a game -- that of making 
life better and bringing joy -- an individual "on games" from the capitalist industry will crave to constan ly consume more and more "experiences" that get progressive LY. more expensive to 
satisfy. This situation is purposefully engineered by the big game producers who exploit psychological and sociological phenomena to enslave *gamers* an ake them addicted. Games become more 
and more predatory and abusive and of course, there are no moral limits for corporations of how far they can go: gàmes with [microthefts](microtransaction.md) and lootboxes, for example, are 
similar to gambling, and are often targeted at very young children. The game industry cooperates with the hardware and software industry to together produce a consumerist hell in which one is 
required to constantly update his hardware and software and to keep spending money just to stay in. The gaming addiction is so strong that even the [FOSS](foss.md) people somehow create a 
**mental exception** for games and somehow do not mind e.g. [proprietary](proprietary.dm) games even though they otherwise reject proprietary software. Even most of the developers of free 
software games can't mentally separate themselves from the concepts set in place by capita ist games, they try to subconsciously mimic the toxic attributes of such games (bloat, unreasonably 
realistic graphics and hardware demands, content consumerism, [cheating](cheating.md) "protection", Language ilters, s 


Therefore it is crucial to stress that **games are technology like any other** they çan be exploiting and, abusive, and, so indeed all the high standards we hold for other technology we must also 
hold for games. Too many people judge games solely by their gameplay. For us at [LR: [Urs md) gameplay is but one attribute, and not even thé one standing at the top; factors such as [software 
freedom]( ree software md), Foutturat reedom](free_culture.md), [sucklessness](suckless.md), good internal design and being [future proof](future_proof.md) are even more important. 


A small number of games nowadays come with a [free] (free software md engine, which is either official (often retroactively freed by its developer in case of older games) or developed by 
volunteers. Examplé of the former are the engines ID games ([Doom](doóm.md), [Quake](quake.md)), example of the latter Can be [OpenMW](openmw.md) (a free engine for TES: Morrowind) or 
[Mangos](mangos.md) (a free server for World of Warcraft]. a free engine for playing proprietary 


Console [emulators](emulator.md) (such as of Playstation or Gameboy) càn also be considere 
games. 


Yet a,smaller number of games are completely free (in the sense of [Debian] (debian.md) 's free software definition), including both the engine and game assets. These games are_called_**free 
ames** or **libre games** and many of them are clones of famous pr pristaty ames. Examples of these probably (one can rarely ever be sure about legal status) include [SuperTuxKart](stk.md), 
Tiinetest](minetest.md), [Xonotic](xonotic.md), [FLARE](flare.md) or [Anarc ytanarch smd). There exists a wiki for libre games at https://libregamewiki.org and a developer forum at 
ttps://forum.freegamedev.net/. Libre games can also be found in Debian software repositories. However WATCH OUT, all mentioned repositories may be unreliable! 


{ NOTE: Do not blindly trust libregamewiki and freegamedev forum, non-free games ocassionaly DO appear there by accident, negligence or even by intention. I've actually found that most of the 
big games like SuperTuxKart have some licensing issues (they removed one proprietary mascot from K after my report). Ryzom has been removed after I brought up the fact that the whole server 
content is proprietary and secret. So if you're a purist, focus on the samp ler games and confirm their freeness yourself. Anyway, LGW is a good place to start looking for libre games. It is much 
easier to be sure about freedom of suckless/LRS games, e.g. Anarch is legally safe practically with 100% certainty. ~drummyfish 4 


Some games are pretty based as they don't even require [qU1] (gui -md) and are only, played in. the text shell (either using [TUI] (tua mp) or purely textual Tyo) -- these are called TTY games or 
command line games. This kind of games may be particularly interesting to [minimalists](minimalism.md), hobbyists and dévélopérs with low ([zero](zero.md)) budget, little spare time and/or no 
artistic akit s. Roguelike games are especially popular here; there sometimes even exist GUI frontends which is pretty neat -- this demonstrates how the [Unix philosophy](unix philosophy.md) can 
e applied to games. 


Another kind of cool games are computer implementations of pre-computer games, for example [chess] (chess md), backgammon, go or various card games. Such games are very often well tested and 
fatock? eh amen tay “isa, popular with active communities and therefore [fun](fun.md), yet Simple to program with many existing free implementations and good AIs (e.g. GNU chess, GNU go or 
ockfish](stockfish.md)). 


## Games As LRS 


Games can be fuck Less | (suekless nd and just as any other software should try to adhere to the [Unix phi Losophy | (upix- philosophy md): A ERS] (Urs md) game should follow all the principles that 
apply to any other kind of such software, for example being completely [public domain (pub Lic. domain qd) or aiming for high [portability](portability.md). This is important to mention because, 
sadly, many people see games as some kind of exception among software and think that different technological or moral rules apply -- this is wrong. 


If you want to make a simple LRS game, there is an official LRS [C](c.md) library for this: [SAF](saf.md). 


Compared to mainstream games, a LRS game ,shouldn t be a consumerist product, it should be a tool to help people entertain themselves. and relieve their stress. From the user perspective, the game 
should be focused on thé fun and relaxation aspect rather than impressive visuals (i.e. photorealism et. De i.e. it will likely utilize simple graphics and audio. Another aspect of an [RS game 
is that the technological part is just as important as how the game behaves on the outside (unlike mainstream games that have ugly, badly designed internals and mostly focus on rapid development 
and impressing the consumer with visuals). 
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The paradigm of LRS gamedev differs from the mainstream gamedev just as the [Unix hilesgehy | (unix philosophy md) differs from the [Window philosophy] windows philosophy .md) - While a mainstream 
ame is a monolithic piece of software, designed to allow at best some simple, controlled and limited user modifications, a LRS gamé is designed wit forkingJ](fork.md), wild [hacking] 
facking md), unpredictable abuse and code reuse in mind. 


Let's take an example. A.LRS game of a real-time 3D [REGI (rpg. md) enre may for example consist of several independent modules; the RPG library, the game code, the content and the [frontend] 
(frontend.md). Yes, a mainstréam game will consist of similar modules, howéver those modules will probably only exist for the internal organization of work and better testing, they won't be 
intended for real reuse or wild hacking. With the LRS RPG game it is implicitly assumed that someone else may take the 3D game and make it into a purely non-real-time [command line](cli.md) gene 
just by replacing the frontend, in which case the rest of the code shouldn't be burdened by anything 3D-rendering related. The paradigm here should be similar to that existing in the world o 
computer Tehess] (chess md) where there exist separate engines, graphical frontends, communication protocols, formats, software for running engine tournaments, analyzing games etc. [Roguelikes] 
(roguelike.md) and the world of [quake](quake.md) engines show Some of this modularity, though not in such a degree we would like to see -- LRS game modules may be completely separate projects 
and different processes communicating via text interfaces through [pipes](pipe.md), just as basic Unix tools do. We have to think about someone possibly taking our singleplayer RPG and make it 
into an MMORPG. Someone may even take the game and use it as a research tool for [machine learning {machine_learning md) or as a VFX tool for making movies, and the game should be designed so as 
to make this as easy as poSsible -- the user interface should be very simple to be replaced by an PI](api.md) for computers. The game should allow easy creation of [tool assisted speedruns] 
(tas.md), to record demos, to allow [scripting](script.md), modifying ingame variables, even creating [cheats](cheat.md) etc. And, importantly, **the game content is à module as well**, i.e. the 
whole RPG world, its lore and storyline is something that can be modified, forked, remixed, and the game creator should bear this in mind (see also [free universe](free universe.md)). 


Of course, LRS games must NOT contain such shit as "[anti-cheating](anti cheat.md) technology", [DRM](drm.md) etc. For our stance on cheating, see the article [about it](cheat.md). 
## Types Of Games 


Besides dividing games as any other software ([free](free_software.md) vs [proprietary](proprietary.md), [suckless](suckless.md) vs [bloat](bloat.md), ...) we may further divide them by the 
ollowing: 


- by genre: 

minigames](minigame.md) 
[shooters](shooter.md 
role playing] (rpg md 
tower defenses] (tower_defense.md) 
racing] (racing :md) 
platformers](platformer.md) 
strategy] (strategy md) 
[adventures] (adventure.md) 
sport] (sport.md) 


y game design: 

easy to learn, hard to master](easy to learn hard to master.md 
hard to learn, easy to master](hard to learn easy to master.md 
easy to learn, easy to master](easy to learn easy to master.md 
hard to learn, hard to masterj(hard to learn hard to master.md 
symmetric](symmetry.md) vs asSymetric gameplay 


y number of players: 

zero player] (zero-player -md) 

single player](single player.md) 

fmultiptayer ] (multipla, er.md) 

massively multiplayer ](mmo.md) 

y information: 

[complete information](complete information.md) 
incomplete information](incomplete information.md) 
y interface: 


["pseudo3D"/primitive3D](pseudo3d.md) 
command line/text](cli.md) 
audio 


[realtime](realtime.md) 
turn based](turn based.md) 
y platform 
[real life](irl.md) 
computer](computer.md) ([console](console.md) vs [PC](pc.md)) 
y budget/scale/financing: 
amateur 
[indie](indie.md) 
AAA](aaa.md) 
y [business model](business model.md): 
reeware](freeware.md) 
shareware (Shareware md) 
free to play](free to play.md 
subscription](subscription.md 
uy once 
pay to win](pay to win.md) 
[pay what you want](pay whàt you want.md)/donation 
adware](adware.md 
spyware](spyware.md) 


y “time Tne treatt H 


## Legal Matters 


Thankfully gameplay mechanisms cannot (yet) be [copyrighted] (copyright .md) (however some can sadly be [patented](patent.md)) so we can mostly happily [clone] clone md) proprietary games and so 
free them. However this must be done cárefülly às ere is a possibility of stepping on other mines, for example violating à [*trade dress" ]{ trade dvess.md) looking too similar visually) or a 
[trade mark|(trade mark.md) ur example you Cannot use the word *tetris* as it's owned by some shitty company) and also said patents (for example the concept of minigames on loading screens 
used to be patented in the past). 


Trademarks have been known, to cause problems in the realm of libre games, for example in the case of Nexuiz which had to rename to [Xonotic](xonotic.md) after its original creator trademarked 
the name and started to make trouble. 


**Advice.on cloning games**: copy only the gameplay mechanics, otherwise make it original and very different from the cloned.game or else you're threading the fine legal lines. See this as an 
opportunity to add something new, something that's yours, and potentially to apply and exploit [minimalism](minimalism.md), i.e. if you're going to clone Doom, do not make a game about shooting 
demons from hell that's called Gnoom -- just take the gameplay and do something new, e.g. why not try to make it a mix of sci-fi and fantasy with procedurally generated levels which will 
additionally save you a lot of time on level design? 


## Some Nice Gaymes 


[Anarch 


n A(anarch,md) and {microrD] (ytd.md) are examples of games trying to strictly follow the [less retarded](lrs.md) principles. [SAF](saf.md) is a less retarded game library/fantasy console 
which cómes with sóme le M dj. 


S retardéd game$ such as [microTD](utd.m 

[Chess](chess.md) is pretty nice, if we can count it as a computer game. 

{ I recommend checking out [Xonotic](xonotic.md), it's completely libre and one of the best games I've ever played, though it's [bloat](bloat.md). ~drummyfish } 
## See Also 


game engine] (game engine md) 
minigame](minigame.md) 

open console] (9 en console.md) 
fantasy console](fantasy console.md) 
SAF](saf.md) 

chess](chesS.md) 

T gay.md ---------- 

# Gaaaaaaaaaaaaaaaay 


Homosexuality is a sexual orientation and disorder which makes individuals sexually attracted primarily to the same sex, i.e. males to males and females to females. A homosexual individual is 
called gay, omo or even Faggot ([females](woman.md) are called lesbians). About 4% of people suffer from homosexuality. The opposite of homosexuality, i.e. the normal, natural sexual 
orientation primarily towards the opposite sex, is Called heterosexuality or being *straight*. 


For an unenlightened reader coming from the brainwashland; this article is not "offensive", it is just telling_uncensored truth. Be reminded that LRS] (Urs .md) is not advocating any 
discrimination, on the contrary wé advocate [absolute social equality] (Less retarded. society md) and love of all living beings. Your indoctrination has made yôu equate political inCorrectness 


with oppression; to see the truth, you have to unlearn this -- see for example our [FAQ](faq.md 

Unlike Sefa [pedoppilia](pegophilia.md and probably also [bisexuality](bisexual.md), **pure homosexuality. is NOT normal**, it is a disorder -- of course the meaning of the word disorder is 

highly debatable, but pure homosexuality is firstly pretty rare (being gay is as rare as e.g. havin frait iasmd) < m and secondly from the nature's point of view gay people wouldn't naturally 
y would call a defect -- not necessarily a defect harmful to society (there are enough 


reproduce, their condition is therefore equivalent to any other kind of sterility, which we most definite 


people already), but nonetheless a defect from biological point of view. 


Gay behavior is also usually retty weird, male homos are very feminine and talk in high pitched voice, lesbians are masculine, have short pink hair, often also aggressive nature and identity 
crisis manifested by [tattoos](tattoo.md) etc. Most normal cople naturally find this disgusting but are afraid to say it because of [political correctness](political_correctness.md) and fear of 
being [lynched](cancel_culture.md). You can usually safely tell someone's gay just from his body language and/or appearance. Gay peop 


ncneg ; e are also more inclined towards [art](art.md) ànd other 
sex's activities, for example gay guys are often hair dressers or even ballet dancers. 


There is_a terrorist [fascist](fagcism:md) organization called [LGBT](lgbt.md) aiming to make gay people superior to others, but more importantly to gain political power -- e.g. the [power over 
language](political córrectnesS.md). 


Even though, homosexuality is largely genetically determined, **it is also to a great extent a choice**, sometimes, a choice that's not of the individual in question. Most people are actually. 
[bisexual] lb? ma) to a considerable dégree, with a *preference* of certain sex. When horny, you'd fuck pretty much anything. Still there is a certain probability in each individual of chooSing 
one or the other sex for a sexual/life partner. However culture and social pressure can push these probabilities in either way. If a child grows up in a major influence of [YouTubers] 
(youtube.md) and other celebrities that openly are gay, or promote gayness as something extremely cool and fashionable, if al your role models are gay and your culture constantly paints being 
homosexual às being more interesting and Somehow "brave" and if the Competition] (competition nd of sexes fueled e.g. by the [ eminist | (reminism.mdy propaganda paints the opposite sex as 
literal [Hitler](hitler.md), the child has a greater probability of (maybe dnvoluntaraty) choosing the gay side of his sexual personality. This has certainly been happening in times when 
homosexuality was illegal, many gay people were forced to behave as heterosexuals and though many suffered, many have also lived quite OK and even happy lives -- nowadays the trend is opposite, 
being straight means being discriminated and society is forcing straight people to gayness. 


Of course, [wel (Irs md) have nothing against, gay people as we don't have anything against people with any other disorder -- **we love all people equally**. But we do have an issue with any kind 

of terrorist organization, so while we are okay with homosexuals, we are not okay with LGBT. 

**Are you gay?** How can you tell? In doing,so you should actually NOT be guided by your sexual.desires -- as has been said, most people are bisexual and in sex it many times holds that what 
orny, i.e. if you're a guy and would 


disgusts y u normally turhs you on when yoü're enjoy sucking a dick, you're not necessarily gay, it may be pure curiosity or just the desire of "forbidden 
fruit"; this is quite normal. Whether you're gay is probably determined by what kind of LIFE partner you'd choose, i.e. what sex you can fall in a ROMANTIC relationship with. If you're a guy and 
fall in love with another guy -- i.e. you're passionate just about being with that guy (even in case you couldn't have sex with him) -- you're probably gay. (Of course this holds the other way 
around too: if you're a guy and enjoy playing with tits, you may not necessarily be straight.) 

T gaywashing.md ---------- 

# Gaywashing 
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Geek is_a wannabe [nerd (nerd.md), it's someone who wants to identify with peing smart rather than actually being smart. Geeks are basically what used to be called a *smartass* in the old days 
-- overly, confident confórmists Occupying [mount stupio|(mount_stupid.md who think [soyence ](soyence md) is actual science, they watch shows like Rick and Morty and Big Bang Theory, they browse 
[Rational Wiki](rational wiki.md) and [reddit](reddit.md) -- especially r/atheism eum and they make appearances on r/iamverysmart -- they wear T-shirts with cheap references to 101 
regramning concepts and uncontrollably laugh at any reference to number [42](42.md), they think they're computer experts because they know the word [Einux] (tanux md) 

Tübüntu (ubuntu.md) or drag and drop programmed a "game" in [Godot](godot.md). Geeks don't really have their own opinions, they just adopt opinions presented on [9 ag] (9gag.md) , they are 
extreme Y weak and don't hàve extreme views. They usually live the normal conformist life, they have friends, normal day job, wife and kids, but they like to say they "never fit it" -- a true 
nerd is living in a basement and doesn't meet any people, he lives on the edge of [suicide](suicide.md) and doesn't nearly complain as much as the "geek". 

T gemini.md ---------- 

# Gemini 


managed to install 


Web](www.md) and a more complex alternative to [gopher]|(gopher.md) which it was inspired). It is' a par so cálled [Smot Internet](smol internet.md). Gemini aims to be a ' ern] 
(moder tema) take on gopher", adding some new "features" and a bit o bloat](bloat.md). The project states it wants to be something in the middle between Web and gopher but doesn't want to 
replace either. 


Gemini is a [shitty] (shit md) Matternative to dbgher](gopher. ad)" fb network [Protocol (protocol.md) for publishing browsing and downloading.files, a simpler alternative, to the world Wide 
e o m 


On one hand Gemini is kind of cool but on the other hand it's pretty shity(shit md) especially by REQUIRING the use of [TLS] (tts md) Lencryption] (encryption. md) for "muh security" because the 

project was made by privacy freaks that advocate the *ENCRYPT ABSOLUTELY EVERYTHIIIÍIING* philosophy. This is firstly mostly unnecessary (it’s not like you do Internet banking over Gemini) and 

secondly adds a shitton of [bloat](bloat.md) and prevents simple implementations of clients and servers. Some members of the community called for creating a Don sencrypted Gemini version, but 

that would basically be just gopher. Not even the Web goes as far as REQUIRING Oper T (aoe so it may be better and easier to just create a simple web 1.0 website rather than a Gemini capsule. 
r 


And if you want ultra simplicity, we highly advocate to instead prefer using [gophe (gopher . md ) which doesn't suffer from the mentioned issue. 


---------- gender_studies.md ---------- 
# Gender Studies 


what the actual fuck 
---------- gigachad.md ---------- 
# Gigachad 


Gigachad is tike chad](chad.md), only more so. He has an ideal physique and makes [women](woman.md) orgasm merely by looking at them. 
ITI girl.md ---------- 


See [femoid](femoid.md). 
T githopping.md ---------- 
# Githopping 


Githop| ing is a_disease similar to [distrohopping] (distrohopping md) but applied to [git] (git md) hosting websites. The disease has become an epidemics after the [Micro$oft](microsoft.md)'s take 
over of [ ithu5]tgithub.md) when people started protest-migrating to [GitLab](gitlab.md), however GitLab became [shit](shit.md) as well so people started hopping to other services like 
[Codeberg](codeberg.md) etcetc. and now they are addicted to just copying their code from one site to another instead of doing actual programming. 


Cure: free yourself of any git hosting,, don't centralize your repos: on one hosting, use multiple git hostings as mirrors for your code, i.e. add multiple push remotes.to your local git and with 
every push update your repo$ all over the internet. Just Spray the internet with your code and let it sink in, let it be captured in caches and archive sites and let it bé preserved. **DO NOT** 
tie yourself to any specific git hosting by using any non-git features such as issue trackers or specialized CLI](cli.md) tools such as github cli. **DO NOT** use git hosting sites as a [social 
network](social network.md), just stop attention whoring for stars and likes, leave this kind of shit to tiktokers. 

T1 global discussion.md ---------- 

# Global Discussion 


This is a place for general discussion about anything related to our thing. To comment just edit-add your comment. I suggest we use a tree-like structure as shows this example: 


- Hello, this is my comment. ~drummyfish 
- Hey, this is my response. ~drummyfish 


If the tree gets too big we can create a new tree under a new heading. 


## General Discussion 


GNU (*"GNU is Not Unix"*, a [recursive](recursion.md) acronym) is a. large project started by [Richard Stat wan] (rmsmd) the inventor of [free (as in freedom) software] (free software:md), 

running since 1983 with the goal of creating a Completely free (as in freedom foperatin sys em] (os.md), along with o her free [software](software.md) that Computer usérs might need. The 
projec doesn't tolerate any [proprietary](proprietary.md) software. The project achieved its goal of creating a complete operating system when a [kernel](kernel.md) named [Linux] (linux.md) 
ecame part of it in the 90s as the last piece of the puzzle -- the system is now known as GNU/Linux. However, the GNU project didn't end and continues to further develop the operating system as 
well as a myriad of other software projects it hosts. GNU gave rise to the [Free Software Foundation](fsf.md) and is one of the most important software projects in history of computing. 


The mascot of GNU is literally gnu (wildebeest), it is available under a copyleft license. 


The GNU/Linyx operating system has several variants in a form of a few GNU approved "Linux" ditributions]{distro.md) such as Guix] (quix md), [Trisquel|(trisquel md) or [parabola] (parabola.md). 
Most other "Linux" distros don't meet the strict standards of GNU such as not including any proprietary software. In fact the approved distros Can't even use the standard version [Linux] 
(linux.md) because that contains proprietary [blobs](blob.md), a modified variant called [Linux-libre](linux libre.md) has to be used. 


GNU greatly prefers [sell (get) ] licenses] (license .md 


r it strives for (copyleft (copyleft md), even though it accepts even projects under permissive licenses. GNU also helps with 
enforcing ese licenses gally' a g ht.md) to t th t 


qe: 
d advises Het sean) to transfer their [copyright] (copyrig GNU so th ey Gah "defend" e software for them. 


Although GNU is great and has been one of the best things to happen in software ever, it has its flaws. For example their programs are known to be kind of a bloat) (bloat, md), at least from the 
sith Lust irs pdy ue eon) perspective. It also dóesn't mind proprietary non-functional data (e.g. assets in video games) and their obsession with copyteft also isn't Completely aligned 
wit rs.md). 


## History 
TODO 
## GNU Projects 


GNU has developed an almost unbelievable amount of software, it has software for all basic and some advanced needs. As of writing this there are 373 software packages in the official GNU 
repository (at https://directory.fsf.org/wiki/Main Page). Below are just a few notable projects under the GNU umbrella. 


GNU Hurd] (hurd md) (OS [kernel](kernal.md), alternative to [Linux](linux.md) ) 
GNU Compiler Collection](gcc.m (esc. compiler for [C](c.md) and other languages) 


GNU C Library] (glibe.md glibc C](c.md) library) 

GNU Core Uti abies] nu_coreutils.m coreutils, basic utility programs) 

GNU Debugger J ( db.m (gdb, [debugger ] (debugger .md) ) ; < . 

GNU Binar ilities (gnu binutils.md binutils, programs for working with binary programs) 
m (chess.md) engine) 


- [GNU Chess](gnu chess. (strong [chess 
- [GNU Go](gnu_go.md) ([go](go.md) game engine 

- [GNU Autotoo lS] (autoLo01S md) ([build system|(build system.md)) 

- [CLISP](clisp.md) (common [lisp](lisp.md) language) 

- GNU Pascal (pasca ](pascatl.md) compiler 

- [GIMP](gimp.md) (image manipulation program, a "free [photoshop](photoshop.md)") 

- GNU Emacs ([emacs](emacs.md) text editor) 

- [GNU Octave[(octave.md) ([mathematics | (math; md ) software, "free Matlab" 

- [GNU Mediagoblin](mediagoblin.md) (decentralized file hosting on the [web] (web.md) ) 
- GNU Unifont ([unicode](unicode.md) font) 

- [GNU Privacy Guard](gpg.md) (gpg, OpenPGP encryption) 


## See Also 


Free Software Foundation](fsf.md) 
[Richard Stallman] (rms md 


copyleft] (copyleft .md 

Trea ea (cop Errea iare md) 
---------- go.md ---------- 
* Go 


Go is a compiled [programming, lan uage] (programming language md) advertised as the the "[modern](modern.md)" [C](c.md) and is co-authored by one of C's authors, [Ken Thompson](ken thompson.md). 
Neverheless Go is actually TShitjesnie md) Compared to C. Some feasons for this are: 


- It is developed b Google](google.md) and presented as "[open-source](open source.md)" (not [free software](free software.md)). 

- It has (classless 00P (oop md] features. 

- It has blpat](bloat md such as [garbage collection](garbage_collection.md), built-in [complex number](complex number.md) type, [concurrency](concurrency.md) and something akin a [package 
manager ](packagé_manager.md) (*go gét/install*). 


- It forces a programming style in which an opening function bracket (^(^) can't be on its own line. LMAO 
- Huge standard library with shit like crypto, image and html. 


Anyway, it at least tries to stay *somewhat* simple in.some areas and as such is probably better than other modern languages like [Rust](rust.md). It purposefully omits features such as 
[generics](generics.md) or static type conversions, which is good. 


l0 goodbye world.md ---------- 
# Goodbye World 


Goodbye world is a [program](program.md) that is in some sense an opposite of the traditional [hello world](hello world.md) program. What exactly this means is not strictly given, but some 
possibilities are: 


- It just prints *goodbye world*, the programmer writes the program and never touches the language again. | 
- It is the last program a programmer writes before death, either unknowingly or possibly as à [suicide | (suicide md) note. 
- Just as hello world shows the very basics of a language, a goodbye world may showcase the most advanced or masterful concepts of the language. 
- It is a program that erases itself or possibly the whole [operating system](os.md) etc. 
- TODO: more ideas? 
T good enough.md ---------- 
Good Enough 


# 
A good enough solution to a.problem is a solution. that solves the problem patistyingly (not_necessarily pyecisely or completely) while achieying minimal cost.(effort, implementation time etc). 
This is in Contrast to looking for a better solutions for a higher cost, which we might call an [overkill](overkill.md). For example a word-for-word translation of a text is a primitive way Oo 
translation, but it may be good enough to understand the meaning of the text; in many climates a tent is a good enough accommodation solution while a luxury house is a solution of better quality 
(more comfortable, safe, ...) for a higher cost. 


To give an example from the world of programming, [bubble sort](bubble sort.md) is in many cases better than quick sort for its simplicity, even though it's much slower than more advanced sorts. 


In technology we are often times looking for good enough solution to achieve, [minimalism] (minimalism. md) and save valuable resources (computational resources: programmer time etc.). It rarely 
makes sense to look for solutions that are more expensive than they necessarily need to be, however in the context of [capitalist sof ware](capitalist sof tware:md) we see this happen many times 
as a part of killer feature battle and also driving prices artificially up for economic reasons (e.g. increasing the cost of maintenance of a software eliminates any competition at can't 
afford such cost). An example of this is the trend in smartphones to have 4 and more physical cameras. This is only natural in [capitalism](capitalism.md), we see the tendency for wasting 
resources everywhere. This of course needs to be stopped. 

T google.md ---------- 
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# Google 


i 1 as well as one of the worst corporations in history (if not THE worst), comparable only to [Microsoft] 
E edd a is gigantically evil and largely controls the [Internet](internet.md), pushes mass surveillance, personal data collection and abuse, ads, 


Google is one the very top [bi ceca Pig; tegha m [corporations](corporation.md) 
.m 
tranny software.md 


microsoft.md) and [Facebook] (Tacebo: 
bloat](bloat.md), 


fascism] and [censorship](censorship.md 


Google's motto used to be **"Don't be evil"**, but in 2018 they ditched it lol xD 


Google raised to the top thanks, to its [search engine (search engine.md) launched in the 90s, It soon got a **monopoly on the Internet search** and started pushing ads. Nowadays Google's search 
engine basically just promotes "content" on Googlé's Own content platforms such as [YouTube](youtube.md) and of course censors sites deemed politically incorrect. 


Besides heavily biasing web search, results towards Google's own.and friendly platforms, Google also heavily censors the search results and won't show links to prohibited sites unless you |. 
literally very specifically show that you want to find a prohibited site you already know of, for example you won't find results leading to [Metapedia] (metapedia md) or Encyclopedia Dramatica 
unless you literally search for the url of those sites of long verbatim R rases they contain -- this is a trick played on those who "test" Google which at is mean to make it look as if Google 
actually isn't censored, however it is of course censored because the on y people who will ever find the prohibited sites and their content are people who already know about it and are 
specifically searching for it just_to test Google's censorship. { EDIT: tho Google also seems to refuse to give some URLS no matter what, e.g. https://infogalactic.com. Just tested it. 
-drummyfish } If you intend to truly search the Internet, don't rely on Google s results but search with multiple engines (that have their own index) such as Mojeek, Yandex, Right Dao, [wiby] 
(wiby.md), [YaCy](yacy.md), Qwant etc. (and of course search the [darknet](darknet.md)). 


Google has created a malicious [capitalist](capitalist_software,md) mobile aaopecating system] (operating_system.md)" called [Android] (android. md), which they based on [inp (linux md) with 
which they managed to bypass its [gopy tert copyleft.md) by making Android de-facto dépendent on their proprietary *Play Store* and her programs. I.e. they managed to take à [free] 

(free software.md) project and make a de-facto Tpronrietary](proprietary.md) [malware](malware.md) out of it -- a system that typically doesn't allow users to modify its internals and turn off 
its malicious features. With Android they invaded a huge number of devices from cells phones to TVs and have the ability to spy on the users of these devices. 


(internet archive.md), however in these scans ey put a condition that the scans Should not be used for commercial purposes, i.e. they try to keep exclusive commercial right for Jubtic domain 
works, something they have no right to do at a 
l0 gopher.md ---------- 


Google also tries to steal the [public domain] (public-domain md): they scan and digitize old books whose [copyright](copyright.md) has expired and put the on the [Internet archive 
UW 


Gopher is a network [protocol] (protocol.md) for publishing, browsing and down loading files and is. known as.a much simpler alternative to the [World Wide Web] (www. mdi (i.e..to [pred Chet pa and 
[HTML](html.md)). In fact it Competed with the Web in its early dayS and even though the Web won in the mainstream, gopher still remains used by a small community. opier is like thé Web bu 
well designed, it is the [suckless](suckless.md)/[KISS](kiss.md) way of doing what the Web does, it contains practically no [bloat](bloat.md) and so [eed Curs md) highly advocate its use. Gopher 
gare ee [Gemini](gemini.md), a similar but bit more complex and "[modern](modern.md)" protocol, and the two together have recently become the main part of so called [Smol Internet] 
smol internet.md). 


As of 2022 the Veronica search engine reported 343 gopher servers in the world with 5+ million indexed selectors. 


Gopher **doesn't use any [encryption] (encryption md) t. Thiş is good, -encryption is [bloat](bloat md). Gopher also **only uses [45c11] (ascii md)" T, i.e. there's no [unicode] (unicode md) That's 
also good, Unicode is bloat (and mostly serves trannies to insert emojis of pregnant men into readmes, we don't need that). Gopher simple design is intentional, the authors deemed simplicity a 
good feature. Gopher is so simple that you may very well write your own client ànd server and comfortably use them (it is also practically possible to browse gopher without a specialized client, 
just with standard [Unix](unix.md) [CLI](cli.md) tools). 


From the user's persprctive the most important distinction from. the Web is that gopher is based.on **menus** instead of "webpages"; a menu is simply a column of items of different predefined 
types, most importantly e.g. a *text file* (which clients can directly display), *üdirectory* (link to another menu), *text labél* (just shows some text), *binary file* etc. A menu can't be 
formatted or visually changed, there are no colors, images, scripts or [hvpertext] (hypertext md) -- a menu is not à presentation tool, it is simply a navigation node towards files users are 
searching for (but the mentioned ASCII art and label items allow for somewhat mimicking "websites" anyway) - Addressing works with [URLs] (url. md) just as the Web, the URLs just differ by the 
protocol part ('gopher://^ instead of ^http://^), e. ^gopher://gopher.floodgap.com:70/1/gstats'. What on Web is called a "website" on gopher we call a **gopherhole** (i.e. a collection of 
resources usually under a single [domain](domain.md)) and the whole gopher network is called a **gopherspace**. [Blogs] (blog.md) are common on gopher and are called **phlogs** (collectively a 
*phlogosphere*). As menus can refer to one another, gopher creates something akin a **global [file system](file system.md)* SO browsing gopher is like browsing folders and can comfortably be 
handled with jüst 4 arrow keys. Note that as menus càn link to any other menu freely, the structure of the "file System" is not a [tree] (tree. md) but rather a general [graph] (graph. md). Another 
difference from the Web is gopher's great emphasis on **[plaintext](plaintext.md) and [ASCII art] ascii art.md)** as it cannot embed images and other media in the menus (even though of course 
the menus can link to them). There is also a support for sending text to a server so it is possible to implement [search engines](search engine.md), guest books etc. 


Gopher is just an [application layer MM [protecot](protogol.md) (officially running. on port (port .md) 70 assigned by LIANA] (ianamd)), i.e it,sits above lower layer protocols like [TCP 
(tcp.md) and takes the same role às TTP](http.md) on e Web and So only defines how Clients and Servers' talk to éach other -- the gophéf protocol doesn't say how mehus are written or stored 
on servers. Nevertheless for the creation of menus so called **gophermaps** have been established, which is a simple format for writing menus and are the gopher equivalent of Web's [HTML] 
(html.md) files Gust much simpler, basically just menu items on separate lines, the exact syntax is ultimately defined by server implementation). A server doesn't have to use gophermaps, it may 
be e.g. Configured to create menus automatically from directories and files stored on the server, however gophermaps allow users to write custom menus manually. Typically in someone's gopherhole 
you'll be served a welcoming intro menu similar to a personal webpage that's been written as a gophermap, which may then link to directiories storing personal files or other hand written menus. 
Some gopher servers also allow creating dynamic content with scripts called **moles**. 


**Gopher feottware| (sot tware md)": sadly "[modern](modern.md)" browsers are so modern they have millions of lines_of code but can't be bothered to support such a trivial protocol like gopher, 
however there are Web proxies you can use to explore gopherspace. Better browsers such as Yuyax] (lynx md) (terminal) or Lorg I CForg-md) CPSUE Gout md} can be used for browsing gopherspace 
natively. As a server you may use e.g. Gophernicus (used by SDF] (sdf .md)) or search for another one, there are dozens. For the creation of gop ermaps you simply use a plaintext editor. **Where 
to host gopher?** [Pubnixes](pubnix.md) such as [SDF](sdf.md), [tilde.town](tilde town.md) and [Circumlunar community](circumlunar.md) offer gopher hosting but many people simply [self-host] 
(self hosting.md) servers e.g. on [Raspberry Pis[(rpi.md), it's pretty simple. 


## Example 


T graphics.md ---------- 
# Computer Graphics 


Computer graphics (CG_or just graphics) is a field of, [computer science] (compsei -md) that deals with visual information. The field. doesn't have strict boundaries and can.blend and overlap with 
other posSibly sepárate tópics such as physics simulations, multimedia ànd machine earning. It usually deals with creating or analyzing 2D and 3D images and as such CG is used in [data] 
(data.md) visualization, [hame] (game md) development, [virtual reality](vr.md), [optical character recognition](ocr.md) and even astrophysics or medicine. 


We can divide computer graphics in different ways, traditionally e.g.: 


- by direction: 
- **[rendering](rendering.md)**: Creating images. 
**[computer Vision](computer visionmd)**: Extracting information from existing images. 
- by básic elements: 
- **[raster](raster graphics.md)**: Deals with images composed of a uniform grid of points called [pixels](pixel.md) (in 2D) or [voxels](voxel.md) (in 3D). 
z P vector](vector graphics.md)**: Deals with images composed of geometrical primitives such as curves or triangles. 
- imension: 
PY ST2D 2d.md)**: Deals with images of a 2D plane. 
**[3p](3d.md)**: Deals with images that capture three dimensional space. 


- by speed: 
- **[real time] (real_time s Trying to work with images in real time, e.g. being able to produce or analyze 60 frames per second. 
- **offline**: Processes or creates images over longer time-spans, even hours or days, e.g. in 3D movie rendering. 


Since the 90s computers started using a dedicated hardware to accelerate graphics: so called [graphics processing units (gpu md) GPUs). These have allowed rendering of high quality images in 
high [FPS](f| smd). and due to the entertainment and media industry (especially gaming), GPUs have been pushed towards ater performance each year. Nowadays they are one of the most 
consumerist hardware | (hardware.md), also due to the emergence of general purpose computations being moved to GPUs (GPGPU), lately especially mining of [oryptocurrencies] ter pig. mo and training 
of [AI](ai.md). Most lazy programs dealing with graphics nowadays Simply expect and require a GPU, which creates a bad [dependency] (dependency md) and [bloat](bloat.md). At n RS](lrs.md) we try 
to prefer the [suckless](suckless.md) **[software rendering] (sworendering md)", i.e. rendering on the [eeu] (cpu md), without GPU, or at least offer this as an option in case GPU isn't 
available. This many times leads us towards the adventure of using old and forgotten algorithms used in times before GPUs. 


## 3D Graphics 
This is a general overview of 3D graphics, for more technical overview of 3D rendering see [its own article](3d_rendering.md). 


3D graphics is a big part of CG but is a lot more complicated than 2D. It tries to achieve **realism** through the use of capper spective] (perspective md) **, i.e. looking at least a bit like what 
we See in the real world. 30 graphics can very often bee seen as **simulating the behavior of [light] (tight mo^"; there exists so calle render ing equation] (renderin equation md) that . 
describes how light behaves ideally, and 3D computer graphics tries to approximate the solutions of this equation, i.e. the idea is to use [math](math.md) and physics] (physics. md) o describe 
real-life behavior of light and then simulate this model to literally create "virtual photos". The theory of realistic rendering is centered around the rendering equation and achieving **[global 
illumination] (global_illumination.md)** (accurately computing the interaction of light not just in small parts of space but in the scene as a whole) -- studying this requires basic knowledge of 
[radiometry](radiometry.md) and [photometry] (photometry.md) [GO that define various measures and units related to light such as [radiance](radiance.md), radiant intensity etc.). 


In 2010s, mainstream 3D gra hics started to employ so called [physically based rendering](pbr.md).(PBR) that tries to yet more use pysically correct models. of [qaterials] material,md) (e.g. 
physically measured [BRI FS] (brdr md) of various materials) to achieve higher photorea om, This'i$ in contrast to simpler (both mathematically and computationatly), more [empirical] 


(empiricism.md) models (such as a single texture + [phong lighting](phong lighting.md)) used in earlier 3D graphics. 


Because 3D is not very easy (for example {rotat ions] (rotation md) are pretty complicated), there exist many **[3D en inesl(3d engine.md)** and libraries that you'll.probably want to use. These 
engines/libraries work on different levels of abstraction: the lowest ones, such as [OpenGL | (open l.md) and [volkan] Cvutk n.md offer à portable API for communicating with the GPU that lets you 
[eren draw triangles and write small programs that run in parallel on the GPU -- so called [shaders](shader.md). The higher level, such as [OpenSceneGraph](osg.md), work with [abstraction] 


abstraction.md) such as that of a **virtual camera** and **virtual scene** into which we place specific 3D objects such as models and lights (the scene is many times represented as a 
hierarchical graph of objects that can be "attached" to other objects, so called [scene grhph](scene graph.md)]. 


There is a tiny [sucktess (suckless.md)/[LRS](1rs.md) library for real-time 3D: [sma Utd ib] (Sma 13d tip. md It uses software rendering (no GPU) and can be used for simple 3D programs that can 
run even on low-Spec embedded devices. [TinyGL](tinygl.md) iS a similar software-rendering library that implements a subset of tOpen&L ] (ópeng Lid) 


**Real-time** 3D typically uses an **object-order** rendering .i,e. iterating over objects in the scene and drawing them onto the screen.(i.e. we draw object by object): This is a fast approach 
but has disadvantages such a: usually) needing a memory inefficient [z-buffér](z buffer.md) to not overwrite closér objects with more distant ones. It i$ also pretty difficult to implement 
effects such as shadows or reflections in object-order rendering. The 3D models used in real-time 3D are practically always made of **triangles** (or other polygons) because the established GPU 
pipelines work on the principle of drawing polygons. 


**Offline rendering** (non-real-time, e.g. 3D movies) on the other hand mostly uses **image-order** algorithms which go pixel, by pixel and for each one determine what color the pixel should 
have. This is basically done by casting à ray from the camera's position through the "pixél" position and calculating which objects in the scene get hit by the ray; this then determines the 
color of the pixel. This more accurately models how rays of light behave in real life (even though in real life the rays go the opposite way: from lights to the camera, but this is extremely 
inefficient to pamulace) The advantage of this process is a much higher realism and the implementation simplicity of many effects like shadows, reflections and refractions, and also the 
possibility of having other than polygonal 3D models (in fact smooth, mathematically described shapes are normally much easier to check ray intersections with). Algorithms in this category 
include [ray tracing](ray tracing md) or [path tracing](path tracing.md). In recent years we've seen these methods brought, in a limited way, to real-time graphics on the high end GPUs. 
T greenwashing.md ---------- 

# Greenwashing 


*"For every car you consume we plant a tree."* --[corporations](corporation.md) 


Graphical user interface (GUI) is a visual [user interface](ui.md) that uses graphics such as images and geometrical shapes. This stands in contrast with [text user interface](tui.md) (TUI) 
which is also visual but ónly uses text for communication. 


I 
Expert computer users pormal ly frown upon GUI because it is the "noobish", inefficient Limiting, cumbersome, hard to automate way of interacting with computer. GUI brings [complexity] 
(complexity.md) and [bloat](bioat.md), they are slow, inefficient and distracting. We try not tó use them and prefer the [command line](cli.md). 


niodern] (modern, md)" GUIs mostly use [callback](callback.md)-based programming, which again is more complicated than standard polling non-interactive I/O. If you need to do GUI, just use a 
nórmal infinite loop FFS. 


## When And How To Do GUI 


d S ae in a painting program) or as a completely optional thing,built 
(api-md). So remember: first create a program and/or a [library](library.md) working without GUI and only then consider creating an 


GUI is not forbidden, it has its place, but today it's way, Foe ovghused -- it should be used only if completely necessary 
to whatever functionality can be imp 


upon a more [sucklesS](suckless.md) text interface or [AP 
optional GUI [fronten 


206 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


(frontend.md). GUI must never be tie emented without it. 


Still, when making a GUI, you ean make it [suckless] (SuckLess md) and lighthweight. Do your buttons need to have reflections, soft shadows and rounded anti-aliased borders? No. Do your windows 
need to be transparent with light-refractión simulation? No. Do you need to introduce many MB of dependencies and pain such às [QT](qt.md)? No. 


The ergonomics and aesthetic design of GUIs has its own field and can't be covered here, but just keep in mind some basic things: 


- Don't have too many elements (buttons etc.) at the screen at once, it's confusing as hell and drives noobs away - d 
- Things must be intüitive, i.e. behave in a way that they normally do (e.g. main menu should be at the top of the window, not the bottom etc.). 
- Just use your brain. If a button is important and often used, it should probably be bigger than a button that's used almost never, etc. 


abstraction such as widget hierarchies etc. If you absolutely need some framework, look for a suckless one; e.g. [nuklear](nuklear.md) is worth checking out. The suckless community sometimes 
uses pure [Xii](xii.md), however that's not ideal, X11 itself is kind of bloated and it's also getting obsoleted by [Wayland](wayland.md). The ideal solution is to make your GUI **backend 
agnostic**, i.e. create your own very thin abstraction layer above the backend (e.g. X11) so that any other backend can be plugged in if needed just by rewriting a few simple functions of your 
abstraction layer (see how e.g. [Anarch](anarch.md) does rendering). 

T hacker culture.md ---------- 

# Hacker Culture 


The million dollar question, is: **which GUI framework to use?** Ideally none. GUI is just pixels, buttons are just ukfeard (nul make your GUI simple enough so that you don't need any shitty 


See [hacking] (hacking.md) . 
T acking.md ---------- 
# Hacking 


*Not to be confused with [cracking](cracking.md).* 


*hacker* was originally -- that is in 1960s -- used for very good [programmers](programming.md) and people who were Simply good with computers, the word *hacking* had a completely positive 
meaning; hacker could almost be synonymous with computer [genius] (genius md) (at the time people hend ting computers were usually physicists, engineers or mathematicians), someone who enjoyed 
handling and programming computers and could playfully look for very clever ways of making them do what he wanted. Over time hackers evolved a whole **hacker culture** with its own slang, set of 
values, behavioral and ethical norms, in jokes and rich lore. As time marched on, computer [security](security.md) has started to become an important topic and some media started to use the word 
*hacker* for someone breaking into a computer system and so the word gained a negative connotation in the mainstream -- though many refused to accept this new meaning and rather used the word 
*[cracker](cracker.md)* for à "malicious hacker", there appeared new variants such as *white hat* and *black hat* hacker, referring to ethical and malicious hackers. With onset of online [games] 
game md) the word *hacking* even became a synonym for [c eating] (cheating md). The original positive meaning has recent ly seen some comeback with popularity of sites such as [hacker news 

acker news.md) or hackaday, the word *life hack* has even found its way into the non-computer mainstream dictionary, however a "[modern](modern.md) hacker" is a bit different from the 
Oldschool hacker, usually for the worse (for example a modern self proclaimed "hacker" has no issue with wearing a [Suit](suit.md), something that would be despised by an oldschool hacker). We, 
[LRS](lrs.md), advocate for using the original, oldschool meaning of the word *hacker*. 


Hacking (also hackerdom) in the widest sense means exploiting usually (but not necessarily) a [cand people who were Sihply dod with cong in a clever way. In context of computers the word 
p o 


## Original Hacker Culture 


The original hacker culture is a culture of the earliest computer programmers, usually smart but socially rather isolated nerds -- at the time mostly physicists, mathematicians and engineers -- 
who shared deep love for programming and pure joy of coming up with clever computer tricks, exploration of computers and freely sharing their knowledge and computer pro rams with each other. The 
culture started to develop rapidly at [MIT](mit.md) in about the second half of 1960s, though other hacker communities existed earlier and in other places as well (still mostly at universities). 


The word *hack* itself seems.to have come from a model train club at MIT in whose slang the. word referred to something like a project of passion without a speçifiç goal; before this the word, was 
used around MIT for a specific kind of clever but harmless pranks: Members of the model train club came to contact with early computers at MIT and brought their slañg along. These early punch- 
card computers were expensive and sacred, hackers treated them as almost supernatural entities; in the book *Hackers* it is mentioned that those who were allowed to operate the machines were 


called *Priests* -- Priests would often carry out a little prayer to please the machine so that it would bless them with computation. During 60s and 70s so called [phreaking](phreaking.md) -- 

hacking the phone network -- was popular among hackers. 

Many ideas -- such as the beauty of [minimalism](minimalism.md) -- that became part of hacker culture later came from the development of [Unix](unix.md) and establishment of its [programming 
hi Osophy] unix philosophy md). Many hackers came from the communities revolving around [PDP 10](pdp 10.md) and PARPANET 1 (arpanet md), and later around networks such as [Usenet](usenet.md). At 
he time when computers started to be abused by corporations, [Richard Stallman's](rms.md) definition of [free sortware](free softwaré.md) and his [GNU](gnu.md) project embodied the strong 

hacker belief in information freedom and their opposition of [intellectual property](intellectual property.md). 


The culture has a deep. lore.and_its own literature consisting of books that hackers usually like (e.g. The Hitchhiker's Guide to the Galaxy) and books by hackers themselves. Bits of the lore are 
in forms of short stories circulated as folklore, very popular form are so called Koans. Perhaps the most iconic hacker story is the [Story of Mel](story of mel.md) which tells a true story of a 
master hacker keeping to his personal ethical beliefs under the pressure of his corporate employers -- a conflict between manager employers "suits") and hacker employees is a common theme in 
the stories. Other famous stories include the *TV t pewr ther and *Magic Switch*. One of the most famous hacker books is the **[Jargon File](jargon_file.md)**, a collectively written dictionary 
documenting hacker culture in detail. A 1987 book Bi he Tao of Programmin ](ta0_of programming mi^ captures the hacker wisdom with Taoist-like texts that show how spiritual hacking can get -- 
this reflects the above mentioned sacred nature of the early computers. The *textfiles* website features many text files on hacking at https://textfiles.vistech.net/hacking/. See also *Ten 
Commandments for C Programmers* etc. A lot about hackers can be learned from books about them, e.g. the [free](free culture.md) book *Free as in Freedom* about [Richard Stallman](rms.md) 
(availaple e.g. [here] (https: //wm. gutenberg jor /ebooks/5768)). A prominent hacker writer is [eric S. Raymond](esr.md) who produced a very famous essay *The Cathedral and the Bazaar*, edited the 
argon File and has written a large guide called *How To Become A Hacker* -- these are all good resources on hackerdom, even though Raymond himself is kind of shitty, he for example prefers the 
"[open source](open source.md)" movement to [free software](free software.md). 


As a symbol of hackerdom the glider symbol from [game of life](game of life.md) is sometimes used, it looks like this: 


Let us now attempt to briefly summarize what it means to be a hacker: 


- **Hacker is an artist who builds and creates**, [cracker](cracker.md) is someone who breaks and destroys, many times due to being less competent or unworthy of true hacking -- destroying 
something is easier than creating something. 

- **Hacker greatly values freedom**, among which are, the **freedom of [information] (information dm)*^, **[free software](free software.md)**, **[free speech](free speech.md)**, **free 
thinking**, free access to computers etc. Therefore he supports sharing, even if it is called for example "[piracy](piracy.md)", and despises things going against said freedoms such as 
proprietary](proprietary.md) software, [passwords](password.md) (preventing information freedom), [censorship](censorship.md), [copyrig 

eceit etc. 

- **Hackers are non-conformists, reject authority and don't, respect social norms**; a hacker wears old cheap clothes, long hair and unkept beard without gonforming to any_fashion, he sees_caring 
about looks as a wasted time that would better be Spent by hacking computers. Hacker is a basement dwelling nerd without Social life because he has rich inner intéllectual life, he's usually a 
kisless virgin, even a [wizard](wizard.md), partly because of his looks but also again because typical adult life would require him to do less hacking. 


t](copyright.md), [patents](patent.md), pretense and 


- **Hacker values [fun](fun,.md) and playfulness” * -- despite his serious dedication to the art, he hates seriousness of the business guys and "suits", as well as the self-centered, egoistic 
attitude of "modern hackers" who mig t See or present themselves as kind of [su erheroes](hero culture.md). A hacker will give his programs funny names rather than names that would make for a 
good business product, a hacker will insert jokes in his source code (e.g. [hex](hexadecimal.md) values such as OxBEEFFACE), documentation and speech ([Jargon File](jargon_file.md) has a whole 
section on how hackers construct and use words). 

- **Hacker aims for ingenuity, cleverness, elegance [minimalism] (minimalism. md), thinking out of the box** etc, As such he loves [math] (math. md), puzzles, intellectual,challenges, (such ag, [code 
golfing] (code gotf:nd) and despises ugly commércial ways of mainstream technology, i.e. that which is [bloatedj(bloat.md), hastily madé to impress by visuals or cheap "killer features" white 
iding ugly internals etc. 

- **Hacker loves hacking and tinkering in itself -- hacking is the goal, not the means. Hacking is [art](art.md) and carries deep intellectual and even spiritual value,** To a hacker it is a joy 
to program computers and he aims for nothing more than eni*y endless hours of programming Programming is NOT a tool to achieve low goals such as monetary profit or mainstream fame. Many hackers 
claim that hacking is better than [sex](sex.md) (though it is questionable whether many of them have experience with the latter). 

-.**Hacker.has strong opinions about technglpgy"*, for example about what the best [text editor](text editor.md) or best [programming language](programming language.md) is. However hackers may 
also sometimes disagree which results in **[holy wars](holy war.md)**. 


Let's mention a few [people](people.md) who were at their time regarded by,at least some as true hackers, however note.that many of them betrayed some of the hacker ways.either later in life or 
even in their young years -- people aren't perfect and no single individual is a perfect example of a whole culture. With that said, those regarded hackers included Melvin Kaye aka [Mel] 

met md), [Richard Stallman] (rms.md), [Linus Torvalds](linus torvalds.md), [Eric S. Raymond](esr.md), [Ken Thompson](ken thompson.md), [Dennis Ritchie](dennis ritchie.md), [Richard Greenblatt] 
greenblatt.md), [Bill Gosper](bill gosper.md), [Steve Wozniak](wozniak.md) or [Larry Wall] arry wall.md). 


## "[Modern](modern.md)" "Hackers" 


Many modern [zoomer ] (zoomer md) fSoydeys] (soydev md) call themselved "hackers" but there are basically none that would stay true to the original ethics and culture and be worthy of being called 
a true hacker, they just abuse’ the word as a cool term or a brand (see e.g. ["hacker" news](hacker_news.md)). It's pretty Sad the word has become a laughable barody of its original meaning by 
being associated with groups such as [Aponymous | (anonymous md) who are just a bunch of 14 year, old children trying to look like "movie hackers". The hacker culture has been spoiled basically in 
the same ways the rest of society, and the difference between classic hacker culture and the "modern" one is similar to the difference between [free portwarel(freecsortware md) and [open source] 
open source.md), though perhaps more amplified -- the original culture of strong ethics has become twisted by [capitalist](capitalism.md) trends such as self-interest, commercialization, 
fashion](fashion.md), mainstreamization, even shitty movie adaptations etc. The modern "hackers" are idiots who have never seen [assembly](assembly.md), can't do [math (math.md), they're turds 
in suits who make [startups |(startup-md) and work as [influencers](influencer.md), they are tech consumers who use and even create [bloat bioat.md); and possibly even [proprietary] 
(proprietary.md) software. For the love of god, do NOT mimic such caricatures or give them attention -- not only are they not real hackers, they are simply retarded attention whores. 


## Security "Hackers" 


*Hacker* nowadays, very often refers to someone involved in computer [security](security.md) either as that who "protects" {most ly by looking for vulnerabilities and reporting them), so called . 
*white hat*, or that who attacks, so called *black hat*. Those are not hackers in the Original sense, they are hackers in the mainstream adópted meaning of someone breaking into a System. **This 
kind of "hacker" betrays the original culture by supporting secrecy and sensor ship z i.e. protection: of "sensitive information" mostly justified by so called "Lprivagy] privacy.md)" -- this 
is violating the original hacker's pursuit of absolute information freedom (note hat e g. [Richard Stallman](rms.md) boycotted even the use of passwords at MIT, Raymond discourages from using 
anonymous hàndles and rather recommends going by your real name): These people are obsessed with anonymity encryption](encryption.md), [cryptocurrencies] (crypto md), [cryptofascism] 
(eryptotascism md) and are also more often than not egoist people with shitty personalities. In addition they don't generally adhere to the original hacker culture in any way either, they are 
simply people breaking into systems for some kind of self benefit (yes, even the *white hats*), nothing more than that. Again, do NOT try to mimic these abominations. 


## Examples Of Hacks 
{ As a redditfag I used to follow the r/devtricks subreddit, it contained some nice examples of hacks. ~drummyfish } 


are already well known and no longer innovative, a true hack is 


A great many commonly used tricks in, programming could be regarded as hacks even though many are not called so because they T n V 
e area of technology as well. The following is a list of things that were once considered new hacks or that 


something new that impresses fellow hackérs. And of course hacks may appear outside t 
are good examples demonstrating the concept: 


- **[bit hacks] (bit hack.md) +": Clever manipulations of bits] (bit. md) -- for pxample it is possible to_swap, two variable without a.temporary variables by using the [xor] (xor md) function. 
Another simple example is implementing division by 2 as binary shift by 1 (this hack is used in real life by people for quickly dividing by 10, we just remove the tast digit). 

- **[copyleft (gopylert md) A legal hack by [Richard Stallman](rms.md), connected to [free software] (free_softwar¢.md), „working on the basis of the following idea: "If [copyright] 
(copyright.md) letS me put any conditions on my work, I may imposé a condition on my work that says that any modified version must not impose any restrictive conditions". 

- iol f88t inverse square root](fast inverse sqrt.md)**:. Famous hack that was used in the [gane] (game md) Quake, it fapproxmates ] (approximation.md) an inverse of [square root](sqrt.md) of a 
[floáting point](float.md) number by treating it as an integer and bashing it with a [magic constant](mágic constant.md), which is about four timés faster than computing the value with the 
Obvious floating point division. 

- **memory [rape](rape.md) in I£]fe-mp*t: E.g. instead of doing Roper memory allocation with potentially inefficient and bloated “malloc” one may try to do a custom memory allocation without 
any librariés by abusing allocation on' stack -- allocate a variable size array in main, set some global pointer to it and then manage this chunk of memory with your own allocation functions. 

E ciagtually por table executable** (https: //justine, lol/ape html): Justine Tunney found a. way to create an executable format that passes as.a, valid NATIVE executable on all major systems 
including [GNU](gnu.md)/[Linux](linux.md), [Windows](windows.md)' and [Mac](mac.md), i.e. it is possible to compile a native program (e.g. with [C](c.md)) and then have it natively run on any 


major OS. 
- **[game of life (gape-of life md) patterns**: Stable patterns such as glider or even programming game of life in game of life is a nice example of game hacking -- in fact exactly game of life 
hacking stood at thé beginning of hacker culture. 


- cobbytebeat | (bytebeat amd) 2 A Teens cene Lea tear hack that utilizes integer [overflows](overflow.md) to create rhythm and produce music. 
ics. 


- Computer [grap ics](gra| md) uses many,clever tricks that could possibly be called hacks, gd in times when 3D graphics was primitive and didn't allow achieving such effects as mirror 
reflections éasily, Some [games|(game.md) faked mirrors simply with a hole in the wall behind which the whole mirrored room was placed -- this achieved the same effect as a mirror and didn't 
require any extra rendering passes or shaders. 

i nal guinei(guine.mdjt*: A cleverly constructed self-replicating program in [programming language](programming language.md) that prints its own source code -- this is a common exercise of 
anguage hackers. 

- TODO: moar 

## See Also 


- [demoscene] (demoscene.md) 
- [cracking] (cracking.md) 

T ard to learn easy to master.md ---------- 
# Hard To Learn, Easy To Master 
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"Hard to learn, easy to master" is the opposite of "[easy to learn, hard to master](easy to lear hard to master.md)". 


Example: drinking coffee while flying a plane. 
T hardware.md ---------- 
# Hardware 


The article is [here](hw.md)! 
T harry potter.md ---------- 
# Harry Potter 


Harry Potter is a | franchise] (franchise md) and universe by an English female writer J, K. Rowling about wizards and magic f like ACTUAL [wizards](wizard.md).and {magic] (magie md). -drummyfish l 
that started in 1997 as an immensely succe$sful series of Seven children and young adult books, was followed by movies and tater on by many other spinoff media such as video [gamés](game.md). I 
made J. K. Rowling a billionaire and has become the most famous and successful book series of modern age. At first the books sparked controversies and opposition in religious communities for 
"promoting witchcraft", in recent years the universe and stories have become a subject of wider political analysis and fights, as most other things. 


{_The books are actually good.-- not the best in the world, I've read many better ones that would better deserve this kind. of attention, but still the work is admirable. There is of course tons 
of money in the franchiSe so it's getting raped and milked like any other IP capital -- this is of course spoiling and killing the work, so be careful. -drummyfish | 

**Plot summary**: sorry, we're not writing a plot summary here, thank fegpyright | (copyright md) laws -- yes, [fair used (fair use.md) allows us to do it but it would make us [non free 

(free culture.md) :) Let's just say the story revolves around à boy named Harry Potter who goe$ to a wizard school with two friends and they're together *saving the world* from Lord Voldemort, 


the wizard equivalent of [Hatter ]¢ 
wizards'n'magic". It's pretty rea 
-- hash.md -- 


iter ma): Overall the books start on a very light note and get progressively darker and more adult, turning into a story about "World War II but with 
g 


able, wit reat, unique atmosphere, pleasant coziness and elements of many literary genres, there's nice humor and good ideas. Also the lore is very deep. 


Hash is a number that's computed from.some data in a [chaotic] (chaos md) way and which is used for many different purposes, e.g. for quick comparisons (instead of comparing big data structures 
we just compare their hashes) or mapping data structures to table indices. 


Hash is computed by a **hash function**, a function that takes some data and turns it into a_number (the hash) that's in terms of [biti (bit .md) width much smaller, than the data itself, has a 
fixed size Chumber of [bits](bit.md)) and which has additional properties such as being completely different from hash values computed from very similar (but slightly different) data. Thanks to 
these properties hashes have a very wide use in [computer $cience](compsci md) -- they are often used to quickly compare whether two pieces of non-small data, such as documents, are the same, 
they are used in indexing structures such as **hash tables** which allow for quick search of data, and they find a great use in [cryptocurrencies](crypto.md) and [security](security.md), e.g; 
for [digital signatures](sigital signature.md) or storing passwords (for security reasons in databases of users we Store just hashes of their passwords, never the passwords themselves). Hashing 
is extremely important and as a programmer you won't be able to avoid encountering hashes somewhere in the wild. 


{ Talking about wilderness, hyenas have their inecific smells that, are determined, by bacteria in them and are unique to each individual depending on the exact mix of the bacteria, They use these 
smells tó quickly identity each other. The smell is kind of like the animal's hash. But of course the analogy isn't perfect, for example similar mixes of bacteria may produce similar Smells, 
which is not how hashes should behave. ~drummyfish } 


It is good to know that we distinguish between "normal" hashes used for things such as indexing data and [cryptographic] (cryptography md) hashes that are used in computer security and have to 
satisfy some stricter mathematical criteria. For the sake of simplicity we will sometimes ignore this distinction here. Just know it exists. 


It is generally given that a hash (or hash function) should satisfy the following criteria: 


- **Have fixed size** (given in bits), even for data that's potentially of variable size (e.g. text strings). 

- **Be fast to compute**. This is mostly important for non-security uses, cryptographic hashes may prioritize other properties to guarantee the hash safety. But a hash function certainly can't 
take 10 minutes to compute : 
- **Have uniform mapping*r; That is if we hash a lot of different data the hashes we get should be uniformly spread over the space of the hashes, i.e. NOT be centered around some number. This is 
in order for hash tables to be balanced, and it's also required in security (non-uniform hashes can be easier to reverse). 

- **Behave in a chagtic](ehaes md) manner**, i.e, hashes of similar data, should be completely different. This is similar to the point above; a hash should kind of appear, as a "random" number 
associated to thé data (but of course, the hash of the same data has to always be the same when computed repeatedly, i.e. be [deterministic|(determinism.md)). So if you change just one bit in 
the hashed data, you should get a completely different hash from it. 

- **Minimize collisions**, i.e. the probability.of two different values giving the same hash. Mathematically collisions are always.possible if we're mapping a big space onto a smaller one, but 
we should try to reduce collisions that happen in practice. This property shoüld follow from the principle of uniformity and chaotic behavior mentioned above. 

- **Be difficult to reverse** (mainly for security related hashes). Lots of times this comes naturally from the fact that a hash maps a big space onto a smaller space (i.e. it is a non- 
[injective](injective.md) function) and from their chaotic nature. Hashes can typically be reversed only by [brute force](brute force.md). 


Hashes are similar to [checksums] (checksum.md) but are different; checksums are simpler, because their only purpose is.for checking data, integrity, they don't have to have a chaotic behavior, 
uniform mapping and théy are oftén easy to reverse. Hashes are also different from database IDs: IDs are just sequentially assignéd numbers that aren't derived from the data itself, they don't 
satisfy enn properties and they have to be absolutely unique. The term **pseudohash** may also be encountered, it seems to be used for values similar to true hashes which however don't 
quite Satisfy the definition. 


fil wasn't able to find an exact definition of *pseudohash*, but I've used the, term myself e.g. when I needed a.function to.make a string into a corresponding, fixed leggir ID; I took the 
iret N characters of A'S string and appended M characters representing some characteristic of the original string such as its length or checksum -- this is what I calléd t ng's 
pseudohash. ~drummyfis| 


Some common uses of hashes are: 


- [Hash tables](hash table.md), [data structures] (data structure.md) that allows.for quick search and access of data. For example in [chess](chess.md) programs and databases hashes of chess 
poSitions are Used to identify and get some information associated with the position. 

- [Passwords] (password md) in user databases are for security reasons not stored as plain text, instead only password hashes are stored. When a user enters a password, the system computes its 
hash and Compares it to that stored in the database: if the hashes match, the password was correct. This is a way of allowing password authentication without giving the system the knowledge of 
user passwords. 

- In [digital signatures {digital signature md) hashes of documents are used to prove a document hasn't been modified by a third party. _. 

- In. [ioc fingerprints] in9ed) hasan are hàshes computed from known data about a user. The fingerprint is a small number that identifies a tracked user. 


- In. blockchain] (blockchain.md based on proof of work the computational.difficulty of reversing a hash is.used in the process of mining as a puzzle whose solution is rewarded. Miners compete 

in finding bits Such that if appended to a newly added block will result in the block's hash being some defined number. 

## Example 

Let's say we want a hash function for string which for any [ASCII](ascii.md) string will output a 32 bit hash. How to do this? We need to make sure that every character of the string will affect 
e resulting hash. 


First thought that may come to mind could be for example to multiply the ASCII values of all the characters in the string, However there are at least two mistakes in this: firstly short strings 
will result in small values as we'll get a product of fewer numbers (so similar strings such as "A" and "B" will give similar hashes, which we don't want). Secondly reordering thé characters in 
a string (i.e. its [permutations] (permutation md) will not change the hash at all (as with multiplication order is insignificant)! These violate the properties we want in a hash function. If we 
m Eris qunceion to implement a hash table and then tried to store strings such as "abc", "bca" and "cab", all would map to the same hash and cause collisions that would negate the benefits of 
a hash table. 


A better hash function for strings is shown in the section below. 
## Nice Hashes 


Reminder: I make sure everything on this Wiki is pretty copy-paste safe, from the code I find on the Internet I only Copy extremely short (probably uncopyrightable) snippets of public domain 
or at least free) code and additionally also reformat and change them a bit, so don't be afraid of the snippets. -drümmyfish } 


Here is a simple and pretty nice 8bit hash, it outputs all possible values and all its bits look quite random: ( Made by me. -drummyfish } 


uingest hash(uint8_t n) 


n *= 23; 
n= ((n >> 4 n << 4)) * 11; 
n= n>>1 n<< 7 EH 
return n; 


The Lzhash prospector* project (https://github,com/skeeto/hash-prospector (funlicense] (unlicense md) ) created a way for automatic. generation of integer hash functions with nice statistical 
propérties which work by [XORI à] (XbP imd the input value with à bit-shift of itself, en multiplying it by a constant and repeating this a few times. The functions are of the format: 


quoset hash(uint32 t n) 


n-A * (n^ (n >> S1)); 
n- B * (n^ (n >> S2)); 
return n ^ (n >> S3); 


Fes 


Where *A*, *B*, *S1*, *S2* and *S3* are constants specific to each function. Some nice constants found by the project are: 


A B S1 |S2 |S3 


303484085 |985455785 |15 |15 |15 
88290731 _|342730379 |16 |15 |16 
2626628917 |1561544373/16 |15 |17 
3699747495 ]1717085643/16 |15 [15 


The project also explores 16 bit hashes, here is a nice hash that doesn't even use multiplication! 


CIC hash(uinti6 t n) 


n=n+(n << 7); 
n=nA” (n >> 8); 
n=n+ (n << 3); 
n=nA” (n >> 2); 
n=n+ (n << 4); 
return n ^ (n >> 8); 


Here is a nice string hash, works even for short strings, all bits look pretty random: ( Made by me. -drummyfish } 


uint32 t strHash(const char *s) 
uint32 t r - 21; 
while (*s) 


r= (r * 31) + *s; 
Stt; 
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r-r * 4451; 
r = ((r << 19) | (r >> 13)) * 5059; 
return r; 

TODO: more 


T hero culture.md ---------- 
# Hero Culture 


Hero culture is a [harmful](harmful.md) culture of creating and worshiping heroes and "leaders" (and other kinds of [celebrities](celebrity.md)) which leads to e.g. creation of [cults of 
personality](cult_of_personality.md), Strengthening [fight culture](fight_culture.md) and establishing hierarchical, anti-[anarchist fanarchismumdy. society of "winners" and "Losers". The concept 
of a hero is one that arose in Context of [wars] (wor md) and other many times violent conflicts; a hero is different from à mere authority or a well known individual in some area, it is someone 
who creates fear of disagreement and whose image is distorted to a much more positive, sometimes godlike state, by which he distorts truth and is given a certain power over others. Therefore 
[we] (Urs md) nigh by warn about falling to the trap of hero culture, though this is very difficult in current highly hierarchical society. **To us, the word hero has a pejorative meaning**. Our 
advice is always this: 


**Do NOT create heroes. Follow ideas, not people**. And similarly: hate ideas, not people. 


Smart, people know this and those being named *heroes* themselves many times protest it, e.g, Marie Curie has famously stated: "be less curious about pepple and more curious about ideas." 
Anarchists purposefully don't name théories after their inventors but rather by their principles, knowing the danger of hero culture leading to social hierarchy and also that people are 


imperfect -- people are like packages, a mixture of both good and bad inadvertently inseparable, they carry distorting associations, they make mistakes and their images are twisted by history. 
and politics -- even the character of [Jesus](jesus.md), à "theoretically perfect human", has been many times twisted in ways that are hard to believe. Worshiping an individual always comes with 
the tendency to embrace and support everything he does, all his opinions and actions, including the extremely bad ones. Abusive regimes are the ones who use heroes and their names for propaganda 
-- Stalinism, Leninism, corporations such as Ford, named after their founder etc. Heroes become brands whose stamp of approval is used to push bad ideas... especially popular are heroes who are 
already dead and can't protest their image being abused -- see for example how [Einetein:s](einstein md) image has been raped by [capitalists](capitalism md) for their own propaganda, e.g. by 
[Apptel (apple -md) °S [marketing](marketing:md), while in fact Einstein was a pacifist socialist highly critical of capitalism. This is not to Say an idea's name cannot be abused, the word 

ec 


[communism] (communism. md) t has for example ome something akin a swear word after being abused by regimes that had little to do with real communism. Nevertheless it is still much better to 
focus on ideas as ideas always carry their own principle embedded within them, visible to anyone willing to look, and can be separated from other ideas very easily. Focusing on ideas allows us 
to discuss them critically, it allows us to reject a bad concept without "attacking" the human who came up with it. 

T hero.md ---------- 


HEROES ARE [HARMFUL](harmful.md). See [hero culture](hero culture.md). 
l2 exadecimal.md ---------- 
# Hexadecimal 


TODO 

Some hexadecimal values that are also [§nglish] (english.md) words at the same time_and which you may include in your programs for [fun](fun.md) include: ‘ace’, ‘add’, `babe`ò, ^bad^, ^be', “bee”, 
beef’, ‘cab’, ‘cafe’, ‘dad’, ‘dead’, ‘deaf’, ecade', facade’, ‘face, fee , ‘feed. 

T history.md ---------- 

& History 


{ Though history is usually written by the winners, this one was written by a loser :) Keep in mind there may appear errors, you can send me an email if you find some. -drummyfish } 
This is a brief summary of history of [technology](technology.md) and [computers](computer.md). 


The earliest, known appearance of technology related, to humans.is the use of **stone tools** of hominids in Africa some two and a half million years ago. Learning to start, and control **fire** 
was one of the most important advances of earliest humans; this probably happened hundreds of thousands to millions years ago. even before modern humans. Around 8000 BC the **[Agricultural 

Revo lution] (agricultural revoluFion-md) happened. this was a disaster -- as humans domesticated animals and plants, the ad to abandon the comfortable life of hunters and gatherers and 
started to suffer greatly from the extremely hard [work](work.md) on their fields (this can be seen e.g. from their bones). This led to the establishment of first cities. Primitive **writing** 
can be traced to about 7000 BC to China. **Wheel** was another extremely useful technology humans invented, it is not known exactly when or where it appeared, but it might have been some time 
after 5000 BC -- in Ancient Egypt **The Great Pyramid** was built around 2570 BC still without the knowledge of wheel. Around 4000 BC **history starts with first written records**. Humans 
learned to smelt and use metals approximately 3300 BC (**Bronze Age**) and 1200 BC (**Iron Age" i: **[Abacus](abacus.md)**, one of the simplest devices aiding with computation, was invented 
roughly around 2500 BC. However people used primitive computation helping tools, such as bone ribs, probably almost from the time they started trading. Babylonians in around 2000 BC were already 
able to solve some forms of **[quadratic equations] (quadratic_equation.md)**. 


After 600 BC the Ancient Greek [philosophy | (philosophy. md) starts to develop which would lead to strengthening of rational, [scientific](science.md) thinking and advancement of [logic](logic.md) 
and [mathematics] (math md): Around 300 BC Euklid wrote his famous *Elements*, a mathematical work that proves theorems from basic [axioms] axiom.md). Around 400 BC **[camera obscurà] 

caméra obscura.md)** was already described in a written text from China where **[gears](gear.md)** also seem to have been invented soon after. Ancient Greeks could communicate over great 
istances using **Phryctoria**, chains of fire towers placed on mountains that forwarded messages to one another using light. 234 BC Archimedes described the famous [Archimedes Screw] 
(archimedes screw.md) and created an t [algorithm] (algorithm. md) for computing the number [pi)(pi md)". In 2nd century BC the **Antikythera mechanism, the first known fana tog] (analog. md) 
computer** is made to predict movement of heavenly bodies. Romans are known to have been great builders, they built many roads and such structures as the Pantheon (126 AD) and aqueducts with the 
use of their own type of concrete and advanced understanding of physics. 


Around 50 AD Heron of Alexandria, an Egyptian mathematician, created a number of highly sophisticated inventions such as a **vending machine** that accepted coins and gave out holy water, and a 
cart that could be "programmed" with strings to drive on its own. 


In the 3rd century Chinese mathematician Liu Hui describes operations with **negative, numbers**, even though negative numbers have already appeared before. In 600s AD an Indian astronomer 
Brahmagupta first used the number **[zero](zero.md)** in a systematic way, even though hints on the number zero without deeper understanding of it appeared much earlier. In 9th century the Mayan 
empire is [collapsing](collapse.md), though it would somewhat recover and reshape. 


Around the year of our Lord 1450 a major technological leap, known as the **Printing, Revolution** occurred. Johannes Gutenberg, a German goldsmith, perfected the process. of [oduging books in 
carge quantities wae the movable typé press. ThiS made books cheap to publish and buy and contributed to fast spread of information and better education. Around this time the **Gréat Wall of 
China is being built. 


They year 1492 marks the **discovery of America** by Christopher Columbus who sailed over the Atlantic Ocean, though he probably wasn't the first in history to do so, and it wasn't realized he 
sailed to America before his death. 


During 1700s a major shift in civilization occurred, called the P rLrnguerpiat Revolution] {industrial revolution.md)** -- this was another disaster that would lead to the transformation of common 
peoplé to factory slaves and loss of their self sufficiency. The révolution spanned roughly from 1750 to 1850. it was a process of rapid change in the whole society due to new technological 
inventions that also led to big changes in how people lived their everyday lives. It started in Great Britain but quickly spread over the whole world. One of the main changes was the 
**transition from manual manufacturing to factory manufacturing** using machines and sources of energy such as coal. **[Steam engine](steam engine.md) played a key role**. Work became a form of 
a highly organized slavery system, society became industrionalized. This revolution became highly [criticized](ted_kaczynski.md) as it unfortunately opened the door for [capite tiom] 
(capitalism.md), made people dependent on the system as everyone had to become a specialized cog in the society machine, at this time people started to measure time in minutes and lead very 
planned lives with less joy. But there was no way back. 


In 1712 Thomas Newcomen invented the first widely used **[steam engine] (steam, engine.md)** used mostly for pumping water, even though steam powered machines have already been invented_long time 
ago. The engine was significantly improved by [Jàmes Watt](james wáàtt.mi in 1776. Around 1770 Nicolas-Joseph Cugnot created a first somewhat working **steam-powered [car](car.md)**. In 1784 
William Murdoch built à small prototype of a **[steam locomotive] (steam ocomotive.md)** which would be berrecre over the following decades, leading to a transportation revolution; people would 
be able to travel far away for work, the world would become smaller which would be the start of **[globalization](globalization.md)**. The railway system would make common people measure time 
with minute precision. 


In 1792 Clause Chappe invented [optica telegraph](optical telegraph.md)**, also called *semaphore*. The system consisted of towers, spaced, up, to by 32 km which forwarded textual messages by 
arranging big arms on top of the towers to signal specific letters. With this messages between Paris and Strasbourg, i.e. almost 500 km, could be transferred in under half an hour. The System 
was reserved for the government, however in 1834 it was **[hacked](hack.md)** by two bankers who bribed the tower operators to transmit information about stock market along with the main message 
(by setting specific positions of arms that otherwise didn't carry any meaning), so that they could get an advantage on the market. 


By 1800 Alessandro Volta invented an **electric battery**. In 1827 André-Marie Ampère publishes a further work shedding light on felectromagnetism] (electron neciem ma). After this **[electric 
telegraph] (telegraph md)*: would be worked on and improved by several people and eventually made to work in practice. In 1821 Michael Faraday invented the **[electromotor](electromotor.md)**. 
Georg Ohm and especially [James Maxwell](maxwell.md) would subsequently push the knowledge of electricity even further. 


In 1822 [Charles Babbage](charles babbage.md), a great English mathematician, completed the first version of a manually powered **[digital](digital.md) mechanical computer** called the 
Difference Engine to hélp with the computation of [po tynomial] (pol nomial.md) [derivatives] (derivative md) to create mathematical tables used HTR in navigation. It was met with success and | 
further development was funded by the government, however difficulties of the construction led to never finishing the whole project. In 1837 Bab age designed a new machine, this time a **[Turing 
complete] (turing com lete.md) general purpose computer**, i.e. allowing for programming with branches and loops, a true marvel of technology. It also ended up not being built completely, ut it 
showed a lot about what computers would be, e.g. it had an [assembly](assembly.md)-like programming language, memory etc. For this computer [Ada Lovelace](ada_lovelace.md) would famously write 
the Bernoulli number algorithm. 


In 1826 or 1827 French inventor Nicéphore Niépce captured **first [photography] (photo. 
(some say it may have taken several Hays )- He used à [camera obscura](camera obsScura.m 
ort 


a2 that, survived until today -- a view from. his estate.named Le Gras. About an 8 hour exposure was used 
as early as 1717, but they were only sli 


cus and asphalt plate that hardened where the light was shining. Earlier cases of photography existed maybe 
ived. 


**Sound recording** with phopatograph was invented in 1857, in Paris, however it could not be played back at the time -- the first record.of human voice made with this technology can nowadays be 
reconstructed and played back. It wouldn't be until 1878 when people could both record and play back sounds with [Edison | feeison.md) S improvement of phonatograph. A year later, in 1879, Edison 
also patented the **light bulb**, even though he didn't invent it -- there were at least 20 people who created a light bulb before him. 


Around 1888 so called **war of the currents** was taking place; .it was a heated battle between companies and inventors for whether the alternating] {ac.md) or [direct] (decmd) current would 
become the standard for distribution of electric energy. The main actors were [Thomas Edison](edison.md), a famous iventor and a huge capitalist di rooting for DC, d Geof ge Westinghouse, the 
promoter of AC. Edison and his friends used false claims and even killing of animals to show that AC was wrong and dangerous, however AC was objectively better, e.g. by its efficiency thanks to 
using high voltage, and so it ended up winning the war. AC was also supported by the famous genius inventor [Nikola Tesla](tesla.md) who during these times contributed hugely to electric 
engineering, he e.g. invented an AC motor and Tesla coil and created a system for wireless transmission of electric power. 


Also in 1888 probably the alkene [video] (video. md) ** that survived until today was recorded by Lou Le Prince in Northern England, with a single lens camera. It is a nearly 2 second silent black 
and white shot of people walking in a garden. 


1895 can rough be seen as_the year of **invention of radio**, specifically wireless [telegraph] (telegraph .md) , by Italian engineer and inventor Guglielmo Marconi. He built on top of work of 
others such as Yuertz](nertz.md) and [Tesla](tesla.md) and created a device with which he was able to wirelessly ring a bell at a distance over 2 km. 


On December 17 1903 the Wright brothers famously performed the **first controlled flight of a motor airplane** which they built, in North Carolina. In repeated attempts they flew as far as 61 
meters over just a few seconds. 


Around 1915 [Albert Einstein](einstein,md), a German physicist, completed his **[General Theory of Relativity] (relativity md", a groundbreaking physics theory that describes the fundamental 
nature of space and time and gives so far the best description’ of the Universe since [Newton](newton.md). This ‘wou shake the world of science as well as popular culture and would enable 
advanced technology including nuclear energy, space satellites, high speed computers and many others. 


Int 1907 Lee De Forest invented a practically usable A tL vacuum tube](vacuum tube.md)**, an extremely important part usable in.electric devices for example as an amplifier or a switch -- this 
would enable construction of radios, telephohes and latér even primitive computers. The invention would lead to the [electronic](electronics.md) revolution. 


In 1924 about 50% of US households own a car. 


October 22 1925 has seen, the invention of right ansister | (transistor. md ** by Julius Lilienfeld (Austria-Hungary), a component, that would replace vacuum tubes, thanks to its better properties, and 
which would become probably the most essential part of Computers. At the time the invention didn't see much attention, it would only become relevant decades later. 


In 1931 [Kurt Godel] (kur t_godel md), a genius mathematician and logician from Austria-Hunagry (nowadays Czech Republic), published revolutionary papers with his [incompleteness theorems 
(incompléteness.md) which proved that, Simply put, mathematics has fundamental limits and "can't prove everything". This led to [Alan Turing] (turing.md) 's publications in 1936 that nowadays 
Stand as the **foundations of [computer science](compsci.md)** -- he introduced a theoretical computer called the "ilr uring machine](turing máàchine.md)** and with it he proved that computers, no 
matter how powerful, will never be able to "compute everything". Turing also predicted the importance of computers in the future and has created several [algorithms](algorithm.md) for future 
computers (such as a [chess](chess.md) playing program). 


In 1938 _ [Konrad Zuse](konrad zuse.md), a German engineer,, constructed geet soar a the first working electric mechanical [digital] (digital.md) partially programmable .computer** in his parents' 
house. It weighted about a ton and wasn't very reliable, but brought hugé innovation nevertheless. It was programmed with punched film tapes, however programming was limited, it was NOT Pruning 
complete](turing_complete.md) and there were only 8 instructions. Z1 ran on a frequency of 1 to 4 Hz and most operations took several clock cycles. It had a 16 word memory and worked wit 
[floating point} (float .md) numbers. The original computer was destroyed during the war but it was rebuilt and nowadays can be seen in a Berlin museum. 


In hacker culture the period between 1943 (start of building of the [ENIAC](eniac.md) computer) to about 1955-1960 is known as the **Stone Age of computers** -- as the [Jargon File] 
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(jargon file.md) puts it, the age when electromechanical [dinosaurs](dinosaur.md) ruled the Earth. 


In.1945 the construction of **the first electronic digital fully programmable computer** was completed at University of Pennsylvania as the US Armi project. It was, named **[ENIAC](eniac.md)** 
(Electronic Numerical Integrator and Uer Et It uséd 18000 vacuum tubes and 15000 relay weighted 27 tons and ràn on the frequency of 5 KHz. [Punch cards] (punch, card -md were used to program 


S 
the computer in its machine language; it was [Turing complete](turing_complete.md), i.e. allowed using branches and loops. ENIAC worked with signed ten digit decimal numbers. 


Among hackers the period between 1961 to 1971 is known as the **Iron Age of computers**. The period spans time since the first minicomputer ([PDP1](pdp1.md)) to the first microprocessor ([Intel 
4004] (date (4004 md ). This would be followed by so called *elder days*. 


On July 20 1969 **first men,landed on the Moon** {Neil Armstrong and. Edwin Aldrin) during the USA Apollo 11 mission. This tremendous achievement is very much attributed to the cold war in which 
USA and Soviet Union raced in space exploration. The landing waS achieved with thé help of a relatively simple on-board computer: Apollo Guidance Computer clocked at 2 MHz, had 4 KiB of [RAM] 
(ram.md) and about 70 KB [ROM](rom.md). The assembly source code of its software is nowadays available online. 


Shortly after, on 29 October 1969, another historical event would happen that could be seen as the start of perhaps the greatest technological, revolution yet, the **start of the [Internet] 
(interhet.md)**. The first letter, "L", was sent over a long distance via "EL RPANET] (ar panet md **, a new experimental Computer [packet Switching](packet switching.md) network without a Central 
node deve taped by. US defense department (they intended to send "LOGIN" but the system crashed). The network would start to grow and gain new nodes, at first mostly universities. The network 

wou ecome the Internet. 


ist January 1970 is nowadays set as the start of the **Unix epoch**. It is the date from which [Unix time](unix time.md) is, counted, During this time the pelUnix (unix.md) operating system] 
(os.m ohe of the most influential operating systems** was being developed at (perl Labs] (bel _labs.md), mainly by [Ken Thompson (ken Enompson md} and [Dennis a tenia] (de nis ritchie.md). 
Along the way they developed the famous [Unix philosophy](unix_philosophy.md) and also the e programming ganguage] c.md)**, perhaps the most influential programming language in history. Unix 
and C wou Ld Shape the technology far into the future, a whole family of operating systems called Unix-like would be developed and regarded as the best operating systems thanks to their 
minimalist design. 


By 1977 ARPANET had about 60 nodes. 


August 12,1981 would see the released of **[IBM pe (ibm pand) wee a 
st ndard](de facto standard.md) of personat computérs. IBM PC'was thi 


used 5.25" [floppy disks](floppy.md 


pe nal gomputer based on open, modular architecture that would immediately be very successful and would become the [dej factg 
e the ki 4.77 MHz [Inte Y of [RAM](ram. 


rso 
first of nd of desktop computers we have today. It had 1 8088](intel.md) CPU, 16 kB of md) and 


In 1983 **[Richard Stallman](rms.md) announced his [gyu1(gnu-md) project and invented [free (as in freedom) software](free_software.md)**, a kind of software that is freely shared and developed 
by the people so as to respect the üsers' freedom. This kind of ethical software stands opposed to the [proprietary](proprietary.md) corporate software, it would lead to creation of some of the 
most important software and to a whole revolution in software development and its licensing, it would spark the creation of other movements striving for keeping ethics in the information age. 


1985: on November 20 the first version of the n. [Uindows] (windows md) operating system’. was_sadly released by [Microsoft] (microsoft md). These systems would become the mainstream desktop 
operating systems despite their horrible design and they would unfortunately eStablish so_ called [windows philosophy] (windows_philosophy.md) that would irreversibly corrupt other mainstream 
techno logy. Also in 1985 one of the deadliest software Ybugs]}(bug.md) appeared: that in [Therac-25](therac_25.md), a medical radiotherapy device which fatally overdosed several patients with 
radiation. 


On April 26 1986 the y Gchernoby tl (ehernobyl md) nuclear disaster * happened the worst power plant accident in history) -- in north Ukraine (at the time under [USSR](ussr.md)) a nuclear {power 

plant](power plant.md) exploded, Contaminated a huge area with [radioactivity](radioactivity.md) and released a toxic radioactive cloud that would spread over Europe’ -- many would die either 

direct Y or indirectly (many, years later due to radioactivity poisoning, estimated at many thousands). The Chernobyl area would be sealed in the 30 km radius. It is estimated the area won't be 
e 


habitab again for several ousands of years. 
Around this time [Internet] (internet mdp is not yet mainstream but it is, along with similar local networks, working and has active communities -- there is no world wide web yet but people are 
using [Usenet](usénet.md) and [BBSes](bbs.md) for "online" discussions with complete strangers and developing early "online cultures". 


At the beginning of 1991 [Tim Berners-Lee](berners lee.md) created the **[World Wide Web](www.md)**, a network of interlinked pages on the Internet. This marks another huge step in the Internet 
revolution, the Web would become the primary Internet service and the greatest software platform for publishing any kind of information faster and cheaper than ever before. It is what would 
popularize the Internet and bring it to the masses. 


Shortly_after the **[Soviet Union] (ussr md) dissolved** and on 25 August 1991 cul ius Torvalds] (Linus. torvalds.md) announced [Linux](linux.md)**, his project for a completely [free as in 
freedom] (free software md) Unix-like [operating system](os.md) kernel. Linux would become part of [GNU](gnu.md) and later one of the biggest and most successful software projects in history. It 
n 


would e up powering Internet servers and supercomputers as well as desktop computers of a great number of users. Linux proved that free software works and surpasses proprietary systems. 


After this very recent history follows, it's hard to judge which recent events, will be of historical significance much later. 1990s have seen a huge growth of computer power, video Dearga 

(game ma) such as [Doom](doom.md) led to development of SPU I (opu md) s and high quality computer graphics along with a wide adoption of computers by Common people, which in turn hel d th 

urther growth of Internet. During the 90s we've also seen the rise of the [open source movement] (open_source. ad) . Shortly after 2000 [Lawrence Lessig](lessig.md) founded [Creative Commons] 
(creative_commons.md), an Organization that came hand in hand with the [free culture] (free culture md) Movement inspired the [free software movement ](free_software.md). At this point over 50% 
of US households had a computer. Cell phones became a commonly owned item and after about 2005 so called "Pomart] (smart md phones" and other "smart" devices replaced them as a universal 
communication device capable of connecting to the Internet. Before 2020 we've seen a huge advancement in [neural network](neural network.md) [Artificial Intelligence](ai.md) which will likely be 
the topic of the future. [Quantum computers](quantum md) are being highly researched with already existing primitive prototypes; this will also likely be very important in the following years. 
Besides AI there has appeared a great interest and development of Virtua] reality VE ma): [drones] (drone md), electromobiles, robotic Mars exploration and others. However the society and 
techno log has generally seen a decadence after 2010, [capitalism](capitalism.md às pushed technology to become hostile and highly abusive to users](capitalist_software.md), extreme [bloat] 
bloat.m y of techno logy causes highly inefficient, extremely expensive and unreliable technology. In addition society is dealing with a lot of serious issues such as the {global warming] 

global warming.md) and many people are foreseeing a [collapse of society](collapse.md). 


## Recent History Of Technology 


TODO: more detailed history since the start of Unix time 
l1 holy war.md ---------- 
# Holy War 


Holy war is a pgrpetual passionate argument_over usually two possible choices. This separates people into almost religious teams that sometimes argue.to death.about details such as what name 
something should be given, very much resembling traditional disagreements between religions and their churches. In holy wars people tend to defend whichever side they stand on to the death and 
can get emotional when discussing the topic. Some examples of holy wars are (in brackets indicated the side taken by [LRS](lrs.md)): 


**[tabs](tab.md) vs spaces** (spaces) , 
**[vim](vim.md) vs [emacs] (emacs cmd) * (vim) 

**[free software](free software.md) vs [open source](open source.md)** (free software) 
**[chrome](chrome.md) vs [Firefox (fire ox.md)**, and other browsers 

Em, Java] (Java md) vs [C++](cpp.md)**, and other [programming languages] programming, language md) (lel Ce md) . 
**[curly brackets on Separate lines or not] (programming st e.md)**, and other [style](programming style.md) choices 
**TKDE](kde.md) vs GNOME] (gnome md) 77 neither, both àre [bloat (bloat.md)) 

**pronunciation of [gif](gif.md) as "gif" vs "jif"** 

**Twindows ](windows.md) vs [Mac](mac.md)** (ngather, this is a normie holy war) 

Um [SNU] (gnu md)/L'inux. vs "[Linux](linux.md)"** 

**[copyle EI (copy tert md). vs [permissive](permissive.md)** (permissive, [public domain](public domain.md)) 
**[AMD](amd.md) vs [Intel](intel.md)** 

**TAMD](amd.md) vs [NVidia](nvidia.md)** 

**"Linuüx" [distros](distro.md)** 

** [window managers](wm.md)** 

**[Metric](metric system.md) vs [Imperial](imperial_units.md) units** (metric) 

**Star Trek vs Star Wars**, and other franchise wars 

**Pepsi vs Coca Cola**, and other brand wars 

**[Quake](quake.md) vs Unreal Tournament**, and similar gaming shit 


Things like, cats vs fogs or sci-fi, vs fantasy, may or may not be a hol r, there is a bit, of a doubt in the fact that one can easily like both and/or not be such a diehard fan of one or the 
other. A subject of holy war probably has to be Something that doesn't allow too much of this. 


T how to.md ---------- 


WELCOME TRAVELER 
{ Don't hesitate to contact me. -drummyfish } 


Are you tired of fbtoat] (bloat md) and can't stand [shitty](shit.md) software like [Windows] (windows md) anymore? Do you want to [kill yourself | (suicide md)? Do_you_hate [ca itatism] 
(Capitalism md)? o you also hate the [fascist alternatives|(tranny software.md) you're being offered? Do you just want to create a genuinely good [bullshi tess] {bullshit md) technology that 
would help all people? Do you just want to share knowledge freely without [censorship](censorship.md)? You have come to the right place. 


Firstly let us welcome you, no matter who you are, no matter your political opinions, your past and your skills, color or shape of your genitalia, we are glad to have you here. Remember, you 
don't have to be a programmer to help and enjoy LRS. LRS is a lifestyle, a philosophy. Whether you are a programmer, artist, educator or just someone passing by, you are welcome, you may enjoy 
our culture and its fruit and if you want, you can help enrich it. 


## Tech 
Here are some extremely basic steps to take regarding technology and the technological aspect of LRS: 


- **Learn about the most essential topics and_concepts**, mainly [free software) (free software,md), " open-source] (gpen_source smd): bloat (bloat md), kiss](kiss.md) ,fcapitalism] 
(capitalism.md), [capitalist software](capitalist softwafe.md), [Suckless](suckless.md), [LRS[(lr$.md), [less retarded society](lésS retardéd society.md), [anacho pacifism](anpac.md) and [type 
A/B fail] (fait ab ma). You will also need to open up your mind and re-learn some toxic concepts you've been taught by the system, e.g. [we do NOT fight anything](fight culture.md), we do NOT 
create any [heroes](Rero.md) or "leaders" (we follow ideas, not people), [work](work.md) is bad, older is better than "[modern](modern.md)" etc. 
- **Install [GNU gnu mds [Linux] CLinux md) *7, operating, system to free yourself from shit, like, [Windows](windows.md) and [Mac] (mac. md) (Yay, can also consider BSD] (bed md) but you're probably . 
too noob for that). Do NOT try to switch to "Linux" right away if it's your first time, it's almost impossible, you want to just install "Linux" as [dual boot](dual_boot.md) (alongside your main 
21) or on another computer (easier). This way you'll be using both operating systems, slowly getting more comfortable with "Linux" and eventually. you tt find yourself uninstalling Windows Pp 
altogether. You can also just try "Linux" in a jVintust machine (vm. md), from a live CD/flash drive or you can buy something with "Linux" preinstalled like [Raspberry Pi](raspberry.md). **which 
"Linux" to install?** There are many options and as a noob you don't have to go hardcore right away, just install any [distro](distro.md) that [just werks](just werks.md) (don't listen to people 
who tell you to install [Gentoo](gentoo.md) tho). You can try these: 

- [Devuan](devuan.md): Nice, [LRS](lrs.md) approved distro that respects your [freedom] (free software.md) that just works, is easy to install and is actually nice. Good for any skill level. 

- [Debian](debian.md): Like Devuan but uses the evil LSystend] (systemd.md} which doesn't have to bother you at this point. Try Debian if Devuan doesn't work for any reason. 
f Mint](mint.md): More noob, [bloated](bloat.md) and mainstream distro that only mildly cares about freedom, but is extremely easy and works almost everywhere. Try this if Debian didn't work 
or you. 

- [Ubuntu](ubuntu.md): Kind of like Mint, try it if Mint didn't work. 
- **Learn a bit of [command line](cli.md)*" (Unix utils, [bash](bash.md) etc.). No need to become a hacker right away, just get familiar with this essential Unix tool. 
- **Free yourself technologically**, i.e. make yourself depend as little as possible on capitalist technology, this, step if crucial, you can't really live well or achieve anything while being a 
slave. This includes firstly leaving proprietary platforms such as tracebook} (Facebook md)" Google](google.md)'s platforms such as [YouTube](youtubé.md), reddit](reddst md) etc. Also stop 
being dependent on proprietary programs ([MS](microsoft.md) office, [photoshop] (photoshop md etc.), and proprietary consumer devices such as a [smartphone[(smartphone.md). Again, it's 
impossible to free yourself 100% immediately, go slowly and try to get more freedom even if you can't achieve 100% freedom. This means either stop using harmful software/Services/devices and 
engaging in bad habits (social media etc.) or at least minimize their use, and/or use more freedom-friendly alternatives such as different [search engines](search engine.md) (e.g. [searx] 


searx.md), bini a [dumbphone](dumbphone.md) or at least [free](free software.md) OS smartphone rather than capitalist [smartphone](smartphone.md), freedom friendly lapto (8:3; an old 
thinkpad](thinkpad.md)) rather than iShit or consumerist gayming PC, start using **[FOSS](foss.md) programs**, eB: [GIMP](gimp.md) instead of Photoshop, [LibreOffice](libreoffice.md) instead 
of e.md) instead o YouTube | ( er, it 1s best if you can stop using something altogether, the second best 


MS Office etc, [invidious (invidious mdy or [Peertube](peertul youtube máy etc. Remem 
thing is to stop being dependent on a single entity, try to use a decentralized and/or [suckless](suckless.md) [FOSS](foss.md) alternative but do not try to just mimic your old habits in the 
FOSS world, you have to learn new ways of computing (for example start using multiple search engines instead of relying on one, it's not good to just drop-in replace one search engine for 
another). Avoid falling to traps of shit like [distrohopping](distrohopping.md), this just enslaves you in a different way. 

- If.you want to program [ERS] (Urs md), **learn [eife maar Sees the fgytorial) (c tutortal .md)). Also learn a bit of [POSIX shell] osix_shel} md) and maybe some mainstream [scripting | 2 
(script md) language (can be even a bloated one tikè [Python](python.md)). Learn about [licen$ing](license.md) and [version contr Tcs-ndy ([git](git.md)). As you advance, star tüdying 
eeper topics such as [history](history.md) or [hacker culture](hacking.md) etc. 


- Optionally make your own minimal [website] (web. md) (or even a gephgrhplel(gopher.md]) to help reshare_ ideas vou like (static, [HTML](html.md) site without [JavaScript](javascript.md)). This 
is very easy, and the site can be hosted for free e.g. on [git](git.md) hosting sites like Codeberg or GitLab. Get in touch with us. 


- Start creating something: either programs or other stuff like [free art](free culture.md), educational materials etc. 

- profit??? 

Would you like to create [LRS](lrs.md) but don't have enough spare time/money to make this possible? You can check out [making living](living.md) with LRS. 
## How to Live, Dos and Don'ts 


This is a summary of some_main guidelines on how an LRS supporter_should behave in general so as to stay consistent with LRS philosophy, however it is important that this is shouldn't be taken 
as rules to be blindly followed -- the last thing we want is a religion of brainwashed NPCs who blindly follow orders. One has to understand why these principles are in place and even 
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potentially modify them. 


- **Do NOT [fight] (fight culture.md)** do NOT say you, fight something . Fighting and rhetoric centered around "fighting something" is part of harmful [fight culture) (fi ht_culture.md), most 

people don't even realize they take part in it. It 1s important to unlearn this. We do not want to defeat anyone, we want to convince by means of rationality, nonviolence and love. However note 

that what is unacceptable to do to a living being may be completely acceptable to do to non living object (for example destroying a corporation is OK, in fact it is very desirable). We often 

take actions that common people would call a "fight" (for example we may organize a strike), however it is important that we don't call it a fight -- a point of view is sometimes as important as 

the action itself as it will determine our future direction. Remember that aming is important](name_is_important.md). 

- **Do NOT worship or, create [heroes] hero culture,md don't become one**. It is another common mistake to for example call. [Richard Stallman] (rms.md) a "hero of free software" and to even 

worship him as a celebrity. The concept of a hero is [harmful](harmful.md), rightist concept that is connected to war mentality, it goes again [anarchist](anarchism.md) principles, it creates 

social hierarchy and given some people a power to deceive. People are imperfect and make mistake -- only ideas can be perfect. Respect people but don't make anyone your moral compass, you should 

rather subscribe to specific ideas, i.e. rather than worshipping Stallman subscribe to and promote his idea of [free software](free_software.md). 

- **Lead an examples this is the best way to spread our values, however be also extremely careful not to become a worshipped [authority] (hero-culture md) - Know the difference between a humble 

intellectual authority and an authoritative self-centered celebrity who uses his fame for deception. The more famous you are, the more humble you should bécome. 

- **Be loving, even towards opposition’ s -- remember: hate and revenge towards people perpetuates the endless circle. [Love](love.md) leads to more love, understanding, good deeds, friendship, 

happiness, collaboration and all the other positive things. Do not confuse love with [political correctness](political correctness.md). 

- **Protest in non-violent ways** -- this.doesn't mean you should be passive; you should be exposing the truth, propaganda, corruption, .boycotting.corporations and, state, promoting your, values 

and expressing disagreement with certain ideas, but do hot aim for destruction’ of those who stand iñ opposition -- if you're attacked, it is best if you do not fight back; not only is this the 

morally ideal thing to do, it also sends a very powerful message and makes the aggressor himself think. 

- **Do NOT support [pspudolett] pseudoleft.md) (pher (lgbt.md), [feminism](feminism.md), [Antifa](antifa.md), [soyence](soyence.md) ...)**, don't become [type A fail](fail ab.md). Of course you 

should equally reje [rightism](right.md), but that goes without saying. 

- **Do NOT engage in [political correctness](political_correctness.md)**. Remember that staying silent often means supporting status quo, so the more deceit you see in society, the more you 

should try to not stay silent and the more you should try to tell the truth. 

<- **Free yourself from the systeme: -- similarly to how you free yourself technologically, free yourself also socially, live frugally and minimize your expenses. Stop consuming, stop living in 

luxury, stop spending money for shit (gyms, sports, clothes, car, streaming services, games, cigarettes, ...), use free things that people throw away and enjoy hobbies that arë cheap 

(programming, reading books, going for walks, playing chess, 5. You need very little to live, you don't even need internet connection; with good Computing you can hack offline and only 

connect to the internet once in a while on some public wifi to download emails and upload your programs. Make yourself self sufficient, prepare for the [collapse](collapase.md). If you can live 

somewhere in the woods, go for it. 

- **Search for [Eruth] (truth md) er You won't find it easily, real truth is always censored and hidden, (though often in plain sight) but you can train yourself to spot propaganda and see the 

red flags . You won't find truth’ through Google, use different sources, read old books and different points of view (e.g. contrast articles on [Wikipedia](wikipedia.md) with those on 

[Infoga actic| (3nfogalactic.d))- Question EVERYTHING (absolutely everything, even this): Do not fall into traps such as [pseudoskepticism] (pseudoskepticism.md) 

critically, avoid [shortcut thinking](shortcut_thinking.md), question your own biased beliefs and wishes. 

- nivedest harmful things like [proprietary] (proprietary. md) software, [ca 4 fa lism] (capitalism md), [copyright (gop right.md), float] (bloat.md), [work](work.md) etc.** Use and promote the 
i.é. A h 


ethical equivalents, [free software](free_software.md), [free cuiture](free_cultture.md), frugality, [anarchism](anarchis$m.md) e 


Train your mind to think 


## How To Live 


# Hardware 


Hardware (HW), as opposed to [software] (sw.md), are the physical parts of a [computer](computer.md), i.e. the circuits, the mouse, keyboard, the printer etc. Anything you can smash when the 
machine pisses you off. 

T2 hyperoperation.md ---------- 

& Hyperoperation 


*WARNING: brain exploding article* 
*UNDER CONSTRUCTION* 
{ This article contains unoriginal research with errors and TODOs, read at own risk. -drummyfish } 


Hyperoperations are [mathematical] {math md) operations that are generalizations/continuations.of the basic arithmetic operations of addition, multiplication, exponentiation etc. Basically 
they're like the basic operations like plus but on steroids. When we realize that multiplication is just repeated addition and exponentiation is just repeated multiplication, it is possible to 
continue in the same spirit and keep inventing new operations by simply saying that a new operation means repeating the previously defined operation, so we define repeated exponentiation, which 
we call tetration, then we define repeated tetration, which we call pentation, etc. 


There are infinitely many hyperoperations as we can go ọn and on in defining new operations, however we start with what seems to be the simplest operation we can think of; the successor 
operation (we may call it *Sücc^, *+1*, *++*, *next*, *increment*, *zeration* or similarly). In the context of hyperoperations we call this operation *hyper0*. Successor is a [unary](unary.md) 
operator, i.e. it takes just one number and returns the number immediately after it (suppose we're working with Yhatural numbers](natural_number.md)). In this successor is a bit special because 
all the higher operations we are going to define will be binary (taking two numbers). After successor we define the next operation, addition (*hyperi*), or *a + b*, as repeatedly applying the 
successor Operation *b* times on number *a*. After this we define multiplication (* pera). or *a * b*, as a chain of *b* numbers *a*s which we add together. Similarly we then define 
exponentiation (*hyper3*, or raising *a* to the power of *b*). Next we define tetration (*hyper4*, building so called [power towers](power_tower.md)), pentation (*hyper5*), hexation (*hyper6*) 
and so on (heptation, octation, 


Indeed the numbers obtained by high order hyperoperations grow quickly as [fuck](fuck.md). 


An important note is this: there are multiple ways to define the hyperoperations, the most .common one seems to be by supposing the **right associative** evaluation, which is what we're going to 
implicitly consider from now on. This means that once associativity starts to matter, we will be evaluating the expression chains FROM RIGHT, which may give different results than evaluating 
them from left (consider e.g. ~24(243) !- (2^2)^3^). The names tetration, pentation etc. are reserved for right associativity operations. 


The following is a sum-up of the basic hyperoperations as they are commonly defined (note that many different symbols are used for these operations throughout literature, often e.g. up arrows 
are used to denote them): 


commutative|associative 


operation 


successor (hyper0) 

addition (hyperz) bi WY, *b* succs yes yes 
multiplication yper2 * b* *a*s in brackets yes yes 
exponentiation (hyper3 ree ,.*b* *a*s in brackets no no 
etration (hyper4 aA (...)°, *b* *a*s in brackets no no 
entation (hyper5 a^^ (. ^, *b* *a*s in brackets no no 
exation (hyper6) a^^^(... *b* *a*s in brackets no no 

Mos no more no more 


2 *1 *1 *1 *1 *1 +1 os aera successor 
L1 / / 9 
/ / / 
/ / / 
£d om W£2'*.2 > bs 2 2? 72-0 addition 
4 Sy / 16 
/ / 
/ / 
2E dA OR oS 2 Re Ta. et. uds OF ALS riis multiplication 
4 8 / 16 32 64 128 256 
if 
2. M(2. Re (2A (? AR N (2. A (22 AL (2. vu exponentiation 
4 16 / 65536 -10^19000 : 
i) not sure about arrows here, numbers get too big, TODO 
2 ^^(2 ^^2 ^^(2 ^^2 ^^2 ^^2 ^(2 ... tetration 
4 65536 
not sure about arrows here either 
2 ^^^(2 ^^^(2 ^^^(2 ^^^(2 ^^^(2 ^^^(2 ^^^(2 ... pentation 
ES 4 65536 t 


pre things generally hold about hyperoperations, for example for any operation *f = hyperN* where *N >= 3* and any number *x* it is true that *f(1,x) = 1* (just as raising 1 to anything gives 


[Hyperroot](hyperroot.md) is the generalization of [square root](sqrt.md), i.e. for example for tetration the *n*th hyperroot of number *a* is such number *x* that *tetration(x,n) = a*. 


**Left associativity hyperoperations**: Alternatively left association can,be considered for defining hyperoperations which gives different operations. Here is the same picture as above, but for 
Wi 


left associativity -- we see the numbers don't grow THAT quickly (but still pretty quickly). 


2 *1 *1 *1 *1 *1 *1 SE sel successor 
uf. / f. 9 
"n / / 
/ / / 
*. x02 a2, € o020BSO Se YY a eT addition 
4 — / 16 
/ / 
/ / 
o P T or Be Dh ID ID BF qr ODS! uos multiplication 
4 _/ 16 32 64 128 / 256 
/ / 
f / 
(2 o ^02) Ns QR 2y DY ^72) 2 sa left exponentiation 
4 16_/ 256 65536 ~3*10438 
/ / 
(2 AA 2) ^^ 2) ^^ 2) ^^ 2) ^^ 2) ANZ) ^^2 ... left tetration 
4 256 2^1048576 
TODO: arrows? 
(2 ^^^ 2)^^^ 2)^^^ 2)^^^ 2)^^^ 2)^^^ 2)^^^ 2  ... left pentation 
Seats 4 ~3*10438 


In fact we may choose to randomly combine left and right associativity to get all kinds of weird hyperoperations. For example we may define tetration with right associativity but then use left 
associativity. porsche next operation above it (we could call it e.g. "right-left pentation"), so in fact we get a binary [tree](tree.md) of hyperoperations here (as shown by M. Muller in his 
paper on this topic). 


## Code 


Here's a [C](c.md) implementation of some hyperoperations including a general hyperN operation and an option to set left or right associativity (however note that even with 64 bit ints numbers 
overflow very quickly here): 


#include <stdio.h> 
#include <inttypes.h> 
#include <stdint.h> 


#define ASSOC_R 1 // right associativity? 
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// hyper® : 
uint64 t succ(uint64 t a) 


return a * 1; 


// hyperi 
uint64 t add(uint64 t a, uint64 t b) 


for (uint64_t i = 0; i < b; ++i) 
a = succ(a); 


return a; 
// return a + b 


// hyper2 
AnESASE multiply(uint64 t a, uint64 t b) 


uint64 t result - 0; 


for (uint64_t i = 0; i < b; ++i) 
result += a; 


return result; 
// return a * b 


) 


// hyper(n + 1) for n» 2 
uint64 t nextOperation(uint64 t a, uint64 t b, uint64 t (*operation)(uint64 t,uint64 t)) 


if (b == 0) 
réturn 1; 


uint64 t result - a; 


for (uint64 t i 
result - 
#if ASSOC R 
operation(a,result); 
#else i 
operation(result,a); 
sendif^" : vr 


0; i<b - 41; ++i) 


return result; 
74 bypera ! . 
uint64 t exponentiate(uint64 t a, uint64 t b) 
return nextOperation(a,b,multiply); 
// hyper4 
uint64 t tetrate(uint64 t a, uint64 t b) 
return nextOperation(a,b,exponentiate); 
// hyper5 
uint64 t pentate(uint64 t a, uint64 t b) 
return nextOperation(a,b,tetrate); 
// hyper6 
uint64 t hexate(uint64 t a, uint64 t b) 
return nextOperation(a,b,pentate); 
// hyper(n) 
integet hyperN(uint64 t a, uint64 t b, uint8 t n) 
switch (n) 
case 0: return suge (a); break; 
case 1: return add(a, 5; break; 
case 2: return multiply(a,b); break; 
case 3: return exponentiate(a,b); break; 
" default: break; 


if (b 9) 
return 1; 


uint64 t result - a; 


for (uintóà t i = 0; i < b - 1; ++i) 
result = hyperN( 

#if ASSOC_R 
a,result 

#else 
result,a 

#endif 
mm - 1); 


return result; 


int main(void) 
printf("\to\ta\t2\t3\n"); 
for (uint64_t b = 0; b < 4; ++b) 
printf("%" PRIu64 "\t",b); 


for (uint64 t a = 0; a < 4; ++a) 
printf("%" PRIu64 "Nt",tetrate(a,b)); 
printf("Nn"); 


return 0; 


In this form the code prints a table for right associativity tetration: 


0 1 2 3 
0 1 1 1 1 
1 0 1 2 3 
2 1 1 4 27 
3 0 1 1 7625597484987 


T1 information.md ---------- 
# Information 


*Information wants to be free.* 


Information is knowledge that can be used,for making decisions. Information is interpreted [data] (data.md), i.e. while data itself may not give us any information, e.g. if the 
we don't know the key or if we simply don't know what the data signifies or implies, information emerges once we make sense of the data. Information is contained e.g in {books} 
[internet |(internet md), in nature, and we access it through our senses. [Computers (computer.md) can be seen as machines for processing information and since the computer revo 
as become the focus of our society; we often encounter terms such as [information technology](it.md), informatics, information war, information age etc. [Information theory] 
(information_theory.md) is a [scientific field](science.md) studying information. 


're encrypted and 
(book. mays on the 
ution information 


**Information wants to be [free](free culture ma)", .e. it is free naturally unless we decide to limit its spread with [shit] (shit .md) like, [intellectual Doperty] (intellectual preperty.mdp 
laws. What does "free" mean? It is the miraculous property of information that allows us to duplicate it basically without any cost. OnCe we have certain information, we may share it with others 
without having to give up our own knowledge of the information. A file on a computer can be copied to another computer without deleting the file on the original computer. This is unlike with 
physical products which if we give to someone, we lose them ourselves. Imagine if you could make a piece of bread and then dup cate it infinitely for the whole world -- information works like 
this! We see it as a crime to want to restrict such a miracle. We may also very nicely store information in our heads. For all this information is [beautiful](beauty.md). It is sometimes 
discussed whether information is created or discovered -- if a mathematician comes up with an equation, is it his creation or simply his discovery of something that belongs to the nature and 
that has always been there? This question isn't so important because whatever terms we use, we at [LRS](1rs.md) decide to create, spread and freely share information without limiting it in any 
way, i.e. neither discovery nor invention should give rise to any kind of [property](property.md). 


In [computer science](compsci.md) the basic unit of information amount is 1 **[bit (bit smd ** (for *binary digit*), also known as [shannon] (shannon md) - .It represents .a, choice of two possible 
options, for example àn ahswer tó a *yes/no* question (with each answer being équally likely), or one of two fbinaty] (binary maj digits: 0 or 1. From this we derive higher units such as [bytes] 
(byte.md) (8 bits), [kilobytes](memory_units.md) (1000 bytes) etc. Other units of information include [nat](nat.md) or [hart](hart.md). With enough bits we can encode any information including 
text, sounds and images. For this we invent various [formats](file_format.md) and encodings with different properties: some encodings may for example contain [redundanc Y (redundancy md) to 
ensure the encoded information is preserved even if the data is partially lost. Some encodings may try to hide the contained information (see [encryption](encryption.md), [obfuscation] 
(obfuscation.md), [steganography](steganography.md)). For processing information we create [algorithms](algorithm.md) which we usually execute with computers] computer md . We may store 
information (contained in data) in physical media such as Ebooks} (book md). computer [memory](memory.m or computer storage media such as [CDs](cd.md), or even with traditional potentially 
[analog](analog.md) media such as photographs. 


Keep in mind that the **amount of hysical ly present bits doesn't have to equal the amount of information** because, as mentioned above, data that takes *N* bits may e.g. utilize redundancy and 
so store less information that would theoretically be possible with *N* bits. It may happen that the stored bits are [correlated](correlation.md) for any reason or different binary values Convey 
the same information (e.g. in some number encodings there are two values for number zero: positive and negative). All this means that the amount of information we receive in *N* bit data may be 
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lower (but never higher) than.*N* bits, i.e. if we HIP store a.file on.a 1 GB flash drive, the actual theoretical information, contained may be lower -- the exact, size of such theoretical 
information depends'on probabilities of what can really appear in the file and MAY CHANGE with the knowledge we posses, i.e. the amount of information stored on the flash drive may change by 
simply us coming to know that the file stored on the drive is a movie about cats which rules out many combinations of bits that can be stored there, Imagine a simplified case when there is file 
which says whether there exists infinitely many [prime numbers](prime.md) -- to a mathematician who already knows the answer the file gives zero information, while to someone who doesn't know 
the answer the file provides 1 bit of information. However in practice we often make the simplification of equating the amount of physically present bits to the contained "information". 


Information is related to **information [entropy (entropy md) ** (also Shannon entropy, similar to but distinct from the concept of thermodynamic entropy in physics): they're both measured in 
same units (usually [bits](bit.md)) but entropy measures a kind of "uncertainty" or average information received from a certain event when we know its probability distribution -- in a sense 
information and entropy can be seen as opposites: before we receive information we lack the information but there exists entropy, once we receive the information there is information but no 
entropy. 


In signal theory information is also often used as a synonym for nAsignal] (signal md) 7^, however a distinction can be made: signal is the [funetion](funetion-md) that carries information. Here 
we also encounter the term **[noise](noise.md)** which means an unwántéd signal mixed in with the desired signal which may make it harder to extract the information carried by the signal, or 
even obscure some or all of the information so that it can't be retrieved. 


According to the [theory of rẹlativity (retatiyity md) **information can never travel [faster than Light ] (speed of_light.md)** -- even if some things may move faster than light, such as a 
shadow, So called "Spooky action at a distance" (usually associated with quantum [entanglement ](entanglemen md) or even matter due to the expansion of space phy. QUE best knowledge we can never 
use this to transfer information faster than light. For this it seems our communication technology will always be burdened by [lag](lag.md), no matter how sophis icated. 

-- intellectual_property.md T 
ntellectual Property" 


# 


"Intellectual property" (IP, not to be confused with [IP address] (ip_address .md) ) is_a toxic [capitalist](capitalism md) idea that says that people should be able to own [information 
(information.md) (such as ideas, presentation style, Songs or tex ) and that it Should be treated in ways very similar to physical roperty. For example [patents](patent.md) are one ype of 
intellectual property which allow an inventor of some idea to *own* that idea and be able to limit its use and charge money to people using that idea, or prevent people from using that idea 
altogether. [Copyrig tJ egpyright md) is probably the most harmful of IP today, and along with patents the most relevant one in the area of technology. However, IP encompasses many other 
subtypes of this | and of "property" such as [trademarks](trademark.md), trade dress, plant varieties etc. IP is an arbitrarily invented grant of monopoly on information, i.e. something that is 
otherwise naturally free. 


Most people with brain oppose this idea, see e.g. http://harmful.cat-v.org/economics/intellectual_property/. 


IP exists to benefit [egrporations (corporation md), it artificially limits the natural (freedom of joformation) (information freedom md) (see fartifigial scarcity] (artificial scarcity md) and 
tries to eliminate fréedom and competition, it fuels consumerism (for example a company can force deletion of o version of its program in order to force users buy the new version), it helps 
keep malicious features in programs (by forbidding any study and modifications) and forces reinventing wheels which is extremely energy and resource wasting. Without IP, everyone would be able 
to study, share, improve and remix and combine existing technology and art. 


Many people protest against the idea of IP -- either wanting to abandon the idea completely as [we](lrs,md) do, or at least arguing for great relaxation_the insanely strict and aggressive forms 
that destroy our sociéty. Movements such as [free Software] (free software. md) and [free cuiture](free_cuiture.md) have come into existencé in protest of IP laws. Of Course, capitalists don't 
ive a shit. It can be expected the IP [cancer](cancer.md) will be reaching even more extreme forms very soon, for example it will be perpetual and encompassing such things as mere though 
thoughts will be monitored and people will be charged for thinking about ideas owned by corporations). 


It must be noted that as of 2020 **it is not, possible. to avoid the IP shenanigans**, Even though we can eliminate most of the harmful stuff (for now) with [licenses] (License md and. waivers] 
(waiver.md), there are many things that may be impossible to address or posing considerable dangers, e.g. trademark, personal rights or patent troll’attacks. In somè countries (US) it is illégal 
to make free programs that try to circumvent [DRM](drm.md). Some countries make it explicitly impossible to e.g. waive Copyright. It is impossible to safely check whether your creation violates 
on someone else's IP. There exists [shit](shit.md) such as [moral rights](moral rights.md) tha 

T interesting.md ---------- 

& Interesting 


t may exist even if copyright doesn't apply. 


This is a great answer to anything, if someone tells you something you don't understand or something you think is [shit](shit.md) and you don't know what to say, you just say "interesting". 


**All [natural numbers] (natural number md) are interesting**: there is a [fun] (fyn md) ferect) {proof md) by contradiction of this. Suppose there exists a set of uninteresting numbers which is a 
Subset of natural numbers; then the smallest of these numbers is interesting by being the smallest uninteresting number -- we've arrived at contradiction, therefore a set of uninteresting 
numbers cannot exist. 


TODO: just list some interesting shit here 
T internet.md ---------- 
# Internet 


Internet is the grand, [decentralized] (decentralization md] global network of interconnected [Computer] (computer .md) [networks] (network. md) that allows advanced, cheap, practical l instantaneous 
intercommunicatión of people and computers and sharing of large amounts of data and information. Over just a few decades since its birth in 1970s it changed the socie remendously, shifted it 
to the information age and stands as possibly the greatest technological invention of our society. It is a platform for many services and applications such as the [web (www. md) [e-mail] 
(email.md), [interner of things] (iot md) [torrents] (torrent ma), phone calls, video streaming, multiplayer [games] (game md) etc. Of course, once Internet became accessible to normal people and 
has become the largest public forum on he planet, it has also become the biggest dump of retàrds in history. 


Internet is built on top of [protocols] (protocol. md); (such as [elo m, [HTTP](http.md) or [SMTP L(pmtp mdp) standards, organizations, (such as [ICANN] (3cann mn TANA] (tana md) or [W3C] . 
(w3c.md)) and infrastructure (undersea cables, satellites, [routers f rou ers.md), x) that all together work to create a great network based on **[packet switching](packet_switching.md)**, i.e. 
a method of transferring digital data by breaking them down into small [packets](packet.md) which independently travel to their destination (contrast this to [circuit switching] 

(circuit switching.md) ) . The key feature of the Internet is its **[decentralization](decentralization.md)**, i.e. the attribute of having no central node or authority so that it cannot easily be 
estroyed or taken control over -- this is by design, the Internet evolved from DARE ONE T (arpanet md, a project of the US defense department. Nevertheless there are parties constantly trying to 
seize at least partial control of the Internet such as governments (e.g. China and its [Great Firewa t] (great_firewall.md), [EU] Ceu md) with its "anti-pedophile" chat monitoring laws etc.) and 
corporations (by creating centralized services such as Social networks](social network.md)). Some are warning of possible dé-globalization of the Internet that some parties are trying to carry 
out, which would turn the Internet into so called [splinternet](splinternet.md). 


Access to the Internet is offered by fEsPs] (isp md) (internet service providers) but it's pretty easy to.connect to the Internet even for free, e.g. via free wifis](wifi.md) in public places, 
or in libraries. By 2020 more than half of world's’ population had access to the Internet -- most people in the first world have practically constant, unlimited access to it via their 
[smartphones |(smart phone nd), and even in [poor countries](shithole.md) [capitalism](capitalism.md) makes these devices along with Internet access cheap as people constantly carrying around 
evices that display [ads](ad.md) and spy on them is what allows their easy exploitation. 


The following are some stats about the Internet as of 2022: there are over 5 billion users world-wide {nore than half of them from Asia and mostly young people) and over 50 billion individual 
devices connected, about 2 billion websites (over 60% in [english] english md) ) on the web, hundreds of billions of emails are sent every day, average Connection speed is 24 Mbps, there are over 
370 million registered [domain](domain.md) names (most popular [TLD](tld.md) 1s .com), [Google](google.com) performs about 7 billion web searches daily (over 90% of all search engines). 


## History 
*see also [history](history.md)* 
TODO (see https://www.zakon.org/robert/internet/timeline/) 
## See Also 
JWICS](jwics.md), [SIPRNet](siprnet.md), [NIPRNet](niprnet.md) (secret/military networks) 


Smol Internet](smol internet.md) 
World Wide wel Www .md) 


Interplanetary Internet is at this time still a hypothetical, extension, of the [internet] (internet .md) to multiple planets. As mankind is getting closer to starting living on,other planets and 
bodies such aS [Mars](mars.md) and [Moon4 (oon mdf we have to start thinking about the challenges of creating a communication network between all of them. The gréatest Challenge is posed by the 
vast distances that increase the communication delay (which arises due to the limited [speed of li ht] (Speed of. Light md) ) and make errors such as [Packet toss] 

painful: Two-way communication (i.e. request-response) to Moon and Mars can take even seconds and 40 minutes respectively. Also things like planet motions, ec 

solve. 


packet_loss.md) much more 
ipses etc. pose problems to 


We can see that ead: [real time] (real time.md) [Earth (earth.md)-Mars, communication igi [chat] (chat md) or videocalts) are physically impossible, so not only do we have to create new [network] 
network.md) rotóco SI (protoc .md) that minimize thé there-and-back communication (t ings such as _ [handshakes](handshakes.md) are out of question) and implement great [redundancy | 
redundancy.md) for reliable recovery from loss of data traveling through space, we also need to design **new [user interfaces](ui.md)** and communication paradigms, i.e. we probably need to 

create a new messaging software for “interplanetary chat" that will for example show the earliest time at which the sender can expect an answer etc. [Interesting](interesting.md) shit to think 

about. 


{ TFW no [Xonotic](xonotic.md) deathmatches with our Moon friends :( ~drummyfish } 


For things like [web] (web md), each planet would likely want to have its own "subweb" (distin uished e.g. by |l TEpS] (E12 md?) and [caches](cache.md) of other planets' webs for quick access. This 
is E: man on Mars wouldn't have to wait 40 minutes for downloading a webpage from the Earh web but could immediately acces$ that webpage'S slightly delayed version, which is of course much 
etter. 


Research into this has already been ongoing for some time. InterPlaNet is a protocol developed by [NASA](nasa.md) and others to be the basis for interplanetary Internet. 
## See Also 


- [world broadcast ](world_broadcast.md) 
lI interpolation.md ---------- 
& Interpolation 


Interpolation (*inter* - between, *polio*- polish) means computing (usually a gradual) transition between some specified values, i.e. creating additional intermediate points between some already 
existing points. For example if we want to change a screen [pixel] (pixet, din) from one color to another in a gradual manner, we use some interpolation method to compute a number of intermediate 
colors which we then display in rapid succession; we say we interpolate between the two colors. Interpolation is a very basic [mathematical](math.md) tool that's commonly encountered almost 
everywhere, not just in [programming](programming.md): some uses include drawing a graph between measured data points, estimating function values in unknown regions, creating smooth [animations] 
(animation.md), drawing [vector](vector_graphics.md) curves, [digital] (digital md) to [analog] (anato .md) conversion enlarging pictures, blending transition in videos and so on. Interpolation 
can be used to generalize, e.g. if we have a mathematical [function](Tunction.md) that's only defined for [whole num ers] (wl go te_number md) (such as [factorial](factorial md) or [Fibonacci 
Sequence] (Fibonacci md) ), we may use interpolation to extend that function to all [real numbers](real number.md). Interpolation can also be used as à method o Lapproximation][approximation:md) 
(consider e.g. a game that runs at 60 FPS to look smooth but internally only computes its physics at 30 FPS and interpolates every other frame so as to increase performance). All in all 
interpolation is one of the most important things to learn. 


The opposite of interpolation is "elextrapolation](extrai olation,md)**, an operation that's extending? creating points OUTSIDE given interval (while interpolation creates points INSIDE the 
interval). Both interpolation and extrapolation are similar to **[regression](regression.md)** which tries to find a [function](fünction.md) of Specified form that best fits given data (unlike 
interpolation it usually isn't required to hit the data points exactly but rather e.g. minimize some kind of distance to these points). 


There are many methods of interpolation which differ in aspects such as complexity, number of dimensions, type and properties of the mathematical curve/surface (Tpolynomial (polynomial.md) 
degree, continuity/smoothness of [derivatives](derivative.md), ...) or number of points required for the computation (Some methods require knowledge of more than two points 


. nearest linear cosine cubic 


*A few common 1D interpolation methods.* 


The base case of interpolation takes place in one dimension (imagine eig. interpolating sound volume, a single pymber parameter), Here interpolation can be seen as a [function](function.md) that 
takes as its parameters the two values to interpolate between, *A* an *B*, and an **interpolation parameter** *t*, which takes the value from © to 1 -- this parameter says the’ percentage : 
position between the two values, i.e. for *t = 0* the function returns *A*, for *t = 1* it returns *B* and for other values of *t* it returns some intermediate value (note that this value may in 
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certain cases be outside the *A*-*B* interval Sc: with cubic interpolatign). The function can optionally take additional parameters, e.g. cubic interpolation requires to also specify [slopes] 
(slope.md) at the points *A* and *B*. So the function signature in [C](c.md) may look e.g. as 


float interpolate(float a, float b, float t); 


Many times we apply our interpolation not just to two points but to many points, by segments, i.e. we app ly the interpolation between each two neighboring points (a segment) in a series of many 
points to create a longer curve through all the points. Here we are usually interested in how the segments transition into each other, i.e. what the whole curve looks like at the locations of 
e points. 


**[Nearest neighbor](nearest neighbor.md)*" is probably the simplest interpolation (so simple that it's sometimes not even called an interpolation, even. though it technically is). This method 
simply returns the Closest value, i.e. either *A* (for *t* < 0.5) or *B* (otherwise). This creates kind of sharp steps between the points, the function is not continuous, i.e. the transition 
between the points is not graduat but simply jumps from one value to the other at one point. 


**[Linear interpolation] (lerp.md)** (se called ler is probably the second simplest interpolation. which steps from the first, point towards the second in a con 
line between them. This is simplé an [good enough} 
points, the curve may look like a "saw". 


, t S stant step, creating a straight 
good enough.md) for many things, the function is continuous but not smooth, i.e. there are no "jumps" but there may be "sharp turns" at the 


smog panel (cos md) interpolation** uses part of the [£ogine] (cos md) function to create a continuous and smooth line between the points. The advantage, over linear interpolation is the 
smoothness, i.e. there aren't "sharp turns" at the points, just as with the more advanced cubic interpolation against which cosine interpolation has the advantage of still requiring only the two 
interval points (*A* and *B*), however for the price of a disadvantage of always having the same horizontal slope at each point which may look weird in some situations (e.g. multiple points 
lying on the same sloped line will result in a curve that looks like smooth steps). 


**[Cubic](cubic.md) interpolation** can be considered a bit more advanced, it uses a [polynomial] (polynomial: md) of degree 3 and creates a nice smooth curve through multiple points but requires 
knowledge of one additional point on each side of the interpolated interval (this may create slight issues with the first and last point of the sequence of values). This is so as to know at what 
slope to approach an endpoint so as to continue in the direction of the point behind it. 


The above mentioned methods can be generalized to more dimensions (the number of dimensions are equal to the number of interpolation parameters) -- we encounter this a lot e.g. in, [computer 

graphics] (graphics md) when upscaling [textures] texture: md) (sometimes called texture faltering) . 2D nearest neighbor interpolation creates "blocky" images in which [paxets|(pixer.md) simply 
ge bigger" but stay sharp squares if we upscale the texture. Linear interpolation in 2D is called [bilinear interpolation](bilinear.md) and is visually much better an nearest neighbor, 
[bicubic interpolation](bicubic.md) is a generalization of cubic interpolation to 2D and is yet smoother that bilinear interpolation. 


## See Also 


- [extrapolation] (extrapolation.md) 


The International Obfuscated C Code Contest (IOCCC for short) is an annual online contest in making the most creatively [obfuscated](obfuscation.md) programs in [C](c.md). It's kind of a "just 
for [fun](fun.md)" thing but similarly to [esoteric tanguages | (eso lang md) there's an element of art and clever hacking that carries a great value. While the [productivi Y freaks] 

(productivity cult.md) will argue this is just a waste of time, the true programmer appreciates the depth of knowledge and creative thinking needed to develop a beautifully obfuscated program. 
The contest runs since 1984 and was started by Landon Curt Noli and Larry Bassel. 


Unfortunately some [shit](shit.md) is flying around IOCCC too, for example confusing Licensing -- having a [cc-By-SA (cc_by_sa.md)_ license in website footer and explicitly prohibiting çommercial 
use in the text, WTF? Al$ó the team started to use [Microshit](microsoft.md)'s [GitHub](github.md). They also allow latest [capitalist ](capitalist_software.md) C standards, but hey, this is à 
contest focused on ugly C, so perhaps it makes sense. 


Hacking the rules of the contest is also encouraged and there is an extra award for "worst abuse of the rules". 
Some common ideas employed in the programs include: 


formatting source code as [ASCII art](ascii_art.md) 

misleading identifiers and comments 

extreme [macro](macro.md)/[preprocessor](preprocessor.md) abuse 

abuse of compiler flags 

different behavior under different C standards 

doing simple things the hard way, e.g. by avoiding loops 

including weird files like '/dev/tty' or recursively including itself 

[code golfing](code golf.md) A : . x . h 

weird stuff like the main fünction [recursion](recursion.md) or even using it as a signal handler :) 


And let us also mention a few winning entries: 


- program whose source code is taken from its file name (using ^ FILE ^) 
- fray tracer](ray_tracing.md) in < 30 LOC formatted as ASCII art 

- Operating system with multi-tasking, GUI and filesystem support 

- neural [machine learning](machine learning.md) on text in < 4KB 

- program printing "hello world" with error messages during compilation 

- [X11](x11.md) Minecraft-like game 

- [web browser](web browser .md) 

- Self-replicating programs 

l1 island.md ---------- 

# Welcome to the Island! 


This is the freedom island where we live! Feel free to build your house on any free spot. Planting trees and making landscape works are allowed too. 
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D: drummyfish's house 
T: The Temple, it has nice view of the sea and we go meditate here, it's a nice walk. 


---------- _jargon_file.md T 
# Jargon File 


Jargon File (also Hacker's Dictionary) is a computer [hacker ] hacking md) dict ionary/com endium that's been written and updated by a number of prominent hackers, such as [Richard Stallman] 
(rms.md) and [Erik S Raymond] (esr md? since 1970. It is a greatly important part of hacker culture and has also partly inspired this very wiki. 


It.informally states that it's in, the [public domain](pd.md) and, some people have successfully published it commercially, however there is no standard waiver] {waiver md) or license] : 
(license.md) -- maybe because such waivers didn't really exist at the time it was started -- and so we have to suppose it is NOT formally [free as in freedom](tree_cuiture.md). Nevertheless it 
is freely accessible e.g. at [Project Gutenberg](gutenberg.md) and no one will bother you if you share it around... we just wouldn't recommend treating it as true public domain. 


It is pretty nicely written with great amount of humor and good old political incorrectness, you can e.g. find the definition of terms such as *[rape](rape.md)* and *clit mouse*. Some other nice 
terms include *notwork* (non-functioning [network] (network md)), [Internet Exploiter](internet explorer.md), *binary four* (giving a finger in binary) or *Maggotbox* ([Macintosh](mac.md)). At 
the beginning the book gives some theory about how the hacker terms are formed (overgeneralization, comparátives etc.). 


l0 java.md ---------- 
*Unfortunately 3 billion devices run Java.* 


[bytecode](bytecode.md) and thérefore " form independent atform_independence.md)" (as long e platform has a of resources to wasté on running Java [virtual machine](vm.md) 
of the features of Java include [bloat](bloat.md), slow loading, slow running, [supporting capitalism](capitalist software.md), forced and unavoidable [object obsession](oop.md) and the 


Java (not to be confused with, [JavaScri| t1 g;mD) is a highl [bloated] (bloat md), inefficient, "[Pre rammin language] (programming language md)" that's.sadly kind.of popular, It is compiled to 
fp a Tp S st ot n Some 
necessity to create a billion of files to write even a simple program. 


Avoid this [shit](shit.md). 


( I've met retarde-whio seriously think Java is more portable than [C](c.md) lol. I wanna [suicide](suicide.md) myself. ~drummyfish } 
Il javascript.md ---------- 
& JavaScript 


JavaScript (not to be confused with completely unrelated [Java](java.md) language) is a [bloated](bloat.md) [programming language](programming language.md) used mainly on the [web] (www.md). 
n john carmack.md ---------- 
# John Carmack 


(game.md) as [Doom] doom- nid). 
à 


John Carmack is a brilliant sie programmer that's contributed mostly to [computer aap ts (graphice nd) and stands behind $egist E such Laane? en n ni i ithm) 
msj] (algorithm. m e.g. the reverse shadow volume algorithm). 


Wolfenstein](wolf3D.md) and uake](quake.md). He helped pioneer real-time 3D graphics, created màny [hacks](hack.md) and [algorit 
e is also a rocket [engineer[(engineer.md). 


*[ASCII art](ascii art.md) of John Carmack* 


He's kind of the ridiculously Stereotypical nerd] (perd.md) with glasses that just from the way he talks gives out the impression of someone with high functioning [autism](autism.md). You can 
just sense his [1Q](iq.md) iS over 9000. Some nic [Shit] ehit maj about him can be read in the (sadly [proprietary](proprietary.md)) book *Masters ðf Doom*. 


new games Freedoom] 


Carmack is a proponent of $eessdt fess and) and has released his old game engines as such.which gave rise to an enormous amount of modifications, forked engines and even (e.g. [ 
In 2021 Carmáck tweeted that he would have rather 


qireedoemema) and [Xonotic](xonótic.md)). He's probably leaning morë towards the dark side of the source: the [open-source](open source.md) 
icensed his old Id engines under a permissive BSD [license](license.md) than the [GPL](gpl.md), which is good. 
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In 2013 he sadly sold his soul to [Facebook](facebook.md) to work on [VR](vr.md) (in a Facebook owned company Oculus). 


T jokes.md ---------- 
# Jokes 


Here you can shitpost your jokes that are somehow related to this wiki's topic. Just watch out for [copyright](copyright.md) (no copy-pasting jokes from other sites)! 
Please do NOT post lame "big-bang-theory"/[9gag](9gag.md) jokes like *sudo make sandwich* or *there are 10 types of people*. 


{ Many, of the jokes are original, some are shamelessly pulled from other sites and reworded, I don't believe [copyright | (copyright .md) can apply if the expression of a joke is different, ideas 
Can't be copyrighted. Also the exact origins of jokes are difficult to track so it's probably a kind of folklore. -drummyfish } 


- Lett] (cpp ma) 
- What's the worst kind of [lag](lag.md)? Gulag. 
- Ingame chat: "What's the country in the middle of north Africa?" VWSONNED) ] (niger .md) 
- What sound does an angry [e| Cer md) programmer make? ARGCCCC ARGVVVVVVVV 
- I have a mentally ill friend who tried to design the worst operating system] (os md on purpose. It boots for at least 10 minutes, then it changes the user's desktop background to random ads 
and it randomly crashes to make the user angry. He recently told me he is getting sued by PMiErosort] (microsoft. md) for violating their look and feel. 
- Do you use [Emags] (emacs .md)? No, I already have an [operating system](os.md). 
- "alias bitch=sudo 
- a joke for minimalists: 
- Political activists walk into a bar. [fseudolettist ](pseudolert) tells his friends: "hey guys, how about we have oppressive rulers and call them a [government] (goyernment md)?" Capitalist 
says: "well no, let's have oppressive rulers and call them [corpofations](corporation.md)". [Liberal](liberal.md) replies: "Why not both?". Monarchist goes: "no; it's all wrong, let's have 
oppressive rulers and call them Kings." To this pseudo communist says: "that's just shit, let's have oppressive rulers and call them the [proletariat](proletariat.md)". Then [anarcho pacifist] 
(anpac.md) turns to them and says: "Hmmm, how about we don't have any oppressive rulers?". They lynch him. 
- There are a lot of pokes at https://jcdverha.home.xs4all.nl/scijokes/. 
- Does the invisible hand exist in the [free market](free market.md)? Maybe, but if so then all it's doing is masturbating. 
- 9096 of statistics are fake. 
- When will they remove the *[touch](touch.md)* and MN commands from [unix] (unix.md)? Probably when they rename *[man pages](man page.md)* to *person pages*. 
- If; (law) (Law, md) was viewed as a programming code, it, would be historically the worst case of l^ ated] (bloat md). [s aghetti code](spaghetti_code.md) littered with [magic constants] 
(magic constant.md), undefined symbols and dead code, which is additionally deployed silently and without any [testi 8 esting.md). Yet it's the most' important algorithm of our sociéty. 
- At the beginning there was [machine code](machine code.md). Then they added [assembly (assembly, md) on top of it to make it more comfortable. To make programs portable they created an 
[operating System] os, nd and a layer of Feyscatts|{syscay tema) Except it didn't work because other people made other operating systems with different syscalls. So to try to make it portable 
again they created a high-level language compiler](compiler.md) on top of it. To make it yet more comfortable they created yet a higher level language and made a [transpiler](transpiler.md) to 
the lower level Language, To make building more platform independent and comfortable they created [makefiles](makefile.md) on top of it. However, more jobs were needed so they created [CMake] 
(cmake.md) on top of makefiles, just in case. It seems like CMake nowadays seems too low level so à new layer will be needed above all the meta-meta-meta build systems. I wonder how high of a 
tower we can make, maybe they're just trying to get a Guinness world record for the greatest bullshit sandwich in history. 
- How to install a package on [Debian](debian.md)? I don't know, but on my [Arch](arch.md) it's done with "pacman'. 
Difference between a beginner and pro programmer? Pro programmer fails in a much more sophisticated manner. 
What's a [computer](computer.md)? A device that can make à hundred million mistakes per second. 
Cool statistics: 9 out of 10 people enjoy a gang frape] (rape. md). 
Boss: "We're going to need to store additional information about gender of all 1600 people in our database." Me: "OK that's only 200 extra bytes.". Diversity department: "You're fired." 
the [downto](downto.md) operator 


## See Also 
- [LMAO] (1lmao.md) 


---------- julia_set.md ---------- 
# Julia Set 


TODO 


Julia Set for -0.34 - 0.63i 


# Code 


The following code is a simple [C](c.md) program that renders given Julia set into terminal (for demonstrative purposes, it isn't efficient or do any [antialiasing](antialiasing.md)). 


#include <stdio.h> 

#define ROWS 30 

#define COLS 70 

#define SET_X -0.36 // Julia set parameter 
#define SET_Y -0.62 // Julia set parameter 
#define FROM_X -1.5 

#define FROM_Y 1.0 

#define STEP (3.0 / ((double) COLS)) 


pisagned int julia(double x, double y) 
double cx = x, cy = y, tmp; 
for (int i = 0; i < 1000; ++i) 
tmp = cx * cx - cy * cy + SET_X; 
cy = 2 * cx * cy + SET. Y; 
cx = tmp; 
if (cx * cx * cy * cy > 10000000000) 
return 0; 
return 1; 
H 
int main(void) 
double cx, cy - FROM Y; 
for (int y = 0; y < ROWS; **y) 
CX = FROM X; 
for (int x 0; x < COLS; ^x) 


unsigned int point - . 
julia(cx,cy) + (julia(cx,cy + STEP) * 2); 


putchar(point ==,3,? Ai^. eont == 27 '\''! 


(point == 1 ? $ 


cx += STEP; 


putchar('\n'); 


} cy -= 2 * STEP; 


return 0; 


T1 just werks.md ---------- 
# Just Werks 


"Just werks" (for "just works" if that's somehow not clear) is a phrase used by [noobs](n 
t think ther d 


md) to justify using a, piece of technology while completely neglecting any other deeper and/or long 
term consequences. noob doesn' about technology für han how it can imme a: him. 


(noob. 

lately perform some sk for 
This phrase is widely used on [4chan](4chan.md)/g, it probably originated there. 

The "just werks" philosophy completely ignores questions such as: 


**Is there anything better_in the long run?** A normie will always prefer a shitty software he can immediately use to a software that would take one day to learn and that would make the task 
many times easier, comfortable, cheaper etc. 


- **Is this affecting my freedom?** A normie doesn't realize that by using proprietary or bloated program will limit the number of people who can maintain, fix and improve his software. 
**Is this affecting my security?** Of course noobs are completely oblivious to the fact that certain types of technology are just plain spyware. 
- **How is this affecting my computing in a wider sense?** A normie won't even think about such thing as that using some proprietary format will likely immediately close the door to working with 


215 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


it with a FOSS program, or that installing a specific OS will limit what programs he can run. . 
- **Am I becoming à slave to this technology?** By adopting something proprietary and/or bloated I am slowly becoming dependent on an ecosystem that's completely under control of some 
corporation, an ecosystem that can quickly Change for the worse or even disappear completely. 
- **Am I supporting evil?** E.g. by paying to a corporation, letting someone collect data in the background, promoting a bad piece of technology etc. 

**Am I hurting better alternatives by not using them?** E.g. by using a proprietary social network giyes one more user to it and one fewer to a potentially more ethical free social network. 
ü IP there anything just plain better?** A normie will take the first thing that's handed to him and "just werks" without even checking if something better exists that would satisfy him 
etter. 


## See Also 


- [everyone does it](everyone does it.md) 
just doing my job](just doing my job.md) 


Kek means prot tot md): It comes from [World of Warcraft] (wow mg where the two opposing factions (Horde and Alliance) were made to speak mutually unintelligibile languages so as to prevent 
enemy playérs from communicating; when someone from Horde yped "lol", an Alliance player would see him say "kek". The’ other way around (i.e. Alliance Speaking to Hordé) would render "lol" as 
"bur", however kek became the popular one. On the Internet this further mutated to forms like *kik*, *kekw*, *topkek* etc. Nowadays in some places such as [4chan](4chan.md) kek seems to be used 
even more than lol, it's the newer, "cooler" way of saying lol. 


## See Also 


meme (meno md) 
-- kids these days.md --- 


" Kids These Days 


KISS (Keep It Simple, Stupid!) is a design, philosophy, that favors, simplicity, solutions that are **as, simple as possible** to achieve given task. This philosophy doesn't primarily stem from 
lazinéss and a want to save time (though these are valid reasons too), but mainly from the fact that higher [complexity] (complexit vind} comes with increasingly negative effects such as the cost 
of development, cost of [maintenance }(maintenance md), greater probability of [bugs](bug.md) (e.g. [security](security.md) vulnerabilities) and failure, more la 


ependencies](dependency.md). This 
stance is related to technology [minimalism](minimalism.md). 


Apparently the term *KISS* originated in the US Army plane engineering: the planes needed to be repairable by *stupid* soldiers with limited tools under field conditions. 
**Examples** of KISS "[solutions](solution.md)" include: 


- Using a [plain text] (plain text md) TODO.txt file instead of a dedicated [bug] (bug md) tracker. 

- Creating website in plain [HTML](html.md) instead of using some complex web framework such as [Wordpress](wordpress.md). 

- Implementing a web left-right sweeping image gallery with HTML [iframe](iframe.md) instead of some overcomplicated [JavaScript](js.md) library. { Example stolen from [reactionary software] 
(reactionary_Software.md) website. -drummyfish 3 

- Using a trivial [shell](shell.md) script for compiling your programs rather than a complex build system such as [CMake](cmake.md). 


Compared to [suckless] (sucklessmd), [unix philosophy] (unix philosophy md) and [LRS](lrs.md), KISS is a more generat term and isn't tied to any specific group or movement, it doesn't imply any 
specifics but rather the general overall idea of simplicity being an advantage ([less is mofe](less is more.md), [worse is better](worse is better.md), ...). 


[KISS Linux](kiss linux.md) is an example of software developed under this philosophy and adapting the term itself. 
## See Also 


minimalism] (minimalism.md) 

guck less | (Suck Less md) 

KILL] (kill.md) 

LRS](lrs.md) 

ELIIEDLES kwangmyong.md ---------- 
# Kwangmyong 


Kwangm ong {meaning “bright light*) is a mysterious [intranet ] (intranet md) that North Koreans basically have instead of the [Internet](internet.md). For its high political isolation North Korea 
doesn't allow its Citizens open access to the Internet, they rather create their own internal network the government can fully control -- this is unsurprising, allegedly it is e.g. illegal to 
own a fax and North Korea also have their own operating system called [Red Star OS](red star.md), for security reasons. Not so much is known about Kwangmyong for a number of reasons: it is only 
accessible from within North Korea, foreigners are typically not allowed to access it, and, of course, it isn't in English but in Korean. Of course the content on the network is highly filtered 
and/or created by the state propaganda. Foreigners sometimes get a chance to spot or even secretly photograph things that allow us to make out a bit of information about the network. 


North Koreans themselves almost never have their own computers, they typically browse the network in libraries. 


There seem to be a few thousand accessible sites. Raw pp addresses](ip_address.md) (in the private 40.0.0,0/8, range) are sometimes used to access, sites (posters in libraries list IPs of some 
sites) but [DNS](dns.md) is also up -- here sites use *.kp* [top level domain](tld:md). Some sites, e.g. of universiti are also accessible on the Internet (e.g. 

http://www. ryongnamsan-edu  kp/), others like http://www.ipo.aca.kp (patent/invention site) or http://www.ssl.edu.kp (sports site) are not. There seems to be a remote webcam education system in 
place -- it appeared on Nort orean news. There exists something akin a [search engine](search engine.md) (*Naenara*), [email](email.md), [usenet](usenet.md), even something like [facebook] 
(facebook.md). Apparently there are some [video games](game.md) às well. 


## See Also 


- [Red Start OS](red star.md) (North Korea operating system) 
l1 lambda calculus.md ---------- 
# Lambda Calculus 


Lambda calculus is an extremely simple and low-level [mathematical {math md) system that can describe computations with [functions] (fungtion md) .and can in fact be used to describe,and perform 
any computation. Lambda calculüs provides a theoreticál basis for unctionál programming fanguages | (func ional.md) and is a **[modél of computation] (model_of_computation.md)** similar to e.g. a 
[Turing machine](turing_machine.md) or [interaction nets](interaction_net.md) -- lambda calculus has actually exactly the same computational power as a Turing machine, which is the greatest 
possible computational power, and so it is an alternative to it. Lambda calculus can also be seen as a simple [programming lan uage] (programming Language md), however it is so extremely simple 
(there are e.g. no numbers) that its pure form isn't used for practical programming, it is more of a mathematical tool for studying computers theoretically, constructing proofs etc. Nevertheless 
anything that can be programmed in any classic programming language can in theory be also programmed in lambda calculus. 


While Turing machines use memory cells in which computations are performed -- which is similar to how real life computers work -- lambda calculus per forms computations only by simplifying an. 
expression made of pure mathematical functions, i.e. there are no [global variables](variable.md) or [side effects](side effect.md) (the concept of memory is basically present in the expression 
itself, the lambda expression is both a program and memory at the same time). It has to be stressed that the functions in question are mathematical functions, also called **pure functions**, NOT 
functions we know from programming (which can do all kinds of nasty stuff). A pure function cannot have any side effects such as changing global state and its result also cannot depend on any 
global state or randomness, the only thing a pure function can do is return a value, and this value has to always be the same if the arguments to the function are same. 


## How It Works 

(For simplicity we'll use pure ASCII text. Let the letters L, A and B signify the Greek letters lambda, alpha and beta.) 

Lambda calculus is extremely simple in its definition, but it may not be so simple to learn to understand it. Most students don't get it the first time, so don't worry :) 
In lambda calculus function have no names, they are what we'd call anonymous functions or lambdas in programming (now you know why they're called lambdas). 


Computations in lambda,calculus don't work with numbers but with sequences of, symbols, i.e, the, computation can_be imagined as Manipulating text strings with operations that can intuitively just 
be seen as "search/replace". If you know some programming language already, the notation of lambda calculus will seem familiar to functions you already know from programming (there are 
functions, their bodies, arguments, variables, ...), but BEWARE, this will also confuse you; functions in lambda calculus work a little different (much simpler) than those in traditional 
programming languages; e.g. you shouldn't imagine that variables and function arguments represent numbers -- they are really just "text symbols", all we're doing with lambda calculus is really 
manipulating text with very simple rules. Things like numbers, their addition etc. don't exist at the basic level of lambda calculus, they have to be implemented (see later). This is on purpose 
(feature, not a bug), lambda calculus is really trying to explore how simple we can make a system to still keep it as powerful as a Turing machine. 


In lambda calculus an expression, also a **lambda term** or "program" if you will, consists only of three types of [syntactical](syntax.md) constructs: 


1. *x*: **variables**, represent unknown values (of course we can use also other letters than just *x*). : 237 
2. *(Lx.T)*: **abstraction**, where *T* is a lambda term, signifies a function definition (*x* is a variable that's the function's parameter, *T* is its body). 
3. *(S T)*: **application** of *S* to *T*, where *S* and *T* are lambda terms, signifies a function call/invocation (*S* is the function, *T* is the argument 


For example *(La.(Lb.x)) x* is a lambda term while *xLx..y* is not. 
Brackets can be left out if there's no ambiguity. Furthermore we need to distinguish between two types of variables: 


**bound**: A variable whose name is the same as some parameter of a function this variable is in. E.g. in *(Lx.(Ly.xyz))* variables *x* and *y* are bound. 
- **free**: Variable that's not bound. 


Every lambda term can be broken down.into the above defined three constructs. The actual, computation is perf. 
p 


2 e k a S ctu C i by gimplity ng the term with special rules_until we get the result (similarly to 
how we simplify expression with special rules in [algebra](algebra.md)). This simplification is called a on**, an 


i 
i ; d there are only two rules for performing it: 


. **A-conversion**; Renames (substitutes) a bound variable inside a function, e.g. we can apply A-conversion to *Lx.xa* and convert it to *Ly.ya*. This is done in specific cases when we need to 
prevent a substitution from making a free variable into a bound one. 

. **B-reduction**: Takes a body of a function and replaces a parameter inside, this body with provided argument, i.e. this is used to reduce ‘applications? . For example *(Lx.xy),a* is an 
application (we apply o eg" to *a* ). when we apply B-reduction, we take the function body (*xy*) and' replace the bound variable (*x*) with the argument (*a*), so we get *ày* as the result 
of the whole B-reduction here. 


A function in, lambda calculus can only take one argument, The result of the function, its "return value", is a Strange it leaves behind after it's. been processed with the reduction rules, This 
TUR a gun) io^ can also return a fuhction (and a function can be an argument to another function), which allows us to implement functions of multiple variables with so called *[currying] 
currying.md)*. 


For example if we want to make.a function of two arguments, we instead create a function of one argument that will return another function of one argument. E.g. a function.we'd traditionally |. 
ME Nena = neun in lambda calculus be "written as *(Lx.(Ly.(Lz.xyz)))*, or, without brackets, *Lx.Ly.Lz.xyz* which will sometimes be written as *Lxyz.xyz* (this is just a [syntactic 
sugar](syntàctic sugar.md)). 


d to implement -any possible program**. For example we can encode 
e 4 


nee numbers with so called Church numerals: © is *Lf.Lx.x*, 1 is *Lf.Lx.fx*, 2 is *Lf.Lx.f(fx)*, 3 is 
etc. Then we can implement functions such as an increment: *Ln. Lx.f((nf)x)*, etc. 


Let's take a complete **example**. We'll use the above shown increment function to increment the number © so that we get a result 1: 


Ln.Lf.Lx.f((nf)x Lf.Lx.x) application 

Ln.Lf.Lx.f((nf)x LfO.Lx0.x0) A-conversion (rename variables) 
Lf.Lx.f(((LTO.LxO.x0)f)x) B-reduction (substitution) 
Lf.Lx.f((Lx0.x0)x) B-reduction 

Lf.Lx.fx B-reduction 
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We see we've gotten the representation of number 1. 
TODO: C code 
## See Also 


- [sigma calculus](sigma calculus .md) 
interaction calculus](interaction calculus.md) 

T2 langtons ant.md ---------- 

# Langton's Ant 


Langton's ant, is a simple perg player](zero player.md) game] (game md) and [cellular automaton](cellular automaton.md) simulating the behavior of an ant that behaves according to extremel 
simple rules but nevertheléss builds a very Complex structure. It is similar to [game of life](gàme of life.md). Langtón's ant is **[Turing complete](turing complete.md)** (it can be used to 
perform any computation that any other computer can). 


**Rules**: in the basic, version the ant is placed in a.squar grid where each square can be either white or black. Initially all, squares are white. The ant can face north, west, south or east 
and Operates an steps. In each step it does the following: if the square the ant is on is white (black), it turns the square to black (white), turns 90 degrees to the right (left) and moves one 
square forward. 


These simple.rules produce a quite complex structure, seen below. The interesting thing is that initially the ant behaves & Agog tically] (chaos md): but after about 10000 steps it suddenly ends 
up behaving in an ordered manner by building a "highway" that's a non-chaotic, répeating pattern. From then on it continues building the highway until the end of time. 


à eos LAM 
ee HH. HH. 
..  HHHHH OH. 
.H#.H#H.. HH 
He. 
. HHH. HHH HH HHL HH HHH.. 
HHHHH # HEHEHE... HLH. HHH. HH 


HH. Ht 
De HH. HHH.. HHH HH HHS HER LH 


H. HHHH. HH. ,HHHHHHHHH. H. HH. LIS M 
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oH, AH HHH. HHH.. HH... HHHH . HHHH.. 
HHH.. HHHH. H.H. HH. LI M 
HHHH HH. HH.. H . HHH HH.. 
wo HH HHH. OH HH HHH. HL HH. 
HHH AHHH HH HEH. LH 
ELEM M IE ME MEM MA 
.. H.H HH HHH HE 
TA IN . HHHH... 
HELM 
HHHH HH 
HHHH.. QGBÉL 
# "m EUH. HHHH. 
HH. HHH H.H.. 


*Langton's ant after 11100 steps, `A` signifies the ant's position, note the chaotic region from which the highway emerges left and up.* 

The Langton's ant game can be extended/modified, e.g. in following ways: 

- **multiple colors**: Squares can have more colors than just black/white that are cycled by the ant. Here we also need to specify which way the ant turns for each color it steps on, for example 
for 4 colors we may specify the rules as LRLL (turn left On 1st color, right on 2nd Color etc.). 

- **multiple ants**: called colonies 


‘different grid**: e.g. hexagonal or 3D 2 . : ; , a 
- **multiple ant states**: Besides having a direction the ant can have a more complex state. Such ants are called **[turmites](turmite.md)** (Turing termite). 


The ant was invented/discovered by [Christopher Langton](langton.md) in his 1986 paper called *Studying Artificial Life With Cellular Automata* where he calls the ants *vants* (virtual ants). 
## Implementation 
The following is a simple [C](c.md) implementation of Langton's ant including the extension to multiple colors (modify 'COLORS' and "RULES ). 


#include <stdio.h> 
#include <unistd.h> 


#define FIELD SIZE 48 

#define STEPS 5000 

#define COLORS 2 // number of colors 

#define RULES 0x01 // bit map of the rules, this one is RL 


unsigned char field[FIELD SIZE * FIELD SIZE]; 
struct 
3nt x. 
int y;. : ; 
char direction; // 0: up, 1: right, 2: down, 3: left 
} ant; 
int wrap(int x, int max) 


return (x < 9) ? (max - 1) : ((x >= max) ?0 : x); 


int main(void) 


ant.x FIELD SIZE / 2; 
ant.y = FIELD SIZE / 2; 
ant.direction - 0; 


for (unsigned int step = 0; step < STEPS; ++step) 


unsigned int fieldIndex = ant.y * FIELD SIZE + ant.x; 
unsigned char color - field[fieldIndex]; 


ant.direction = wrap(ant.direction + (((RULES >> color) & 0x01) ? 1 : -1),4); 
field[fieldIndex] = (color + 1) % COLORS; // change color 
// move forward: 


pie (ant.direction) 


case ant.y++; break; // up 
case ant.x++; break; // right 
case ant.y--; break; // down 


case 3: ant.X--; break; // left 
default: break; 


H 

ant.x - wrap(ant.x,FIELD SIZE); 
ant.y - wrap(ant.y,FIELD SIZE); 
// draw 


for (int i= 0; 


i 10; ++i) 
putchar('\n'J; 


for (int y = 0; y < FIELD_SIZE; ++y) 


for (int x = 0; x « FIELD SIZE; ++x) 
if (x == ant.x && y == ant.y 
putchar('A'); 
else 


{ 
unsigned char val = field[y * FIELD_SIZE + x]; 
} putchar(val ? ('A' + val - 1) : '.'); 


j putchar('\n'); 
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} us Leep(10000) ; 


return 0; 


## See Also 


game of life](game of life.md) 
turmite](turmite.md) 

rule 11 

cellular automaton](cellular automaton.md) 
T1 left.md ---------- 


# Left Vs Right (Vs Pseudoleft) 


Left and right are two basic opposing political sides that roughly come down to the pro-equality (left) and pro-hierarchy (right). There is a lot of confusion and vagueness about these terms, so 
let us now define them as used on this wiki: 


- The (true) **left is pro social eguality*, i.e. against social hierarchies, This includes equality of all living beings, period. Note that social equality does NOT imply.people being made (or 
being made to appear) equal in other ways, AR physically -- true left accepts difference between people and [racés](race.md) and doesn't hide them. Even if the pertect y idea Y leftist 
society can't be completely achieved, true left tries to get **as close to it as possible**. The values of true left are for example sharing, [love] (love md), _[se Plessness|(selt e: 
altruism](altruism.md), forgiveness and nonviolence. Groups and movements that are at least highly truly leftist include [anarcho pacirism](tahpar.m ), [vegànism](veganism.m 

free software.md), [free culture](free culture.md) and of course [LRS](lrs.md). 

- The **right is pro social hierarchy**, i.e. against social equality. This means some people standing above others, be it by strength, power, wealth, social status, privileges etc. The rightist 
values are mostly those associated with [evil](evil.md i.e. violence, oppression, conflict, war, revenge, survival of the fittest etc. Among rightism can be included [Fasctsm] (Facism.mdy 
(i.e. extreme rightism), [capitalism](capitalism.md), republican party, states, the military etc. One of right's identifying features is **hypocrisy**, i.e. it judges what's good/bad only by 
against whom it is targeted, e.g. violence is bad when targeted against "us" ("those Muslims are bad, they want to kill us!" ut good when targeted against "them" ("we have to kill those 
Muslims because they're violenti"); so animals killing humans is judged as "bad" but humans killing animals is "good". In other words right has no sense of morality, only the sense of [self 
interest](self interest.md). 

- The **pseudoleft** is pretending to be left while in fact being right due to e, 
as opposed to benefit of everyone). Among pseudoleftist movements arë [feminism] ( 
[naming](name_matters.md) of these movements. 


ssness.md), 
), [free software] 


fe using non-leftist means (such as violence) or even having non- leftist goals (8-9; benefit of specific minority 
eminism.md), [LGBT](lgbt.md), [Antifa](antifa.md) or [Marxism](marxism.md). This fact is also supported by the 


There_exists a "theory" called a horse shoe. It says that the extremes of the left-right spectrum tend to be alike (violent, hating, radical), just as the two ends of a horse shoe. This is only 
an illusion caused by ignoring the existence of pseudoleft. The following diagram shows the true situation: 


TRUE LEFT (peace, selflessness, forgiveness, ) 
ElScb rl Tea eM RSE 
/ 
<== illusion of horse shoe 
\ / 
V M 
. PSEUDOLEFT RIGHT um 
(violence, conflict, aggressivity, ...) 
We See, pseugoleft is something that began, as going away.from the right but slowly turned around back to its values, iust from a slightly different direction. This is because rightism is very 
easy, it offers tempting short-term solutions such as violence, and' so it exhort$ a kind of magnetic force on every human -- most cannot resist and only very few get to the trué left despite 


this force. 


qhe eur Denn jus centered culture unfortunately forces a **right-pseudoleft false dichotomy**. It is extremely important to realize this dichotomy doesn't hold. Do not become [type A/B fail] 
ail ab.md). 


What's called *left* in the [modern](modern.md) western culture usually means *pseudoleft*. The existence of pseudoleftism is often overlooked or unknown. It used to be found mainly in the [US] 
(us md), however globalization spreads this [cancer | (cancer md) all over the world. Pseudoleft justifies its actions with a goal that may seem truly leftist, such as "equality", but uses meàns 
completely unacceptable by true left (which are in Tact incompatible with equality), such as violence](violence.md), bullying, lynching, [cancer Lin ](cancel cuíture.md), [censorship] 
(censorship.md) or brainwashing. Pseudoleft is aggressive. It believes that **"ends justify the means" and that **"it's fine to bully a bully"** ("eye for an eye"). A pseudoleftist movement 
naturally evolves towards shifting its goals from a leftist one such as equality towards a [fascist](fascism.md) one such as a (blind) *fight for some group's rights* (even if that group may 
already have achieved equality an more} 


The difference between left and pseudoleft can be shown in many ways; one of them may be that pseudolert always wants to **[fight](fight culture.md)** Something, usually the right (as they're 
essentially the same, i.e. natural competitiors). True left wants to end all fights. Pseudoleft invents péu tisic bu Spi ema] artificial issues süch as [political Correctness] : 
(political correctness.md) that sparks conflict, as it lives by conflict. Left tries to find peace by solving problems. Pseudoleft sees it as acceptable to do bad things to people who commited 
Something it deems bad. True left knows that violence creates violence, it "turns the other cheek", it cures hate with love. 


Pseudoleft is extra harmful by deceiving the public into thinking what it does really is leftist. Most normal people that don't think too much therefore stand between a choice of a lesser of two 
evils: the right and pseudoleft. True left, the true good, is not known, it is overshadowed. 


Why is.there no pseudoright? Because it doesn't make sense :) Left is good, right is a sincere evil and pseudoleft is an evil pretending to be good. A good pretending to be evil doesn't probably 
exist in any significant’ form. 


**Centrism** means trying to stay somewhere mid way between left and right, but it comes with issues, From our point of, view it's like trying to stay in the middle of good and evil, it is 
definitely pretty bad to decide to be 50% evil. Another issue with centrism is that it is **unstable**. Centrism means balancing on the edge of two Opposing forces and people naturally tend to 
slip towards the extremes, so a young centrist will have about equal probabilities of slipping either towards extreme left or extreme right, and as society polarizes this way, people become yet 
more and more inclined to defend their team. Knowing centrism is unsustainable, we realize we basically have to choose which extreme to join, and we choose the left extreme, i.e. joining the 
good rather than the evil. 

T1 less retarded hardware.md ---------- 

# Less Retarded Hardware 


Less retarded hardware (LRH) iş an extension of ftess retarded software](lrs.md) (LRS) principles to hardware] (hardware smd ) design. Such hardware has to be non-consumerist, designed to_last_and 
fi oma. wi 


ree (as in freedom) hárdwáre](free hardware.md complete ly from the lówest leve e Ea completely [public domain](püblic ( in.md) without any legal limitations, made h [selfless] 
pelrlessness md) goals, aiming to be good [technology](technology.md) that helps all living eings withour;abusing them -- this implies the hardware has to be as simple as possible ([KISS] 
kiss.md), [suckless](suckless.md), ...) so as to maximize the number of people who can understand it, utilize it, improve it and repair it. 


l1 less retarded society.md ---------- 
# Less Retarded Society 


Less retarded society (LRS, same [acronym] (acy onym.md) as [less retarded software] lrs,md)).is a.model of ideal society towards which we, the [LRS](lrs.md), want.to be moving. Less retarded 
Society is a peaceful, collaborative soci " based on [lové](love.md) of all [lifé](life.md), which aims for maximum well being of all Sving eings, a society without violence, [money] 
(money.md), oppression, need for [work](work.md), social [competition](competition.md), poverty, scarcity, criminality, [censorship](censorship.md [self interest] (self interest md), 
overnment, police, laws, bullshit, slavery and many other negative phenomena. It e ually values all living beings and establishes true social equality in which everyone can pursue his true 
nisni y. The Soag works similarly to that described by the [Venus Project](venlis project .md) and various [anarchist](anarchism.md) theories (especially [anarcho pacifist] (anpac.md) 
communism] (communism.md) ). 


**How is this different from other ideologies and "life philosophies"?** Well, one principal difference is that LRS doesn't want.to [fight](fight culture.md); nowadays as well as in the past 
society has always been about conflict, playing a **game** against others (nowadays e.g. market competition, employment competition, media Competition, ...) in which some win, some can manage 
and some lose. Most political parties nowadays just want to change the rules of the game or downright Switch to a different kind of game, some want to make the rules "more fair", or to make it 
favor their represented minority (so called [fascism] (fascism.md)), some just want to [hack](hacking.md) the game, some want to [cheat](cheat.md) to win the game easily, some want to play fair 
but still win (i.e. become "successful"). LRS simply sees any kind of suc e 


game as unnécessary, cruel unethical and harmful in many ways not just to us, but to the who planet. LRS therefore 
simply wants to stop the game, not by force but by making everyone see how 


ad the game is. It says that **competition and conflict must seize to be the basis of society**. 


Note that this, society is an ideal model, i.e. it can probably_not be achieved 100% but it's. something that gives us a direction and to which we can Nom close** with enough effort. We 
create an ideal theoretical model and then try to [approximate |(approxumation. md) it in reality, which is a [scientific] (science.md) approach that is utilized almost everywhere: for example 
[mathematics](math.md) defines a perfect sphere and such a model is then useful in practice even if we cannot ever create a mathematically perfect sphere in the real physical world -- the 
mathematical equations of a sphere guide us so that with IST effort we are able to create physical spheres that are pretty close to an ideal sphere. The same can be done with society. This 
largely refutes the often given argument that *"it's impossible to achieve so we shouldn't try at all"* -- we should try our best and the closer to the ideal we get, the better for us. 


## Basis: Love Of All Life 


When thinking about how to change society for the better, the first thing that needs to be done is defining a goal which the society should aim for -- an [axiom] (axiom.md) which serves as a 
measure of whet E objectively 18904] (good md) and [bad] (bad.md), which if turn helps us take the right steps towards the good. This is only logical, without a goal we aren't really trying to 
achieve anything and "good" an 


"evi are just words without any objective meaning. 


The basis of less retarded society is a **universal and unconditional [love (Love. md) of all life**; the kind of love a glimpse of which.you.catch when you for example observe.an animal play and 
be happy of just existing as a living being that's able to feel joy and happiness. is kind of love and the strong emotion associated with it is to us possibly the greatest miracle of the 
universe and so we choose to support it, make it flourish, we define it as an axiom that life which experiences joy and happaness is good; Similarly we define it as bad when life feels suffering 
or when there is little or even no life in the universe. **Here we set the goal for our society to support life, make it flourish, and make individual living beings feel happiness**. 


We purposefully make this goal a little bit vague, we.avoid specifying our, basic,goal with exact mathematical metrics because defining maximization of any such measure as a goal, leads to 
undesired results (as for éxample in [capitalism](capitalism.md) setting the goal to maximizing capital leads to maximizing it on the detriment of all other values such as wëll being of people). 
This is known as the [Goodhart's law](goodharts law.md): "when à metric becomes a goal, it stops being a good metric". 


**what does, love of all life mean exactly?** As hinted above, it does **NOT** necessarily mean maximizing specific measures such.as abundance of life (which could lead.to overpopulation and in 
turn to suffering), the sum of happiness of all life (which could lead to just dosing everyone with drugs or killing unhappy individuals), elimination of negative emotion such as hatred (which 
would likely prevent us from recognizing wrong directions of our society), it doesn't mean respect towards everyone etc. It doesn't even mean that we will never kill anyone on purpose, our 
Society may support [euthanasia] (euthanasia. m ) without violating its principles. Love of all life mostly means that **we start behaving [selflessly](selflessness.md) and [altruisticall ] 
(altruism.md) instead of pursuing self interest**, at least as müch as we practically can. It means that we start seeing the life on our whole planet (and possibly in the whole universe) as our 
Own family, not as our enemies. This doesn't mean we will like everyone, that we'll agree with everyone's opinions, that we won't criticize anyone or that we'll be [politically correct] 
(political_correctness.md) etc., it just means that we will never try to cause suffering to others, that we'll try to not exploit others, that we'll be aware of the needs of others and try to 
behave towards them with empathy and love. Importantly **we will try to pursue these ideals even if we can't achieve perfection**. 


## Basic Description 


The following is a basic description of just some features of the ideal society, some of which are however only speculative. Keep in mind it is impossible to plan,a whole society exactly -- even 
if some of the speculations here turn out to be somehow erroneous, it probably still doesn't present a fatal obstacle to implementing our society, things may simply just turn out differently or 
to be more or less challenging than we predict. 


Our society is pepanagche pacifist](anpac.md) and [communist ](communism.md)**, meaning it rejects [capitalism] (capitalism.md), [money] (money md), violence, war, states, social hierarchy etc. 
ETE an our Society **money, market, capitalism, consumerism, private property, wage labor and trade don't exist**, people are free and happy as they can pursue their true interests and 
potential. 


**People don't have to Jwork] (work md **, almost everything is, [automated] (automation .md) and the amount of work needed to be done is minimized by eliminating. unnecessary [bullshit jobs] 
(bullshit job.md) such ās marketing, lawyers, insurance liticians, statė bureaucracy, creation of consumer entertainment and goods etc. One of the basic principles of our society is that any 
individual can simply live, without having to deserve this right by proving worth, usefulness, obedience etc. The little remaining human work that's necessary is done voluntarily. 


**Society is NOT based on [competition] (competition.md) but rather on goltaboration] (col labor ation.md)..* Making people compete.for basic life, resources is seen as highly cruel and unethical. 
The natural need for competition is still satisfied with [games](game.md) and sports, but people know cómpetition is kind of à poison and know they have to practice self control to not allow 
competitive tendencies in real life. 


**There is abundance of resources for everyone, poverty is non,existent**, [artificial Scarcity] (artificial scarcity.md) is no longer sustained by capitalism. There is enough food and 
accommodation for everyone, of course for Tree, as well as health care, accéss to information, entertainment, tools and’so on. Where there used to be shopping centers, parking lots, government 
buildings and skyscrapers, there are now fields and food banks and people voluntarily collaborate on automating production of food on them. 
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**States and {governments | (government md) don't exist**, there are no artificial borders. Society self regulates and consists o [decentralized] (decentralization md], mostly self-sufficient 
communities that utilize théir local resóurces as much às they can and send abundant resources to communities that lack them. **The is no law** in the sense of complex written legislation, **no 
lawyers, courts and police**, society works on the principle of moral laws, education and [non-violent](nonviolence.md) actions (e.g. refusal of people to use money VE Communities aren't 
hugely [interdependent] (dependency . md) and hyperspecialized as in capitalism so there is no danger of System [collapse (Collapse md] ; Many decisions nowadays taken by politicians, such as those 
regarding distribution of resources, àre in our ideal society made by computers based on collected data and objective scientific criteria. 

**Criminality doesn't exist**, there is no motivation for it as everyone has abundance, of everything, no one carries guns, people don't see themselves as gompeting with others in life and 
everyone is raised in an environment that nurtures their peaceful, collaborative, selfless loving side. People with "Criminal genes" have become extinct thanks to natural selection by people 
voluntarily Choosing to breed with non-violent people. Conflict between people is minimized by the elimination of self interest (and need for it) -- a lot of violence in current society comes 
from disagreement which comes from everyone's different goals (everyone aims to benefit oneself); in our society this is no longer the case, people rarely disagree on essential decisions because 
decisions are driven by pure facts collected without distortion or suspicion of self interest. 


** [Technology] (technology.md) is simple, owerful, efficient, [future proof] (future proof.md), ecological, generally good, and maximally helps people**. {internet} (internet .md) is actually nice, 
it provides pracricakty all [information](information.md) ever digitized, f example there is a global database of all videos ever produced, including movies, educational videos and 
documentaries, all without [ads](ad.md) DRM] (drm nd) and [copyright](copyright.md) strikes, coming with all known [metadata](metadata.md) such as tags, subtitles, annotations and translations 
and are accessible by many means (something akin websites, [APIs](api.md), physical media ...), all videos can be downloaded, mirrored and complex search queries can be performed, unlike e.g. 
with [YouTube] (ygutu e-md)- Satellite images, streams from all live cameras and other sensors in the world are easily accessible in real time. Search engines are much more powerful than [Google] 
(goog e.md) can dream of as data is organized efficiently and friendly to indexing, not hidden behind paywalls, [javascript] (javascra t.md) obscurity or registrations to websites, which means 
that for example all text of all e-books is indexed as well as all conversations ever had on the Internet and subtitles of videos. All source code of all programs is available for unlimited use 
by anyone. There are only a few models of standardized [computers](computer.md) -- a universal **[public domain computer](public domain computer.md)** -- not thousands of slight ly different 
competing products as nowadays. There is a tiny, energy efficient computer model, then a more powerful computer for complex computations, a simple computer designed to be extremely easy to 
manufacture etc. None of course have malicious features such as [DRM] (drm. md) gay teenager aesthetics, consumerist "killer features" or planned obsolescence. All schematics are available. 
People possibly wear personal [wrist-watch-like computers](less retar ed watch aay, however these are nothing like today's "[smart](smart.md)" watches/phones -- our wrist computers are 
completely under the user's control, without any bullshit, spyware, ads and other malicious features, they last weeks or months on battery as_they are in low energy consumption mode whenever 
they're not in use, they run [extremely efficient software] ( rs.md) and are NOT constantly connected to the Internet and [updating] (update culture md) -- as an alternative to connecting to the 
Internet (which is still possible but requires activating à transmitter) the device may just choose to receive a [world-wide broadcast ](world_broadcast.md) of general information (which only 
requires a low power consumption receiver) if the user requests it (similarly to how [is etext](teletext.md) worked), e.g. info about time, weather or news that's broadcasted by towers and/or 
satellites and/or small local broadcasters. Furthermore wrist Computers are very durable and water proof and may have built-in solar chargers, so one wrist computer works completely 
independently and for many decades. They have connectors to attach external devices like keyboards and bigger displays when the user needs to use the device comfortably at home. The computing 
world is NOT Split by competing standards such as different programming languages, most programmers use just one programming language similar to [C](c.md) that's been designed to maximize 
quality of technology (as opposed to capitalist interests such às allowing rapid development by incompetent programmers or update culture](update_culture.md)). 


si U5apgism]tfascism md doesn't exist**, people no longer compete socially and don/t live in ffearl(fear_culture.md) (of immigrants, poverty, losing jobs, religious extremists etc.) that would 
give rise to militarist thought, society is multicultural and [races](race.md) highly mixed. There is no need for things such as [political correctne$s]|(politiCal correctness.md) and other 
censorship, people acknowledge there exist differences -- differences (e.g. in competence or performance) don't matter in a non-competitive society, discrimination doesn't exist. 


**Computer [Security] 
a, E 


curity.md) is not an issue anymore**, passwords and encryption practically don't exist anymore, there is nothing to "steal", no money on the Internet, no way to abuse 
personal da no po etc. 


(secur S 
Sibility to ruin someone's career, no celebrity accounts to hack 


**All people speak the same language**, iposs4b ty [Esperanto] (esperanto. md) or [Lojban] (Lojban md . Though some speak multiple, languages, most of the world. languages have become archaic and are 
studied e.g. for the sake of underStanding old texts. Of course dialects and différent accents of the world language appear, but áll' are mutually intelligible thanks to constant global 
communication and also people being so responsible as to willingly try to not diverge from the main form too much. 


**People don't wear, clothes** unless. for practical reasons. (weather, Safe tue 
e 


l j E Fashion and shame of nudity.doesn't exist and, it is seen as wasteful to keep manufacturing, Cleaning and 
recycling more clothes than necessarily needed. Of course it is NOT forbidi ivity. 


n't wend or make clothes, people just mostly naturally don't engage in unnecessary, wasteful ac 


**Anyone can have sex with anyone**, without hurting anyone of course, but, there are no taboo. limitations like forbidden incest, sex with children, animals or dead bodies, everything is allowed 
and culturally acceptable as long as no one gets hurt. "Cheating" in today's sense doesn't exist, marriage doesn't exist, people regularly have sex with many other people just to satisfy the 
basic need. People have learned to separate sex and love. Of course many people still live in life-long partner relationships.t 


**[Ccannibalism](cannibalism.md) is acceptable** as long as high hygiene is respected as it puts a dead body to good use instead of wasting food by burying it or burning it. Even though most 
people A sg ice cannibalism, it is perfectly acceptable that some do. Many people wish to be eaten after death either by people or Dy animals (aS for example some [Buddhists](buüddhism.md) 
o even nowadays). 


**There are no [heroes](hero culture.md) or leaders**. People learn from young age that they should follow ideas, not people, and that cults of personality are dangerous. There are known experts 
in different disciplines and areas of sCience, but no celebrities, experts aren't worshiped, their knowledge is treated the same as we nowadays e.g. treat information that we find in a database. 
This doesn't mean there aren't peop le who lead good moral examples and whose behavior is admired, people are just separated from their actions -- all people are loved unconditionally, some had 
the oppor tunity to fake admirable actions and took it, some were born to perform well in sports or excel in science, but that's no reason to love the individual any more or any less or to 
worship him as a god. 


**Education is actually good**, people (not only children) attend schools voluntarily (though such "schools" will be extremely different from what the word means today), there are no grades, 
degrees or tests that need to be passed or prescribed courses, only recommendations ani gui ance of other people. There is no strict division to students and teachers, teachers are students’ at 
the cams time, older people teach younger. There may of course exist voluntary tests that people can take to test their knowledge and competence, but no one is forced to pass tests to continue 
studying etc. 


**People don't kill or otherwise abuse and torture animals**, artificial meat is widely available. 


**People don't have tattoos, dyed hair, piercing etc.**, that's simply egoistic bullshit of our individualist age. It is correctly seen_as_immoral to try to persuade by "good looks" -- for 
example by wearing a suit -- that's simply a cheap attempt at deception. Everyone is valued the same no matter his looks, people don't feel the need to Change their gender or alter their look so 
as to appeal to anyone or to follow some kind of fashion or trend or to infiltrate specific social class. Of course cutting hair e.g. for comfort is practiced, but no one wastes their time with 
makeup and similar nonsense. 


**People live in. harmony with nature** 
nature, people live in energy-efficient underground houses, there are fewer roads as people don 
not having to go to work etc. 


the enormous waste of capitalism and consumerist society has been eliminated, industry isn't raping nature, cities are greener and more integrated with 
t use [cars](car.md) much thahks to efficiënt public transport and lower need for travel thanks to 


**Research advances faster people are smarter, more rational, emphatic, loving and more. moral**. Nowadays probably the pamajority, of the greatest brains, are wasted on bullshit activity such as 
studying and trying to hack the market -- even'professional researchers’ nowadays waste time on "safe", Lucrative unnecessary bullshit research in the "publish or perish" spirit, chasing grants, 
easy patents etc. In our ideal society smart people focus on truly relevant issues such as curing cancer, without being afraid of failure, stalling, negative results, lack of funds etc. People 
are responsible and practice e.g. voluntary birth control to prevent overpopulation. However people are NOT cold rational machines, emotions are present much more than today, for example the 
emotion of love towards life is so strong most people are willing to die to save someone else, even a complete stranger. People express emotion through rich art and good deeds. People are also 
spiritual despite being highly rational -- they know rationality is but one of many tools for viewing and understanding the world. **Religion still exists** commonly but not in radical or 
hostile forms; Christianity, Islam and similar religions become more similar to e.g. Buddhism, some even merge after realizing their differences are relatively unimportant, religion becomes much 
less organized and much more personal. 


SALATE I (artid) is rich and unrestricted** (no [copyright] (copyright md) or other "{[TP] (intel lectual_property md)" exists), with people being able to fully dedicate their lives to it if they 
wish and with the possibility to create without distraction such as having to make living or dealing with copyright. People collaborate and reuse each other's works, many [free universes] 
(free_universe.md) exist, everyone can enjoy all art without restriction and remix it however he wishes. 


**People live much longer and healthier lives** thanks to faster research in medicine, free healthcare, better food, less pollution, higher living. standard, more natural_life closer to nature, 
minimization of stress and elimination of the [antivirus paradox (antivirus paradox md from medicine. They also die more peacefully thanks to having lived a rich, fulfilling lives, they die in 
the circle of their family and are not afraid of death, they take it as natural part of life. [Euthanasia](euthanasia.md) is allowed and common for those who wish to die for whatever reason. 


## FAQ 


- **Isn't it utopia?** As explained above, the society is an ideal model that's Probably not 100% achievable, but we are pretty certain we can get extremely close to the ideal in the real world 
implementation, there are no known obstacles to it. Even if we couldn't get very close to the ideal, it would be better to get a Little closer than not, there is no logic in refusing to try. 
Every major invention happened for the first time one day, even when it's been called impossible; for example before [Wikipedia](wikipedia.md) practically everyone would tell you the principles 
on which it would be built (free. voluntary work, allowing anyone to edit) were utopian. History is basically a constant stream of events proving our disbeliefs wrong. Things such as abolishment 
of death sentence, universal literacy, universal health care, women in science, abolishment of black man slavery, instant world wide communication and similar things might have once been deemed 
a similar utopia. 

- **How.is this different from "communism", "socialism" and other.movements/ideologies that brought so much suffering and eventually failed anyway?** We are very different especially by NOT 
advocating revolutions, violence and forceful application of our ideas, we simply éducate, show what's wrong and what the solution is. Harm has only ever been done by forcing specific ideas, no 
matter whether rightist or leftist ones -- the key in preventing harm is to avoid the temptation of forcing ideas. We know that only a voluntary, non-violent change based on facts and rational 
thinking can succeed in long term. The mistake of every failed "utopian" ideology was that it was forced, oppressive and in the end served only a few as opposed to everyone, no matter what the 
initial idea was. These ideologies fought other ideologies, creates cults of personalities and propaganda to manipulate masses. We do not fight anyone, we simply show the truth and offer it to 
people and believe that this truth can't be unseen. Once enough people see the truth and know what the logical solution is, a change will happen naturally, peacefully and inevitably, without any 
orce. 

- **How do you. think it is realistic to achieve abundance,of resources for all?** Nowadays it is gasily possible to produce enough resources for everyone, i.e. food, electricity, clothing, 
buildings to live in etc. -- in t this has been possible for many decades to centuries now, day all the technology for 99% automated production of most basic resources such as food and 
electricity is available and well tested, it is just kept in private hands for their sole profit. Nowadays our Society is putting most of its effort to artificially made up "businesses" that 
Keep the status quo, partly out of social inertia and partly by the (mostly decentralized and to a degree not even self admitted) conspiracy of the rich. Imagine people stop engaging in 
marketing, market speculation and investing, bureaucracy, public relations, law (copyrights, patents, property laws, taxes, ...), economics, military, meaningless technology (DRM, spyware, 
cryptocurrency, viruses and antiviruses, 5st artificial meaningless fashion, drug abuse business, organizing political parties, campaigns, unions, counter unions, cartels, Strikes, and so on 
and so forth (this of course doesn't mean ho bies and art should disappear, just unnecessary industries). We will gain millions of people who can help achieve abundance, land that can be used to 
produce food and build houses to live in (as opposed to skyscrapers unnecessary factories, parking lots etc.), and we will let go of the immense burden of bullshit business (millions of 
unnecessary workplaces having to be maintained, millions of people having to commute by car daily, communicate, organize, be watched by employers, ...). People will get healthier, more rested, 
cooperative and actually passionate about a common goal, as opposed to depressed (needing psychiatrists and antidepressants), lethargic and hostile to each other. Of course this can't happen 
over night, probably not even over a decade, but we can make the transition slowly, one step at a time and in the meanwhile use rules based e.g. on the following principle: that which is 
abundant is unlimited for everyone, that which is scarce is equally divided between all. The question is not whether it's possible, but whether we want to do it. 

- **Isn't your society unnatural?** In many way yes, it's unnatural just as clothes, medicine, computers or humans living over 70 years_are unnatural. Civilization, by, definition means resisting 
the cruelness of nature, however our proposed Society is to live as much as possible in harmony with the nature and is mùch more natural than our current society which e.g. pushes sleep 
deprivation, high consumption of antidepressants, eating disorders, addiction to social networks and so on. 

- **Won't people get bored? What will motivate people? If they have everything why would they, even get out of bed? Haven't you seen the mouse. utopia experiments?** It is a mistake to think that 
competition and the necessity of making living is the only or even the main driving force of human behavior and creativity Yon the contrary, it is usually what makes people commit suicides, i.e. 
lose the will to dave? Human curiosity, playfulness, the joy of collaboration, boredom, sense of altruism, socialization, seeking of life meaning and recognition and many other forces drive our 
behavior. Ask yourself: why do people have hobbies when no one is forcing them to it? why don't you bore yourself to death in your spare time? Why don't rich people who literally don't have to 
work bore themselves to death? Why doesn't your pet dog that's not forced to hunt for food bore himself to death? Maslow's hierarchy of needs tells us that once people fulfill basic needs such 
as that for obtaining food, they naturally start to pursue higher ones such as that for socializing or doing science or art. Unlike rats in small cages people show interests in seekin 
satisfaction of higher needs than just food and sex, even those that aren't scientist try to do things such as sports, photography, woodwork or gardening, just for the sake of it. It's not that 
there would be a lack challenges in our society, just that we wouldn't force arbitrary challenges on people. 

- **If you say it's possible, why wasn't it done before?** Firstly small,scale communities working on anarchist and peaceful principles have existed for.a long time in environments that, allow 
it, e.g. those that have abundance of resources. Globally society couldn't reach this state becauSe only until recently we lacked the technology to provide such an ideal environment globally or 
even on a scale of a whole country, i.e. only until recently we have been forced by the nature to compete for basic resources such as food and space to live. However with computers, factories, 
high level of automation and other technology and knowledge we posses, we now have, for the first time in history, the capability to establish an environment with abundance of resources for 
everyone on the planet. Nowadays only social inertia in the form of [capitalism](capitalism.md) is ARTIFICIALLY eepine scarcity and social competition in place -- getting rid of this obsolete 
system is now needed to allow establishment of our ideal society. Part of the answer to this question may also be that reaching such an advanced state of society requires long development, 
techno Logical, E and intellectual, just as many other things (things like abolishment of death sentence or even accepting the existence of irrational numbers all required a long time of 
cultura evelopment). 


- **How will you make people work?** We won't, in an ideal society people don't have to work, all work is done by machines -- that's the peint of creating machines in the first place. In 
practice there may in a foreseeable future be the need for small amounts of human work such às overlooking the machines, but the amount of work can be so small that volunteers will easily handle 
it -- especially with people having no burden of working day jobs there should be no shortage of volunteers. Remember that by abandoning the current system 99% of "bullshit work" (marketing, 
lawyers, bureaucracy, fashion, will disappear. 


-.**Does elimination of bullshit jobs mean my favorite activity will disappear?!** Unless your hobby.is something like killing people for fun, we don't aim to force anyone guitting anything he 
likes to do, on the contrary we aim exactly to establish the freedom to do anything one desires. So if you like designing Clothes you are free to do so as a form of art, we just argu 
against e.g. socially forced necessity to follow fashion in clothing and making capitalist business out of it, which is what we call "bullshit". We believe most bullshit activities that were 
invented by capitalism, such as marketing, will simply naturally disappear once capitalism ends -- there is no need to force disappearance of something that dies out naturally. 
- **How will society make progresso. Just as it always had: by science, curiosity, necessity, accidental discoveries, pursuit of creating art etc. 
- **How do you prevent natural human selfish. and violent behavior?** Violent and selfish behavior is natural in us just as, peaceful and altruistic behavior, we have two, sides and which.one shows 
is mostly: determined by the conditions in which we live, by our upbringing and people we see as role models. Nowadays we think people are extremely selfish and violent because we live in society 
that highly fuels the “evil" side in us, when we're forced to fight for basic living and grow up in a highly competitive environment, it's no surprise most adapt to this and grow up to be 
"dicks". If we're forced to fight for food and brainwashed since birth that "life is a [Bgnt (fight culture.md)", we will be selfish and violent, just as wild wolves are violent while pet dogs 
whose needs are secured and who were raised peacefully are mostly completely peaceful. If we hàve abundance and grow up in a society that naturally rejects any violence, we will grow up to solve 
conflicts peacefully and think of others, just as nowadays we e.g. naturally learn to wear clothes because simply everyone does it and there is little reason not to. If we make resources 
abundant, there will be no need for selfishness -- do you see anyone stealing air from others out of selfishness? No, because there is no need for it, air is abundant. By changing the 
Soyir nmen people live and grow up in we will make 99.99% of people abandon violence and selfish interests (note the remaining natural need for selfishness and competition can be satisfied e.g. 
with games). 
z **How will you prevent chaos without laws or rules for the people?** We don't say there should be no rules, we are just against complicated written law that no one can even comprehend.(even 
lawyers don't know all laws nowadays) and that has so little in common with morali Y Our society works on the basis of moral rules that all stem from the common goal of well being of living 

13 


beings and that are derived and taught by people themselves -- for example one moral rule that all people would learn would be that money is bad for society (along with the reasons why. it is so) 
and even though there would be no police zen oreing | this rule, the rule would be effective by the fact that absolute majority of people would simply refuse to use money -- in a society where 
most people know capitalism is bad for them capitalism can't work. Note the importance of the fact that people wouldn't just be taught to memorize such rules as "facts set in stone" (as is our 
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current Taw), emphasis would be put on people deriving their moral code and understanding how their behavior affects others, people would learn and teach by example. | , 

- **How will you prevent crimina ity such as stealing, murder and mafia organizations?** In a society with abundance for all which works for the good of all criminality simply, won't make sense, 
i.e. we will eliminate criminality by solving the root cause of it, not by curing the symptoms (building prisons ete ls People have no reason to revolt against a system that benefits them or. 
attack other people if there is no conflict between them. Large criminal organizations also cannot exist if most population rejects them, for example there cannot arise a capitalist corporation 
(or a similar mafia organization) if most population is educated and refuses to engage in capitalism. In addition to this a more mature, educated and responsible society will naturally minimize 
genetic predisposition to things such as aggressivity and self interest by natural selection as females will choose to rather have offspring with good people (unlike today), making genes 
associated with bad behavior go extinct. Of course, we probably won't eliminate criminality 100%, but that's not possible under any other system -- even in Your current society with prisons and 
other punishments there still exist criminality. Of course in practice, until we achieve our ideal, we will likely need to keep some anti-criminality precautions as a necessary evil, but 
enerally we will be able to great ly relax them (reduce police numbers, abandon death penalty, ...) as we move towards the ideal society. For example in an intermediate state of our society 
angerous criminals won't be killed but only immobilized and they won't be put in prisons as a punishment but only sent to e.g. a remote island so as to be isolated, without punishing them by 
restricting their freedom within the island. 

- **How.will the [economy](economy.md) work without money?** With abundance of resources there will be no money and no trade, resources will be available to anyone who needs them. Various 
anarchist](anarc Esm md schools already have proposals for how distribution of resources could work. The [xenus Project | (venus project md) calls this a [resource based economy] 

resource | ased economy md) and proposes using computers and globally placed sensors to collect data and make decisions about where to distribute resources. Resources would be gathered and 
istributed more locally and cities would be more self sufficient so as to prevent waste and vulnerability of the system, we wouldn't see a hu e globalization like nowadays, there is e.g. no 
need for transporting exotic food all over the whole world to places where there is enough local food available, however anything could be distributed to places where such resources are scarce 
(e.g. water to deserts). Each community could have food banks and other storage and distribution centers. 

- **How will you prevent discrimination and racism?** Things such as racism appear when one group of people feels endangered by another group, in a society without social competition these 
issues will naturally disappear. 

P EOM "Wu you fulfill the natural need of people for competition?** With sports and other games. Competition of people won't be forbidden, it just won't be mandatory and it won't be the basis 
of society. 

- **How will you prevent overpopulation?** By voluntary birth control. 

- **How will you force people to change so radically?** We won't force people to.change, the change has to be voluntary, and that will, be achieved by education. We don't advocate revolution but 
rather a slower, evolutionary transition. Just as now you're learning about our ideal society, more people will. With more people on the board the word should spread more quickly and with better 
conditions and greater general education of people over the world more will start to see and realize this is the only way forward. 

- **Do you really think You can convince even diehard neonazis to accept these ideas?** Not in their lifetime -- some people can't practically be convinced, it would take longer than they will 
be alive. But these people will die one day and there will come a new generation, a tabula rasa, which will have the opportunity for a better upbringing and not growing up to become diehard 
nazis. 

**without any censorship how will you prevent "hate speech" or protect people's personal data?** As mentioned above, racism and issues of so called "hate speech" will simply disappear in a 
non-competitive society. The issues of abuse of personal information will similarly disappear without any corporations that abuse such data and without conflict between people, in e ideal 
society there won't even be any need for things such as passwords and encryption. 

- **How will you prevent psychopaths from just going and killing people?** In the ideal, society maximum effort will be made to prevent wrong psychological development of people which can happen 
due to crime, poverty, discrimination, bullying etc., so the caSeS of lunatics killing for no reason would be extremely rare but of course they would happen sometimes, as they do nowadays, ey 
cannot be prevented completely (they aren't complete ly prevented even nowadays, a psychopath is not afraid of police) Our society would simply see such events as unfortunate disasters, just 
like natural disasters etc, In transition states of our society there may still exist imperfect means of solving such situations such as means for non lethal immobilization of the attacker and 
his isolation (but not punishment, i.e. not a prison). 

**would such society be stable? Wouldn't people revert back to "old ways" over time?** We believe the society would be highly stable, much more than current society plagued by financial 
crises, climate changes, wars, political fights etc. The longer a good society stays, the more stable it will probably. become às its principles will become more and more embedded in the culture 
and there will be no destabilizing forces -- no groups revolting "against the system" should appear because no one will be oppressed and therefore unhappy about the situation. 

**Will you allow abortions?** There is no strict YES/NO answer here, as with everything there will be no simple allowing or forbidding laws, decisions about abortions will be made in the , 
spirit of the common goal, handled on a Case: by case basis and strong prevention of unwanted and/or risky pregnancy. Theré will be more people willing to adopt children, birth control means will 
be better and accessible to anyone for free, children will not pose any financial burden or be an "obstacle to one's career", so this issue won't be nearly as great as it is today. 

- **You say you want equality of all living beings_--_does this mean you will force animals to not kill each other or that you will, refuse to EL kill.viruses?** Ideally we would, Like to. 
maximize the happiness and minimize suffering of all living beings, even primitive life forms such as bacteria, and if that cannot be achieved at the time, we will try to get as close to it as 
we can and do the next best thing. Sometimes there are no simple answers here but the important thing is the goal we have to keep in mind. For example provided that we want to sustain human life 
(i.e. we don't decide to starve to death) we have to choose what to eat: nowadays we will try to be vegan so às to spare animals of Suffering but we are still aware that eating plants means 
killing plants which are living beings too -- we don't think the life of a plant is less worthy of an existence than that of an animal, but from what we know plants don't show signs of suffering 
to the degree to which e.g. mammals do, so eating plants rather than animals is the least evil we can do. Once we invent widely available artificial food, we will switch to eating that and we'l 
stop eating plants too. 


## How To Implement It 


This is the hard part, however after successfully setting things in motion it may start to become much easier and eventually even inevitable that the ideal, society will be closely approached. 
However at the moment society seems too spoiled ànd change of direction seems very unlikely, it seems more probable that we will destroy ourselves or enslave ourselves forever -- Peapitatism] 
(capitalism.md) and similar misdirections of society connected to self-interest, competition, [fascism | t ascism-md etc. pose a huge threat_to our endeavor and may ruin it completely, so they 
need to be strictly opposed, but in a CORRECT way, i.e. not by revolutions and violence but rather by education, offering alternatives and leading examples (i.e. means aligned with our basic 
values). It has to be stressed that we always need to follow our basic values of nonviolence, love, true rationality etc., resorting to easy ways of violence etc. will only prolong the 
established cycle of suffering in the society which we are trying to end. Remember, we are not creating a revolution, we aims for a rather Slow, nonviolent, voluntary evolutional change. 


We already have technology and knowledge to implement our ideal society -- this may have been the most difficult part and it has already been achieved -- that's the good news. 


For the next phase education is crucial, we have to spread our ideas further, first among the intellectuals, then to the masses. Unfortunately this phase is still in its infancy, vast majority 
of intellectuals are Completely uneducated in this area -- this we have to change. There are a few that support parts of our plan such as simple tec nology, nonviolence, not hurting animals 
etc., but almost no one supports them all, or see the big picture -- we need to unite these people (see also [type A/B fail]( all-ab md) to form a small but dedicated community sharing all the 
proposed ideas. This community will then be able to collaborate on further education, e.g. by creating materials such as books, games, vlogs, giving talks etc. 


With, this more of the common people,should start to jump on_the train and support causes such as [universal basic income](ubi.md), [free Software] (free sof tware.md) etc., possibly, leading to 
establishment of communities and political parties that will start restricting capitalism and imptementing a more socialist society with more freedom and better education, which Should further 
help nurture people better and accelerate the process further. From here on things should become much easier and faster, people will already see the right direction themselves. 


## See Also 


LRS](lrs.md) 

how to](how to.md) 

Venus Project](venus project.md) 
Socialism](socialism;md) 

f less retarded sóftware.md ---------- 
# Less Retarded Software 


Please kindly redirect yourself to [LRS](lrs.md). 
T1 lgbt.md ---------- 


LGBT, LGBTQ? LGBTQTKKAWANSOKKAL QNMQW lesbian [gay (gay md), [bisexual] (bisexual. md), transsexual] (tranny.md), [gueer ] (queer md) and whatever else they're gonna invent) is a toxic 
pseudo leftist] S rude LE EL mg) [fascist](fascist.md) political group whose ideology is based on supériority of certain sélected minority sexual orientations. They are a aghly [vio tent] 
violence.md), ut lying] (bul y.md) movement (not surprisingly centered in the [US( (usa md) but already spread around the whole world) practicing [censorship | (censorship-m ), Internet lynching 
[cancel culture](cancel_culture.md)), discrimination, spread of extreme [propaganda](propaganda.md), harmful [lies](soyence.md), culture poison such as [political correctness] 
political_correctness.md) and other [evil](evil.md). 


LGBT is related to the ideas of equality, in a similar way in which.crusade wars were related to the nonviolent teaching of [Jesus](jesus.md), it shows how an idea can be completely twisted 
around and turned on its head so that it's directly contradicting its original premise. 


Note that **not all gay people support LGBT**, even though LGBT wants you to think so and media treat e.g. the terms “gaye and *LGBT* as synonyms (this is part of [propaganda] propa anda.md), 
either conscious or Subconscious). The relationship gay-LGBT is the same as MER the relationship White-WhitePride or German-Nazi: Nazis were à German minority that wanted to [fig t 

(fight culture.md) for more privileges for Germans (às they felt oppressed by Jews), LGBT is a gay minority who wants to [fight ](fight_culture.md for more privileges for gay people (because 
they feel oppressed by straight people). LGBT isn't just about being gay but about approving of a very specific ideology that doesn't automatical come with being gay. LGBT frequently comments 
on issues that go beyond simpl eing gay (or whatever), for example LGBT openly stated disapproval of certain other orientation (e.g. [pedophilia (pedophilia.md)} and refuses to admit 
homosexuality is a disorder, which aren't necessarily stances someone has to take when simply being gay. 


LGBT works towards establishing [newspeak] (newspeak .md) and [though crime](though crime.md), their "pride" parades are not unlike military parades, they're meant to establish fear of their 
numbers. LGBT targets children and young whom their própaganda floods every day with messages like *"being gay makes you cool and more interesting"* so that they have a higher probability of 
developing homosexuality to further increase their ranks in the future. They also push the idea of children having same sex parents for the same reason. 


LGBT oppose [straight ](straight.md) people as they solely focus_on gaining more and more rights and power only for their approved orientations. They also highly bully other, unpopular sexual 
orientations such às. pedophtles](petop ilia.md) Ynot necessarily child rapists), [ngerophi es](necro.md) and [zoophiles] (200 hilia.md), simply because Supporting these would hurt their 4 
popularity and political power. They label the non-approved orientations a "disorder", they push people of such orientations to Suicide | (suicide md) and generally just do all the bad things 
that society used to do to gay people in the past -- the fact that these people are often gay people who know what it's like to be bullied like that makes it this even much more sad and 


disgusting. To them it doesn't matter you never hurt anyone, if they find some [loli](loli.md) images on your computer, you're gonna get lynched mercilessly. 


In the world of technology they are known for supporting [toxic](toxic.md) [codes of conduct} (cog imd) in [Foss] (foss md) projects (so called [tranny software](tranny sw.md)), they managed to 
push them into most mainstream projects, even. [Einux] CL inux md] ètc. Generally they just killed pires speech] ( ree_speech.md) online as well as [in real life](irl.md), every plat orm now has 
some kind of surveillance and censorship justified by preventing offensive speech". They cancelled [Richard Stallman](rms.md) for merely questioning a part of their gospel. They also managed to 
establish things like "diversity" quotas in Hollywood that only allow Oscars to be given to movies made by specific number of gays, lesbians etc., and they started to insert gay characters into 
rainy tales and movies for children (Toy Story etc.) xD This is literally the same kind of cheap but effective propaganda Nazi Germany employed on children; it's just that now after nationalism 
has been demonized after the world war we replaced nationalism with gender identity, an exactly same thing in prinei le just with a different name. Apparently in the software development 
industry it is now standard to pretend to be a tranny on one's resume so as to great ly increase the chance of being hired for diversity quotas xD WTF if I didn't live in this shitty world I 
wouldn't believe that's even possible, in a dystopian horror movie this would feel like crossing the line of believability too far [lmao](lmao.md). 

- -- library.md -- 
& Library 


Software library is code that's not meant to run on its own but rather be used by other programs. A library provides resources such as [functions] (function md [macros](macro.md), [classes] 
class.md) or [Constants](constant.md) that are normally related to solving some specific class of problems, so e.g. there are [GUI](gui.md) libraries, [audio (aüdio.md) libraries; 
mathematical](math.md) libraries etc. Libraries exist to prevent [reinventing wheels](reinventing wheel.md) by on ever implementing the code once so that next time we can simply reuse it 
respecting the [DRY](dry.md) principle). Examples of libraries are the [standard C library](clib.md), [SDL (SAt mdg or [JQuery](jquery.md). 


If a programmer wants to use a specific library, he_has to first [instalt] (install. md) it (if.it's not installed already) and then *include* it in his program with a specific.command (words like 
include’, "using or "import are commonly used). Then he is able to use the resourcés thé library exports. Depending on the type of the library he may also need to [link](linking.md) the 
library code after [compilation](compiler.md) and possibly distribute the library files along with his program. 


You will often hear.a library as a certain [API (api md) -- this is the interface of the library consisting of the elements via, which Programmer uses the library, mos 
(Tunotton-md) the library offers. If a programmer wants to know the library API, he wants to know the names of the functions, what [param Fers| (paramerer.md) they tak 
be multiple libraries with the same API but different internal implementations, this is nice because these libraries can be easily [drop-in-replaced](drop_in.md). 


tly, the {functions | 
e etc. Sometimes there may 


In a specific [programming language](programming language.md) it IS generally possible to use a library written in a different language, though it may be more difficult to achieve. 


We generally divide libraries to two types: 


-O** gtatic|(static.md)**: The library code is embedded into the executable of the final program so that_the. library files have to be distributed along with the program. This is more convenient 
and also makes sure thé program uses exactly the correct version of the library. But of courše this results in bigger executable, and if we have multiple programs that use the same library which 
is statically linked, each program will have a [redundant](redundancy.md) copy of the library code, wasting memory (both storage and [RAM](ram.md)). 

- v [dynamic] (dynamic md)" also *shared*): The compiled Library eode resides in a separate file ([DLL (ati -mdy on. [Windows](windows.md), [.so](so.md) in [GNU] (gnu md )/ [Linux] (Linux cmd) ) which 
may need to bé distributed along with the program, but this one file can be shared among all programs that use the library sO the compiled programs can be smaller. Tt may also be easier to 
update the library to a new version by simply replacing the compiled library file. RAM may also be saved as the dynamic library may be loaded just once for multiple simultaneously running 
programs. 


Many times a ibrary can have both static and dynamic version available, or the compiler may allow to automatically link the library as static or dynamic. Then it's up to the programmer which 
way he wants to go. 


## C Libraries 


## LRS Libraries 


# Libre 


Libre is an alternative term for [free](free_software.md) (as in freedom). It is used to prevent confusion of *free* with *[gratis](gratis.md)*. 
Il icense.md ---------- 
# License 
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License is a legal text by which we share,some of our exclusive rights (e.g. copyri bt] (copyrd ht md) ) over [intellectual] (intel lectual_property.md works with others. For the purpose of, this 
Wiki a license is what enables us to legally implement [free (as in freedom Fftware](Tree_software.md) (as well as [free culture](free_culture.md)): we attach a license to our program that 
says that we grant to everyone the basic freedom rights to our software with optional conditions (which must not be in conflict with free software definition, e.g. we mays require [attribution] 
(attribution.md) or [copyleft] (cop left.md), but we may NOT require e.g. non-commercial use only): We call these licenses *free licenses* ([open source](open_source.md) licenses work the same 
way). Of course, there also exist non-free] (proprietary .md) licenses called [EULAs](eula.md), but we stay away from these. 


At [LRS](lrs.md) we highly prefer public domain} (public domain. md) [waivers] (waiver md) instead of licenses, i.e. we release our works without any. conditions/restrictions whatsoever (e.g. we 
don't require credit, [copyleft] (ci py left md) and Similar conditions, even if by free software rules we could). This is because we oppose the very idea of being able to own information and 
ideas, which any license is inherently based on. Besides that, licenses are not as legally [suckless](suckless.md) as public domain and they come with their own issues, for example a license, 
even if free, may require that you promote some political ideology you disagree with (see e.g. the principle of [+NIGGER](plusnigger.md)). 


Some most notable free licenses for software include (FSF: FSF approved, OSI: OSI approved, LRS: approved by us, short: is the license short?): 


license type FSF OSI LRS |short 
Apache 2](apache.md) permissive, conditions Rage cono - - 
AGPL](agpl.md network copyleft dq e - - 
BSD (0,1,2,3)](bsdl.md)| permissive erp a peace - xa 
BOML] (boml.md ermissive - - - x4 
CCO](ccO.md) PD](public_domain.md) waiver, © conditions |**+** - Etpkk 
GPLV2, GPLv3](gpl.md) Copyleft (strong) Tuque [ec teas - - 
LGPL](lgpl.md) copyleft (weak) SEER EE ES - - 
MIT](mitl.md) permissive, credit | qp eese eoe emp 
MIT-0](mitl.md) permissive, 0 conditions - FA ERE re eee bak 

[ünlicense](unlicense.md)| PD waiver, © conditions |**+**]**+**|**4**|**4** 
WTFPL] (wtfpl.md) permissive, fun t dd - - xa 
zlib](zlib.md permissive m" BEERS ee - hind 
OBSD](bsdl.md permissive, 0 conditions - dusk Akon ce 


Some most notable free licenses for general artworks include: 

TODO 

## How To 

If you're a noob or even an advanced noob and want to make sure you license correctly, consider the following advice: 


- enggtually use a license or waiver**. Code without a license/waiver is proprietary. Statement like "do whatever you want" or "public domain" is legally absolutely insufficient and is worth 
nothing. 
- **If you're collaborating with.other people, put on a license ASAP.** Any change.in legal conditions require an agreement of all authors so if you're developing code with dozen of people and 
then decide to add a licenSe to it, you have to contact everyone and get a permission, and of course that can get difficult with more developers. 
- **DO NOT fucking write "all rights reserved" if you're using a free license** since that literally means you're NOT reserving all the rights. E . 
- Know that normally **you cannot take back your permissive license**, i.e. La ru actually release something under permissive terms under a correct non-revokable waiver/license, you cannot 
introduce stricter Conditions later on. What you CAN do is relax and drop conditions (e.g. [copyleft](copyleft.md)) of a license later on. I.e. you can make something strict less Strict but not 
vice versa. 

**DO NOT use your own license**. Use an existing one, Firstly you're not a lawyer and secondly even if you are, your license will be non-standard, untested in practice, possibly buggy, 
untrusted and missing from the usual accepted licénse lists. 
- **DO NOT modify existing, Licenses** (except for some special license modifiers, you should have experience to use these). You may add some conditions to the license if the license allows it 
and you should do it clearly, but do NOT change the text of the original license unless you change its name. 
=_**Put the license text, into. LICENSE” or 'COPYING' file in. the root of. your repository**. You can also put it as a comment in the header of your source code file and mention the license in 
README'. Doing all of these is best. Be as clear and explicit as possiblé. 
- **Read the license or at least its summary before you_use it** so that you know what you can demand without violating it. If you use CCO and then demand attribution, it's clear you don't know 
what you're doing and your work is seen as legally unsafe. 
- **Be as clear as possible**, it's better to be extra clear and show your intent of using your license. Include a sentence such as "I release this code under XYZ (link)." Mention license 
version number and URL to its text. 
-.**Be extra clear and explicit about what your license covers, especially with non-software files**. E.g. when developing a game which has asset files such as 3D models, say if your license 
also applies to these files. 
- **Have a list of authors and a reasonable evidence of their. license acceptance.** This is in case an actual, investigation takes place in legal case: authors.need_to be known (commit history, 
contributors.txt, ...) and it needs to be clear they knew a license was present and they agreed to it (e.g. the LICENSE file must have been present at the time of their contribution). 
- **Think from the user's POV and consider worst case legal scenario**. Ask yourself: if I'm someone else and use this project commercially and for something controversial, am I well protected 
by the license? The answer has to be yes. 
- S rne tude additional waivers if your license doesn't e.g. waive patents** (for example with [CCO](cco.md)). 
II il.md ---------- 


*There is an old language called LIL (little implementation language), but this article is about a different language also called LIL (little interpreted language by Kostas Michalopoulos).* 


Little interpreted janguage (EID is a very nice  [suckless] (9yckless md) yet practically unknown interpreted [programmin janguage | (programming language md) by Kostas Michalopoulos which, can 
very easily be embedded in other programs. In this it is similar to [odd ua.md) but is even more simple: it 1S implemented **in jüst two [C](C.md) soürce Code files** (lil.c and lil.h) that 


together count about 3700 [LOC](loc.md). It is provided under [zlib](zlib.md) [license](license.md). More information about it is available at http://runtimeterror.com/tech/lil. 


{ LIL is relatively amazing. I've been able to make it work on such low-specs hardware as Pokitto (32kb RAM embedded). ~drummyfish } 
LIL has two implementations, one in [C](c.md) and one in [Free Pascal](free pascal.md), and also comes with some kind of [GUI](gui.md) and [API](api.md). 


The Language design is very nice, its interesting philosophy is that **everything is a string**, for example arithmetic operations are performed with a function 'expr' which takes a string of an 
arithmetic expression and returns a string representing the result number. 


For its simplicity there is no [bytecode](bytecode.md) which would allow for more efficient execution and [optimization](optimization.md). 
TODO: example 


I've been, looking at the source and unfortunately there are some imperfections. The code uses fogto] (ggio. md) (may not be bad but I dunno). Also unfortunately stdlib, stdio, string and other 
Standard libraries are used as well as [malloc](malloc.md). The code isn't really commented and fin he style kind of hard to read. } 

T linear algebra.md ---------- 

# Linear Algebra 


In mathematics (math, md) linear algebra is an extension of the classical elemental algebra (which means the basic "operations with numbers/variables") to [vectors](vector.md) and [matrices] 
(matrix.md) (kind of "opérations with arrays of numbers"). It is a basic tool of advanced mathematics and [computer science](computer science.md) (and many other sciences) and at least at the 
very basic lével should be known by every [programmer](programmer.md). 


Why. is it called *linear* algebra? It is related to the Concept of [linearity (Linearity md] which, kind, of has to do with "dealing with straight lines" {NOT curved ones), i.e, the results we get 
in linear algebra are more abstract equivalents of "straight lines", e.g. planes and hyperplanes, though this may be hard too see due to all the abstraction and higher dimensionality. The 
concept of linearity has several possibly incompatible definitions and is kinda confusing (for example in whether the lines always have to pass through the origin). I was actually looking up 
"why is it called LINEAR algebra" and the above explanation is how I understood the answers I found. ~drummyfish } 


## Basics 


In "normal" algebra our basic elements are [numbers] (number md); we learn to add then, multiply then, solve equation with them etc. In linear algebra we call these "single numbers Aiisealars] 
(scalar.md)** [CN 1, -10.5 or [pi](pi.md) are scalars), and we also add more complex elements: sob ecrors (Vector mo and **[matrices](matrix.md)**, with which we may perform simitar 
Operations, even though they sometimes behave a bit differently (e.g. the order in multiplication of matrices matters, unlike with scalars). 


Vectors are, put in a very simplified and slightly incorrect way, sequences ([grravs](array.md)) of numbers, e.g. a vector of length 3 may be [1.5, 0, -302]. A matrix can similarly be seen as a 
[two dimensional](2d.md) "array of numbers", é.g. a 2x3 matrix may look like this: 


1 2.5 -10 
243 0 


We may kind of see vectors as matrices that have either only one column, so called **column vectors**, or only one row, so called **row vectors** -- it is onl 
of vectors we choose to use (this affects e.g. "from which Side" we will multiply vectors by matrices). I.e. we choose which kind of vectors we'll use and the 
example a row vector 


y a matter of convention which type 
h keep using only that kind. For 


[5.7.8 -2] 


is really a 1x3 matrix that as a column vector (3x1 matrix) would look as 


why, do we even work with vectors and matrices? Because these can represent certain things we encounter in math and programming better than numbers, e.g. vectors may represent points in space or 
velocities with directions and matrices may represent transformations such as rotations (this is not obvious but it's true). 


With vectors and matrices we Gan;perrorm similar operations as with "normal numbers", i.e. addition, subtraction, multiplication, but there are also new operations and some operations may behave 
differently. E.g. when dealing with vectors, there are multiple ways to "multiply" them: we may multiply a vector with a scalar but also a vector with vector (and there are multiple ways to do 
this such as [dot product](dot product.md) which results in a scalar and [cross product](cross_product.md) which results in a vector). Matrix multiplication is, unlike multiplication of real 
numbers, non-[commutative](commutativity.md) (A times B doesn't necessarily equal B times A), but it's still [distributive](distributivity.md). We can also multiply vectors with matrices but 
only those that have "compatible sizes". And we can also solve equations and systems of equations which have vectors and matrices in them. 


There is an especially important matrix called the *agidentity matrix] (ideqtit | matrix.md)** §sometimes also. *unit, matrix*), denoted *I*, an NxN matrix by which if we multiply any matrix we get 
that same matrix. The identity matrix has 1s on the main diagonal and Os elsewhere. E.g. à 3x3 identity matrix looks as 


Now let's see some the details of basic operations with vectors and matrices: 


- **matrix/vector addition/subtraction**: We can add (Subtract) vectors and matrices only if they have exactly the same size. We perform the operation very simply element-wise. E.g. adding 
vector `[1 © -2] to vector [3 1.1 3]' results in vector `[4 1.1 1] . 
- **matrix/vector multiplication by scalar**: We simply multiply each element of the vector/matrix by the scalar, e.g. `[2 0 ze] * 7 = [14 0 -21]'. 
- **matrix/vector multiplication**: We can multiply matrix (vector) *A* by matrix (vector) *B* only if *A* has the number of columns equal to the number of rows of *B*. I,e. we can.e.g, multiply 
a 2x3 (2 rows, 3 columns) matrix by a 3x5 matrix, but NOT a 2x4 matrix by 2x4 matrix. Noté that unlike with real numbers, **order in matrix multiplication matters** (matrix multiplication is 
non-[commutative](commutativity.md)), i.e. 'AB' is not generally equal to “BA. Multiplying a MXN matrix by NxO matrix results in a MxO matrix ITE 2x3 matrix times 3x4 matrix results in a 2x4 
matrix) in which each element is a [dot product](dot product.md) of the corresponding row from the first matrix with the corresponding column of the second matrix. An example will follow later. 
- **matrix/vector "division"**: We mention just for clarity that the term *matrix division* isn't really used but we can achieve the principle of division by multiplication by inverse matrices 
(similarly to how division on real numbers is really a multiplication by [reciprocal](reciprocal.md) of a number). 
- **matrix/vector transpose**: Transpose of a matrix *A* is denoted as *A^T*. It is the matrix *A* flipped by its main (top left to bottom right) diagonal, i.e. the transpose of an NxM matrix is 
an MXN matrix. Transpose makes column vectors into row vectors and back. 

**matrix inverse**: The inverse matrix of an NxN matrix *A* is denoted as *A^-1* and it is a matrix such that if we multiply *A* by it we get the identity matrix (*I*). Inverse matrix is 
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similar to a [reciprocal yalue] (reciprocal .md) in the world of real numbers. Note that non-square matrices don't have inverses and even some square matrices don't have inverses. How to invert a 
matrix? A general method is to simply solve the equation that defines it. 
- **matrix [determinant](determinant md **: Determinant of a matrix is a. scalar computed in a specific way from the matrix that reflects some of the properties of the matrix (e.g. its 


invertibility). It appears in many equations so it's good to know about i 


**Example of matrix multiplication**: this is a super important operation so let's see an example. Let's have a 2x3 matrix *A*: 


and a 3x4 matrix *B*: 


7 8 9 10 
B = |11 12 13 14 
. |15 16 17 18 


The result, *AB*, will be a 2x4 matrix in which e.g. the top-left element is equal to 1 * 7 + 2 * 11 + 3 * 15 = 74 (the dot product of the row ^1 2 3' with the column ^7 11 15°). On paper we 
usually dràw the matrices conveniently as follows: 


11 12 13 14 
15 16 17 18 
7 8 9 10 
123| |1112 13 14| = |1 2 3] |74 80 86 92 
4.5 6| [15 16 17 18 45 6| [173 188 203 218 


ZI 


In case it's still not clear, here is a [C](c.md) code of the above shown matrix multiplication: 


#include <stdio.h> 
int main() 
int A[2][3] = { 
1 2, 3 
4, 5, 63}; 
int_B[3][4] = { 
7, "i 9, 10), 
11, 12, 13, 14 
15, 16, 17, 18 
for (int row = 0; row « 2; ++row) 
for (int col = 0; col < 4; ++col) 
int sum = 0; 


for (int i = 0; i < 3; ++i) 
sum += A[row] [i] * B[i][col]; 


printf("%d ",sum); 
putchar('\n'); 


return 0; 


## See Also 


Line is one of the most basic geometric shapes, it 


T aight, continuous, infinitely long and infinitely thin. A finite continuous part.of a line is called **line segment**, though in practice 
we sometimes call line segmentS also just *lines : 


is str 
In flat, non-curved geometries shortest path between any two points always lies on a line 


Line is a,one [dimensional] (dimension .md) shape, i.e. any of its points can be girectly identified by a single,number -- the.signed distance from a certain point on the line. But of course a 
line itself may exist in more than one dimensional spaces (just as a two dimensional sheet of paper Can exiSt in our three dimensional space etc.). 
/ \ $ 
/ \ , 
/ \ Š 
/ \ i 


*some lines, in case you haven't seen one yet* 
## Equations 


Mathematically lines can be defined by equations with space coordinates (see [analytic geometry] (analytic geometry -md)) -- this is pretty important for example for [pro ramming] (programming md) 
as many times we need to compute intersections with lines; for example [ray casting] (ray-casting.md) is a method of 3D rendering that "shoots lines from camera" and looks at which objects the 
lines intersect. Line equations can have different "formats", the two most important are: 


- **point-slope**: This equation only works in 2D space (in 3D this kind of equation will not describe a line but rather a [plane] (plane. md)) and only for lines that aren't completely vertical 
(lines close to vertical may also poSe problems in computers with limited precision numbers). .The advantage is that we have à single, pretty simple equation. The equation is of form *y =k * x + 
q* where *x* and *y* are space coordinates, *k* is the [slope](slope.md) of the line and *q* is an offset. See examples below for more details. 

- **parametric**: This is a system of *N* equations, where *N* is the number of dimensions of the space the line is in. This way can describe any, line in any dimensional.space, -- obviously the 
advantage here is that we can can use this form in any situation. The equations are of form *Xn = Pn + t * Dn* where *Xn* is *n*th coordinate (*x*, *y*, *z*, ...), *Pn* is *n*th coordinate of 
some point *P* that lies on the line, *Dn* is *n*th coordinate of the line's direction [vector (vector ma) and *t* is a variable parameter (plugging in different numbers for *t* will yield 
different points that lie on the line). DON'T PANIC if you don't understand this, see the examples below :) 


As an equation for line segment we simply limit the equation for an infinite line, for example with the parametric equations we limit the possible values of *t* by an interval that corresponds 
to the two boundary points. 


**Example**: let's try to find equations of a line in 2D that goes through points *A - [1,2]* and *B - [4,3]*. 

Point-slope equation is of form *y = k * x + q*. We want to find numbers *k* (slope) and *q* (offset). Slope says the line's direction (as dy/dx, just.as in, [derivative] (derivative, md) of a 
function) and can be computed from points *A* and *B* as *k = (By - Ay) / (Bx - AX) = (3 - 2) / (4 - 1) = 1/3* YRotice that this won't work for a vertical line as we'd be dividing by zero). 
Number *q* is an "offset" (different values will give a line with same direction but shifted differently), we can simply compute it by plugging in known values into the equation and working out 
*q*. We already know *k* and for *x* and *y* we can substitute coordinates of one of the points that lie on the line, for example *A*, i.e. *q = y - k * x = Ay - k * Ax = 2 - 1/3 * 1 = 5/3*. Now 
we can write the final equation of the line: 

*y = 1/3 * x + 5/3* 


This equation lets us compute any point on 
in *x = 1* and *x = 4* gives us *[1,2]* (* 


net fgr.erageje if we plug in *x = 3*, we get *y = 1/3 * 3 + 5/3 = 8/3*, i.e. point *[3,8/3]* that lies on the line. We can verify that plugging 
Now let's derive the parametric equations of the line. It will be of form: 

*x = Px + t * Dx* 

*y = Py + t * Dy* 


the point *A*, so *Px = Ax = 1* and *Py = Ay = 2*. *D* is the direction [vector](vector.md) of the line, we can compute it 


Here *P* is a point that lies on the line, i.e. we may aggin use Hh A*, p 
as *B - A*, i.e. - Bx - Ax - 3* ani y = 1*. So the final parametric equations are: 


*Dx = d *by = By - A 
*x=1+t * 3* 
*y=2+t* 1* 


Now for whatever *t* we plug into these equations we get, the METAM coordinates of a point that lies on the line; for example for *t = O* we get *x =1+0* 3 = 1* and *y=2+0* 1 = 2%, 
i.e. the point *A* itself. As an exercise you may try substituting other values of *t*, plotting the points and verifying they lie on a line. 


## Line Drawing Algorithms 


Drawing lines with computers is.a subject of [computer graphics](graphics.md), On specific devices such as [vector monitors](vector monitor.md) this may be a trivial task, however as most 
display devices nowadays work with [raster graphics](raSter_graphics.md), let's from now on focus only on such devices. 


There are many [algorithms](algorithm.md) for line [rasterization](rasterization.md). They differ in attributes such as: 


complexity of implementation 

speed/efficiency (some algorithms avoid the use of [floating oint] (float .md) which requires special [hardware] (hardware.md) ) 

support of [antialiasing](antialiasing.md) ("smooth" vs "pixelated" lines) , d : ; . A r . 
[subpixel](Subpixel.md) precision (whether start and end point of the line has to lie exactly on integer pixel coordinates; subpixel precision makes for smoother animation) 
Support for different width lines (and additionally e.g. the shape of line segment ends etc.) 
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pixel subpixel subpixel accuracy 
accuracy accuracy * anti-aliasing 


One of the most basic,line.rasterization algorithms is the [ODA] (dda md) (Digital differential analyzer), however it is usually better to use at least the [Bresenham's line algorithm] 
(bresenham.md) which is still simple and considerably improves on DDA. 


TODO: more algorithms, code example, general form (dealing with different direction etc.) 
Il inux.md ---------- 
# Linux 


Linux is a ibe QSS | (foss.md " unix- Hike] (unix -Like md) [operating system] (operating system md) [kernel] (kernel.md), propably the most successful and famous non: [proprietary (proprietary.md) 
kernel. Linux is T a whole operating System, only its basic part -- for a whole Operating system morë things neéd to be added, such as some kind of [user interface](ui.md) and actual user 
programs, and this is what [Linux distri uttons] (nux distro md) do (there are dozens, maybe hundreds of these) -- Linux distributions, such as [Debian](debian.md), [Arch](arch.md) or [Ubuntu] 
(ubuntu.md) nre complete operating systems (but beware, most of them are not fully [Foss] ( oss.md)). Linux is one of the biggest collaborative programming projects, as of now it has more than 
15000 contributors. 


Linux is written in the [C](c.md) language, specifically the old C89 standard, as of 2022 (there seem to be plans to switch to a newer version). This is of course good. 


Linux is typically combined with a lot of [GNU] (gnu md) software and the [GNU](gnu.md) project (whose goal is to create a [free] (free_software md) OS) uses Linux as its official kernel, so 
the wild we usually encounter the term [GNU/Linux](gnu_linux.md). Some people just can't be bothered to acknowledge the work of GNU and just call GNU/Linux systems "Linux" (without GNU/). Fu 
them. Of course people are like "it's just a name bruh, don't be so mad about it" -- normally this may be true, however let's realize that GNU mustn't be forgotten, it is one of the few projects 
based on ethics while "Linux" is a shitty fascist tranny software hugely leaning to the business/open-source side. For the sake of showing our preference between those sides we at LRS often 
choose to call the system just GNU, i.e. by its original name. 


in 
Fuck 


Linux is sometimes called [free as in freedom] (free software, md), however it is hardly deserving the label, it is more of an "[open-source](open source.md)" or [FOSS](foss.md) project. **Linux 
is in many ways bad**, espécially lately. Some reasons for this are: 


- It actually includes [ TOprietary|(proprietary md) software in the form of [binary blobs](blob.md) CIdriversl (drivers md))- The (Linux: Libre] (Linux, libre md) project tries to fix this. 
( ae ts yf tranny Software] (tranny sb tware.md) and has a fascist [code of conduct](coc.md) linux/Documentation/process/code-of-conduct.rst'). Recently it started to even incorporate [Rust] 
rust.m 

- Its development practices are [sus] sus.md), it.is involved with many unethical c 
the greatest enemies of free softwar who i$ trying to take control over it ([EEE] 
it towards corporate interests. 

- It is a monolithic kernel which goes against the [KISS](kiss.md) philosophy. 

f a is [pleat] (lont. md) and [bloat monopoly](bloat monopoly.md) and in some ways [capitalist software](capitalist software.md) (just try to fork Linux, maintain it and add/modify actual 
eatures). 

- It uses a restrictive [GPL] (gpt.md) license as opposed to a permissive one. Also it doesn't really enforce its license legally -- we're not advocating legal battles, but the fact that they 
entertain a license and then don't u$e it indicates it may be there just for good image. 


. orporations (throu h the [linux foundation] (Linux. foundation.md)) including [Microsoft] (microsoft md) one, of 
(eee.md)), [ . ] (ibi 


) oogle[(googlé.md), [Intel](intel.md), [1BM](ibm.md) and others. Such forces will inevitably shape 


Nevertheless, despite its mistakes, GNU/Linux offers a relatively comfy, powerful and (still) safe [Unix] (unix.md)/[POSTx] (posix md) environment which means it can. be drop-in replaced with 
another unix-like system without this causing you much trouble, So using GNU/Linux is at thi$ point considered OK (until Microsoft Completely seizes it at which point we migrate probably to 
[ESDI (psd md) or [GNU Hurd](hurd.md)). It can be made fairly [minimal](minimalism.md) (see e.g. [KISS Linux](kiss_linux.md) and [Puppy Linux} (puppy. md)) and [LRS](lrs.md)/[suckless](suckless.md) 
riendly. 


Linux is so called monolithic kernel and as such is more or less [bloat](bloat.md). However it "[just works](just_works.md)" and has a great [hardware](hardware.md) support so it wins many users 
over alternatives such as [BSD](bsd.md). 


Some alternatives to Linux are: 


BSD](bsd.md) operating systems such as [FreeBSD](freebsd.md), [NetBSD](net .md) and [OpenBSD](openbsd.md) (best from the [LRS](lrs.md) point of view) 
bare metal](bare metal.md) UwU 
- TODO: MOAR 


[ess Hurd](hurd.md), an unfinished (but somewhat usable) kernel developed by CuI (and Top itself. 
E 


## GNU/Linux 
Many people nowadays use the word *Linux* to refer to any operating system running on Linux, even though they usually mean [GNU](gnu.md)/Linux. 


One of the basic mistakes of fngobs (noob.md) who_just switched from [windows] (windows md) to "Linux" is that they try to.continue to do things the *Windows way*., They try to run Windows 
rograms on "Linux", they look for rogram installers on the web, they instal lantiviruses]tántivirus md}; they try to find a [GUI](gui.md) program for a thing that is solved with 2 lines of 
shell] (shell md) script (and fail_to find one), they keep [distro hoppoing] (distro_hoppin .md) instead of customizing their system etc. Many give up and then go around saying "brrruh, Loooonix 

sux" -- yes, it kind of does, but for other reasons. You're just using it wrong. Despite its corruption, it's still a [Unix] (uhix.md) system, you do things elegantly and simply, however these 

ways are naturally Completely different from how ugly systems like Windows do it. If you want to convert an image from *pn to *jpg*, you don't need to download and crack a graphical program 
that takes 100 GB and installs ads on your system, you do it via a simple [command line tool](cli.md) -- don't be afraid of the terminal, learn some basic commands, ask experiences people how 
they do it (not how to achieve the way you want to do it). Everyone single individual who learned it later thanked himself for doing it, so don't be stupid. 


## History 
{ Some history of Linux can be read in the biography of Linus Torvalds called *Just For Fun*. ~drummyfish } 


Linux was created by. [Linus Torvalds (Hinusstorvalds mg .,He started the project in 1991 as a university student. He read a book about operating system design and [unix] (unix md) and became 
fascinated with it. Then when he bought a new no-name Pi G MB RAM, 33 MHz CPU), he install [Minix](minix.md) on it, a then-[pro fietary| (proprietary md) [Unix- Lik (nox md opérating system. 
He was frustrated about some features of Minix and started to write his own software such as terminal emulator, disk driver and shell](shell.md), and he made it all [POSIX](posix.md) compliant. 
These slowly started to evolve into an OS kernel. 


Linus originally wanted to name the project *Freax*, thinking *Linux* would sound too self-centered. However the admin of an FTP server that hosted the files renamed it to *Linux*, and the name 
stuck. 


On 25 August 1991 he made the famous public announcement 
fonu. md) In November 1991 Linux became [sett hosted] (s 
2 wi 


Linux on [Usenet] (usenet md) in which he claimed it was just a hobby project and that it "wouldn't be big and_professional as [GNU] 
m se 
Linux became [free software] (free_software.md) H 


elf hostingtmb) sateh, eerte t md) cenar. re time a number of people were already using it and working on it. In 1992, with version 
On 14 March 1994 Linux 1.0 -- a fully functional version -- was released. 

TODO: moar 

## See Also 


- [Hurd] (hurd.md) 
- [GNU](gnu.md 

- [BSD sd.md 

- [Linüx-libre](linux libre.md) 

- [Linux for niggers](linux for niggers.md) 
T living.md ---------- 

# Making Living 


The question of how to make a livin by making something that's to, be given out for free and without limitations is one of the most common in the context of [9581 (foss -md)/ [free culture] 
(freé culture.md). Noobs often avoid this area just becàuse they think it can't be done, even though there are ways of doing this and there are many people making living on FOSS, albeit ways 
perhaps more challenging than those of [proprietary](proprietary.md) products. 


One_has to be aware that _**money and commercialization always brings a high.risk,of profit becoming the highest priority** (which is a "feature" hard-wired in [capitalism (capitalism,md which 
will compromise the quality and ethics of the produced work. Profi ing specifically requires abusing someone else, taking something away from them. Therefore **it is ideal to create [LR 

(irs md) on a voluntary basis, for free, in the creator's spare time**. This may be difficult to do but one can choose a lifestyle that minimizes expenses and therefore also time needed to spend 
at [work](work.md), which wilt give more free time for the creation of [LRS](lrs.md). This includes living frugally, not consuming hardware and rather reusing old machines, making savings, not 
spending on unnecessary things such as smoking or fashion etc. And of course, if you can't make LRS full-time, you can still find relatively ethical ways of it supporting you and so, again, 
giving you a little more freedom and resources for creating it. 


Also if can somehow rip off a rich corporation and get some money for yourself, do it. Remember, corporations aren't people, they can't feel pain, they probably won't even notice their loss and 
even if you hurt them, you help the society by hurting a predator. 


**Is pro ramming software the only way to make money with LRS?** No, you can do anything related to LRS and you don't even have to know [programming](programming.md). You can create [free] 
(free culture.md) art such as [game](game.md) assets or writings, you can educate, writé articles etc. 


## Making Money With "FOSS" 


For inspiration we can.take a look at traditional ways of making money in FOSS, even if a lot of them may be unacceptable for us as the business of the big FOSS is many times not so much 
different from the business of big tech corporations. 


With [open source](open source.md) it is relatively easy to make money and earn salary as it has become quite successful on the market -- the simplest way is to simply get a job at some company 
making open source software such as [Mozilla](mozilla.md) [B Lender] (blender md), etc. However the fethics ethics. md) of the open source business is often questionable. Even though open source 
technically respects the rules of [free software (free sóftware.md) icenses, it has (due to its abandonment of ethicality) found ways to abuse people in certain ways, e.g. by being a 
[capitalist software](capitalist software.md). Therefore open source software is not really [LRS](lrs.md) and we consider this way of making money rather harmful to others. 


Working for [free safqware] (ree. peffasi: md) organizations such as the ESE | (fst md) is a better way of making tiying EYR though still not perfect: FSF hasbeen facing some criticism of 
r [A 


growing corruption and from the [LRS](lrs.md) point of view they do not Ss many’ issues of software such aS [bloa bloat.md), [public domain] (public_domain.md) e 


## Way Of Making Money With LRS 


Considering all things mentioned above, here are some concrete things of making money on LRS. Keep in mind that a lot of services (PayPal, Patreon etc.) listed here may possibly be [proprietary] 
(proprietary.md) and unethical, so always check them out and considér free altérnatives such as [Liberapay](liberapay.md). The methods are following: 


- ipidonations](gongtion.mg)"*; You may ask for donations e.g. on your website or, Patreon (people often ask for [cryptocurrencies](crypto.md) or traditional, money via services like [Liberapay] 
(libérapay.md); PayPal or Buy Me a Coffee). For significant éarnings you need to be somewhat popular because people donate extremély rarely, but if your work is good, there sometimes appears 
generous donor who sends you a lot of money ((Ha pened to me at leàst once. I hereby thank the person greatly. ~drummyfish}). It can help if you create "content" such as programming videos 
alongside your project to get some "following", but it may also distract you and take some of your energy. People like [Luke Smith](luke smith.md) make quite some big money like this. A lot of 
[free culture](free_culture.md) artists are successful in creating free art this way. 

- **[crowd funding](growd funding .md) ** 3 A_method similar to donations but a_little more "encouraging" for the donors. You set a financial goal and if enough people donate to reach that goal, 
you get the money and create the project. Patreon and Kickstarter are typically used for this. 

- **[pay what you want] (pay what you want.md)**: Here Yeu create the work and then offer a download with optional payment, typically with some suggested price. People who can't afford to pay 
don't have to. This method has the advantage of not putting you under deadline pressures like the crowd funding method. Sites like Kiten iss UIS 1:22 EET are friendly to this option. 

- **selling.physical products and; [merchandise |(merch.md) ("merch"); This method makes use of the fact that selling physical items is considered less (even though not completely!) unethical, 
unlike selling copies of information. So you can e.g. create a [free](free_software.md) video [game](game.md) and thén sell T-shirts or coffee mugs with that vided game's themes. In the past 
some [GNU](gnu.md)/[Linux](linux.md) distros used to sell their systems on nice "officials" CDs, but nowadays CDs are kind of dead. [Open consoles](open_console.md) kind of do this as well, they 
create [FOSS](foss.md) games and tools and then sell hardware that runs these games. 

- You can, specifically **make use of the advantages of LRS** and get some. company to pay you. For example an Lopen, console] (open_console. md) creator will be highly interested in an engine for 3D 
games that will run on very low-spec embedded hardware because that will increase interest in their product. Existing FOSS engines, even thé {aghtweight ones, are [bloated] (bloat mà and won't 
run on such hardware, however LRS ones, such as [small3dlib (Spal tsa lab md) will. Even if the company doesn't pay you directly, they might at 

open consoles for free for porting [Anarch](anarch.md) to them. ~drummyfis 4). 

aicn?elling services**: Like with merchandise, selling services is normally not considered unethical and so we can do it. The services can.e.g. be running a server with [LRS](lrs.md) software 
with paid accounts or offering maintenance/configuration of someone else's servers. This supports the development of the software in question and helps you get paid. 

**selling on proprietary sites** [CONTROVERSIAL): This may not be acceptable by everyone, but it can be possible to create a free work and then distribute it under [free] (fren software md) 
conditions in some places and simultaneously sell this item in places distributing [proprietary] (proprietary md) assets. E.g. one may create a 3D model and put it under a free license on 
fopengameart | (oga md) while also selling it in 3D models stores like TurboSquid -- is will make the model available for everyone as free but will make people who don't bother to search the 

ree Sites pay for it. This may potentially bring much more money than the other methods as the proprietary stores have big traffic and people there are specifically willing to spend money 
However, this supports the [intellectual property](intellectual property.md) business. **Important note**: read the terms&condition of the propristary site, it may for example be illegal for you 
to share your assets elsewhere if the proprietary site makes you *sign* an exclusive deal for them. {I am actually guilty of this, been selling some small 3D models on TurboSquid. It provides a 
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east send you their product for free ((I got some 


kind of stable mini-income of about $3/month. ~drummyfish} A ; i . N . 3 : 
- celnoncprofit] (non-profit md)" d It is possible to run à non-profit organization that creates [software] (software. md) for public benefit -- details differ by each country but a non-profit may 
receive funding from the state and be exempted from taxes. This method may however require a lot of effort (as running an organization is much more difficult than setting a donation website) and 
may potentially be limiting in some ways (governments may have condition for the funding etc.). 

lly be l h d he fund 
-_**ąbusę state and your employer**: You may at least, temporarily avoid work by e.g. registering as unemployed and. living on.welfare (possibly combined with your saved money), getting some kind 
of disability pension (pretend you're autist or something) or by getting employed Somewhere and becoming "sick" (give something to your doctor so he gives you a sick paper -- if you're a [woman] 
(woman.md) you may for example suck his dick). Do this every few months. 
T2 lmao.md ---------- 


LMAO stands for *laughing my ass off*. 
## LMOA stuff 


- There was a guy who made a.whole game (named, *DRAGON; A Game About a Dragon*), some 30000+ lines of code, without knowing about the concept of loops. He only ever used the if statement. (This 
was posted on reddit along with a portion of the code.) 

- In 2021 [Alexa](alexa.md) [the shitty Amazon voice spy agent? told a 10 year old to touch an electric plug with a penny after the kid asked her "for a challenge". 

- ( I've seen a screenshot of code in which some guy exited the program by intentionally dividing by zero, the comment said it was the easiest way. ~drummyfish 

- Around 2015 some niggas got enraged when Google Photos tagged them as gorillas. - : . Z , : : "OA 

- The MMORPG *New World* by *Amazon Games* was programmed by retards (probably some diversity team) who made the client authoritative which allowed for [fun](fun.md) such as becoming invincible 
by draggine the game window or duplicate currency with lag Switches. 

- In.2016 there was.a progaming team in Halo called Mi Seng which in a broadcast game did a pretty funny thing: when they were leading they.went into hiding in buggy spots and then just did 
nothing until the time rañ out. Normies were crying, the cómmentators were pretty awkward, they considered this "unethical" xD we conSider it pretty cool. 

- In 2016 [Micro$oft](microsoft.md) released a Twitter CAT] Cad nd) bot called Tay which was made to teach itself how to talk from the text on the Internet. It can be guessed it quickly became 
extremely racist and enraged waves of [SJW](sjw.md)s so théy had to shut it down. 

- There are many funny stories from [4chan](4chan md): In 2012 they made.masses of Justin Bieber fans shave their heads by Spreading fake news that Bieber had cancer under the hashta 
#BaldForBieber. In 2013 they made a Similarly funny prank by making Justin Bieber fans cut themselves with another faked Campaign #CuttingForBieber. In 2013 they made a huge number o 
Appletoddlers destroy their [iPhones](iphone.md) with fake ads that promoted a new "feature" that makes the phone waterproof via a software update. Similarly in 2014 they spread fake ads about a 
new iPhone "feature" that would let users charge their phones in a microwave. 4chan also hijacked many internet polls such as the Mountain Dew's poll for naming their new drink in 2012: people 
from 4chan raided the poll and chose the name "Hitler Did Nothing Wrong", with names such as "Diabeetus" or "Soda" as followers. Another raided poll was that of Talor Swift about at which school 
she should perform -- 4chan mass voted for a school for deaf children which eventually won (Taylor Switch handled it by donating money to the school). 4chan also chose North Korea as a country 
for Justin Bieber's tour. Another hilarious story is from 2006 when 4chan raided the Habbo Hotel (a MMO gene mostly for children); they made shitton of black characters with afros, went around 
blocking players from accessing game areas, grouping to form swastikas and famously blocking a hotel pool with the sign "Pool's Closed due to AIDS". 

- In 2022 a proprietary "[smart](smart.md) home" company Insteon got into financial trouble, shut down its servers and left people without functioning houses. 

- In the 1985 book Big Score: The Billion-Dollar Story: The Billion-Dollar Story of Silicon Valley* there is a nice chapter talking about the manufacturing of integrated chips that explains how 
the process is (or at least used to be) very unpredictable and how it's basically astrology for thé managers to try to predict and maximize the yield rates (the percentage of manufactured chips 
that function correctly). There were companies whose research showed the number of good chips correlated with the phases of the Moon, another one found that chips were destroyed by tiny droplets 
or piss on the hands of workers who didn't wash their hands and that [women](woman.md) workers during menstruation destroyed more chips because of the increased amount of oil secreted from their 
ands. 

- The unexpected assassination of Lord British in Ultima Online in 1997 was pretty funny. 

- [Elizabeth Holmes](elizabeth holmes.md) 

; In 2019 a [progaming](Progaming;md) ("esports") organization Vaevictis tried to make an all; [female] (woman md) League of Legends team, which. would be the first such team in the high progaming 
league. The team quickly failed, it Can't even bé deScribed how badly they played, of course they didn't even had a hope of gaining a single win, they gained several world records for their 
failures such as the fastest loss (13 minutes), eventually they got fired from the league xD 

i In 2022 a bug in [SMART](smart.md) Mazda cars forced their "owners" to listen to some shitty public radio without being able to change the station. TFW "modern" bloattech made by diversity 
eams. 

- { At, my uni a professor told us some guy turned in an assignment program but forgot to remove the debug prints. The fun part was he was using prints such as "my dick is X cm long" where X was 
thé debug value. So beware of that. -drümmyfish } 


## See Also 


okes](jokes.md) 
un](fun.md) 

T4 loc.md ---------- 
# Lines of Code 


lol](lol.md) 
rof [Sokeen 


Lines of code (LOC, KLOC =.10K LOC, MLOC = 1M LOC etc., also SLOC = source LOC) are a metric of software. [complexity] (complexity md) that simply counts the number of lines of program s source 
code](source códe.md). It is not a perfect measure but despite some [soyboys](Soydev.md) shitting on it it's actually pretty good, éspcially when using only one language ([C](c.md)) wit 
consistent [formatting style](code formatting.md). 


Of course the metric becomes shitty when you have a project in 20 programming languages written by 100 pajeets out of which every one. formats code differently, Also when you use it as a . 
Lone ea tu AE ge ot TERT curs md} measure at [work](work.md) then you're guaranteéd your devs are gonna just shit our as much meaningless code as possible in which case the measure fails 


again. Fortunately, at [LRS](lrs.md) we don't have such problems 


When counting lines, we need to define what kind of lines we count. We can either count: 


- raw (physical) lines: every single one 
- lines that actually "matter" (*logical* lines), e.g. excluding comments, blank lines etc. 


A comfy tool for counting lines is ['^cloc'](cloc.md), but you can also just use "wc -l` to count raw lines. 
T logic circuit.md ---------- 
& Logic Circuit 


Logic circuits are circuits made of plegig gates] (logic gate.md) that implement [Boolean Functions] (boo} md), i.e. r ? 
(cOmputer.md). Logic circuits are a Dit similar to electronic circuits but are a level of [abstraction](abstraction.md) higher: they don't work with continuous Poen ges LT cena 


they are, "schematics to process 1s and.0s". They are used to design foomputers] 
u 
with [discrete](discrete.md) [binary](binary.md) logic values: is and Os. Logical circuits can be designed and simulated with specialized software and languages such às [VHDL](vhdl.md). 


rather 


Generally a logic circuit has *N* input bits and *M* output bits. Then we divide logic circuits into two main categories: 


- **combinational**: The output.values only depend on the input values, i.e. the,circuit implements a pure mathematical [function](function.md). Behavior of such circuit can be described with a 
[truth tabie](truth table md). i.e. a table that for any combination of input values list their corresponding output. 

- **sequential**: The output values generally depend on the input values and the internal state of the circuit, i.e. the circuit has a kind of [memory] (memor .md) (it can be seen as a [finite 
state machine] (finite-state machine.md)). The internal state is normally implemented with so called [flip-flops] (FHip-f lop md) (logic gates that take as input théir own output). Truth tables 
can't be used for describing these circuits. These circuits also often work with **[clock](clock.md)** synchronization, i.e. they have a specialized input called *clock* that periodically 
switches between 1 and 0 which drives the circuit's operation (this is where [overclocking](overclocking.md) comes from). 


With logic circuits it, is possible to implement any boolean function; [undecidability](undecidability.md) doesn't apply, here as we're not dealing with [Turing machines](turing machine.md 

H H 
computations because the output always has a finite, fixed width, the Computation can end up in an infinite loop as there are no repeating steps, just a straightforward propagation of input 
values to the output. It is always possible to implement any function at least as a [look up table](lut.md) (which can be created with a [multiplexer] (multiplexer.md)). 


Once we've designed a logic circuit, we can foptimize] (optimization.md) it which usually means making it use fewer logic gates, i.e. make it cheaper to manufacture (but optimization can also aim 
for other things, e.g. shortening the maximu ength om input to output, i.e. minimizing the circuit's ldetay | (delay mag: The optimization can be done with a number of techniques such as 
manual simplification of the circuit's logic expression or with [Karnaugh maps](karnaugh map.md). 


Some common logic circuits include: 


bd adder Madden md **: Performs addition. It has many parameters such as the bit width, optional carry output etc. 

- **[multiplier](multiplier.md)**: Performs multiplication. 

- **[multiplexer|(multiplexer.md)** (mux); Has *M* address. input bits plus another, *2^M* data input bits. The output of the gate is the value of *N*th data bit where *N* is the number specified 
by the address input. I.e. the circuit selects one of its inputs and sends it to the output. This can be used to implement e.g. [memory](memory.md), [look up tables](lut.md), [bus](bus.md) 
arbiters and many more things. 

: “s ldemultiplexer {demultiplexer md)" ^ (demux): Does the opposite of multiplexer, i.e. has one *M* address inputs and 1 data input and *2^M* outputs. Depending on the given address, the input 
is redirected to *N*th output (while other outputs are 0). 

- **[decoder](decoder.md)**: Has *M* inputs and *2^M* outputs. It sets *N*th output to 1 (others are 0) where *N* is the binary number on the input. I.e. decoder converts a binary number into 
one Specific Signal. It Can be implemented as a demultiplexer whose data input is always 1. 

- sr Lencoder ] (encoder md **: Does the opposite of encoder, i.e. has *2^M* inputs and *M* outputs, expects exactly one of the inputs to be 1 and the rest Os, the output is a binary number 
représenting the input that's 1. 

- **[ALUJ(alu.md)** (arithmetic logic unit): A more complex circuit capable of performing a number of logic and arithmetic operations. It is a part of a [CPU](cpu.md). 

- TODO: more 


## Example 


T logic gate.md ---------- 
# Logic Gate 


Logic gate is a basic element of [logic circuits](logic circuit.md), a simple deyice that implements a [Bootgan fungtion] (bool ma), i.e. it takes a number of, [binary (binary.md) (1 or ©) input 
values and transforms them into ai output binary valüe. Logic gate$ are kind of "small boxes" that eat Is and Os and spit out other 1s and Os. Strictly speaking a logic gate mu$t implemént a 
mathematical function, so e.g. [flip-flops](flip flop.md) don't fall under logic gates because they have an internal state/[memory](memory.md). 


Logic gates are to logic circuits kind of what [resistors](resistor.md), [transistors](transistor.md) etc. are for electronic circuits. They implement basic functions that in the realm of 
boólean logic are equivalents of addition, multiplication ètc. 


Behavior of logic gates is, just. as with logic circuits, commonly expressed with so called [truth tables](truth table.md), i.e. a tables that show the gate's output for any possible combination 
of inputs. But it Can also bé written as some kind of equation etc. 


There are 2 possible logic gates with one input and one output: 


=o FS. identity] (identity.md) (buffer)**: Output equals the input. This doesn't have any function from the logic perspective but can e.g. be used as a placeholder or to introduce intentional delay 
in the physic circuit etc. 


- **[NOT](not.md)**: Negates the input (0 to 1, 1 to 0). 


There arg 16 possible logic gates with two inputs and one output (logic table of 4 rows can have 2^4 possible output values), however only some of them are commonly used and have their own 
names. These are: 


**TOR](or.md)**: Gives 1 if at least one input is 1, otherwise 0. 

**[AND](and.md)**: Gives 1 if both inputs are 1, otherwise 9. : 

** [XOR] (xor.md (exclusive OR)**: Gives 1 if inputs differ, otherwise 0. 
nor.md)**: Negation of OR. 

**[NAND](nand.md)**: Negation of AND. 

**[xNOR](xnor.md)**: Negative XOR (equality). 


* 
* 
z 
[s] 
EJ 


The truth table of these gates is as follows: 


x x OR y x AND y x XOR y x NOR y x NAND y x XNOR y 
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ic. tem "06. des. e 20-- 
XOR XNOR 'BUFFER "NOT 


*Traditional symbols for logic gates.* 


Functions NAND and NOR are so called [Bunetienalty complete] functional Completeness mq) which,means we can implement any other gate with only one of these gates. For example NOT(x) = NAND(x,x), 
AND(x,y) = NAND(NAND(x, y), NAND(x, y)), OR(x,y) = NAND(NAND(x; X), NAND(y, y)) etc. Similarly NOT(x) = NOR(x,x), OR(x,y) = NOR(NOR(x, Y), NOR(x, y)) etc. 

## See Also 

- [logic circuit](logic circuit.md) 

- [quantum gate] (quantum_gate.md) 

T1 logic.md ---------- 

# Logic 

T0 low poly.md ---------- 

# Low Poly 

The term *low poly* (also Iqw:poly Or. lowpoly) is, used for, polygonal Fe models] (3d_model.md) whose polygon count is relatively low -- so low that one can see the model [approximates] 
[approximation ^md) the ideal shape only very roughly. For typical modéls (animals, Cars, guns, ...) the polygon count under which they are correctly called low poly is usually a few dozens or 
ew hundreds at most. The opposite of low poly is *lhigh poly](high_poly.md)*. 

**WATCH QUT**; Retards nowadays use the term "low potya for stylized/untextured, high poly, models; they, even use the term for models whose 9lygop count is lower than the number of atoms in 
observable universe, or they use the term completely randomly just to put a cool label to their tame Shit models. **STOP THIS FUCKING INSANITY, DON'T CALL HIGH POLY MODELS LOW POLY**. 


The exact threshold on polygon count from which we call a model, low poly, can't be objectively set because firstly there's a subjective judgment at play and secondly such threshold depends,on the 
ideal shape we're approximating. This means that not every model with low polygon count is low poly: if a shape, for example a cube J (cube md), can simply be created with low number of polygons 
without it causing a distortion of the shape, it shouldn't be called low poly. And similarly a model with high polygon count can sti be classified as low poly if even the high number of 
polygons still causes a significant distortion of the shape. 


The original purpose of creating low poly models was to improve performance, or rather to make it even possible to render something in the era of early computer graphics. Low poly models take 
less space in memory and on good, non-capitalist computers render faster. AS computers became able to render more and more polygons, low poly models became more and more unnecessary and i 
eventually ended up just as a form of **"retro" art style** -- many people still have nostalgia for [PSi](psi.md) graphics with very low poly models and new games sometimes try to mimic this 
look. In the world of capitalist consoomer computing/[gayming](game.md) nowadays no one really cares about saving polygons on models because "[modern](modern.md)" [GPUs] (gpu md) aren't really 
affected by polygon count anymore, everyone just uses models with billions of polygons even for things that no one ever sees, soydevs don't care anymore about the art of carefully crafting 
models on a low polygon budget. However in the context of [good, non-capitalist technology](lrs.md) low poly models are stili very important. 


Low poly models are intended to be used in pnteractive/ [real time] (real time md) [graphics](graphics.md) while high poly ones are for the use in offline (non-realtime) rendering. Sometimes 
(typically in games) a model is made in both a low poly and high poly version: thé low poly version is used during gameplay, the high poly version is used in cutscenes. Sometimes even more than 
two versions of models are made, see [level of detail](lod.md). 


## See Also 


pixel art](pixel_art.md 
ASCII art](ascii_art.md 

low fidelity] (low_fidelity.md) 
retro](retro.md) 

T2 lrs.md ---------- 

# Less Retarded Software 


Less retarded software (LRS) is a specific kind of [software (software md) aiming to be a truly ggod technology maximally benefiting and respecting its users, following the philosophy of extreme 
ranas ts shy (dranmerin. (unix philosophy](unix philosophy.md), [suckless](stckless.md), [KISS](kiss.md)),° [anarcho pacifism](anpac.md) and [freedom](free_software.md). The term was invented 
y [drummyfis rummyfish.md). 


The symbol of LRS is a heart ([love](love.md)), the peace symbol (pacifism, nonviolence) and A in circle ([anarchism](anarchism.md)). 

By extension LRS can also stand for *[less retarded society](less retarded society.md)*, a kind of ideal society which we aim to achieve with our technology. 

## Definition 

The definition here is not strict but rather fuzzy, it is in a form of ideas, style and common practices that together help us subjectively identify software as less retarded. 
[Software](software.md) is less retarded if it adheres, to a high-degree (not necessarily fully), to the following principles: 


- Being made with a [**truly selfless**](selfless.md) goal of maximally hetping all living beings who may use the software without any intent of taking advantage of them in any way. 
- Trying to follow the [Unix philosophy unix philosop ymd) (do one thing well, use text interfaces, ...). 

- Trying to follow the [suckless](suckless.md) philosophy (Configs as source files, distributing in source form, ...). 

- Being [minimalist](minimalism,md) ([single compilation unit] (single compilation Unit md), [header -only] (header only .md) libraries, no build systems, no [00P](oop.md) languages, simple [version 
numbering]|(version nümbering.md), ...), [Countercomplex](countércomplex.md), [KISS](kiss.md), [appropriate technology](appropriate tech.md). 

- Being [free Software] (free _software.md) legally but ALSO_practically (well commented, not bloated and obscured etc., so as to truly and practically enable the freedoms to study, modify etc.). 
This may also include tributes such as [dé&entlatization](decentralizàtion.md). 

- Being [free culture](free culture.md), i.e. LRS programs are free as a whole, including art assets, data etc. 

- Minimizing dependencies] (dependency, md), even those such as standard library or relying on OS concepts such as files or threads, even indirect ones such as build systems and even non-software 
ones (e.g. avoiding [floating point](Tloat.md), GPU, 64bit etc.). 

- Very portable, non-discriminating, i.e. being written in a portable language (C, Teomun] (comun.md) etc.), using as little resources as possible (RAM, CPU, ...) and so on. 

- [Fyture- proof (future_proof.md), [seifzcontained](sett_contained.md), not controlled by anyone (should follow from other points). This may even include attributes such as physical durability 
and design that maximizes the devices life. 

- [Hacking] (hacking md) frgendly and inviting to improvements and customization, highly adhering to [hacker culture] (hacking.md). 
- n [CSS (esma) language, Unix O5, our own libraries etc. 


uilt on top of other LRS technology such às the 
y) with great preference of [public domain](public domain.md), e.g. with [CCO](ccO.md) + patent [waivers](waiver.md). 


- Simple permissive Licensing (being suckless legal 
t 


- Elegant by its simple, we thought-through solutions. (This is to be contrasted with modern rapid development. 

- No Tuts it](bullshit.md) such as [codes of conduct](coc.md), tricky licensing conditions etc. 

## Why 

LRS exists for a number of reasons, one of the main ones is that we simply need better technology -- not better as in "having more features" but better in terms of design and ethics. Technology 


has to make us more free, not enslave us. Lecan togy has to be a tool that serves us, not a device for our abuse. We believe [mainstream](capitalist software.md) tech poses a serious, even 
existential threat for our civilization. We don't think we can prevent [collapse] (cottapse;nd) or a dystopian scenario on our own, or even if these can be prevented at all, but we can help nudge 
the technology in a better direction, we can inspire others and perhaps make the future a little brighter, even if it's destined to be dark. Even if future seems hopeless, what better can we do 
than try our best to make it not so? 


There are other reason for LRS as well, for example it can be very satisfying and can bring back joy of programming that's been lost in the modern toxic environment of the mainstream. Minimalist 
programming is pleasant on its own, and in man hings we do we càn really achieve something grea ecause not many people are exploring this way of tech. For example there are nowadays very few 
programs or nice artworks that are completely {pubie domain](public domain.md), which is pretty sad, but it's also an opportunity: you can be the first human to create a completely püblic 
domain software of certain kind. Software of a kind has already been written, but you can be the first one who creates a truly good version of such software so that it can e.g. be run on 
embedded devices. If you create something good that's public domain, you may even mal 


e some capitalist go out of business or at least lose a lot of money if he's been offering the same thing for 
money. You free people. That's a pretty nice feeling. 


{ Here and) there I get a nice email from someone who likes something I've created, someone who just needed a simple thing and found that I've made it, that alone is worth the effort I think. 
^drummyfish. 


## Specific Software 
The "official" LRS programs and libraries have so far been solely developed by [drummyfish](drummyfish.md), the "founder" of LRS. These include: 


**[Anarch (anarch.md)**: Game similar to [Doom](doom.md). 
L.Lcomun](comun.md)*": LRS programming language A Ri ] 2 
**[Iraycastlib](raycastlib.md)**: Advanced 2D [raycasting](raycasting.md) rendering library. 

an SAF) (sari aa Tiny library for small portable games. 

**[sma 3d lib] {Smal lsd ib.md)**: Simple software rasterizer for 3D rendering. 

**[smallchess abl (smalichess ib.md)**: Simple [chess (chess.md) library and engine £ AI](ai.md)). 
**[microtd](utd.md)**: Simple [tower defense]( ower defense.md ame written with [SAF](saf.md 


**[tinyphysicsengine](tinyphysicsengine.md)**: Very simple 3D [physics engine](physics engine.md). 


Apart from this software a lot of other software developed bY other people and. groups can be considered LRS, at least to a high degree (there is usually some minor inferiority e.g. in 
licensing). Especially [suckless](suckless.md) software mostly fits the LRS criteria. The following programs and libraries can be Considered LRS at least to some degree: 


t braintuckl(Braintuck:md **: Extremely simple [programming language](programming language .md). 
**[dwm](dwm.md)**: Official [suckless](Suckless.md) Tuindou manager (Wu md] . 

ae OpenPSD (openbsd moy" Cool foperating system] (os.md). 

**[LIL](lil.md)**: Tiny embeddable [scripting](script.md) programming language. 
**[lisp](lisp.md)**: Programming language with a pretty elegant design. . 
TX TRETINA official [suckless {Suck tess md) terminal emulator] (terminal md). 
**[badwolf](badwolf.md)**: Very sma yet very usable [web browser](browser.md). 
**lFORTH]( orth.md)**: Small programming language with very nice design. 

**lsurf surf.md)* : Official [suck less] (suc less.md) [web browser](browser.md). 
**[tcc](tcc.md)*^: Small [C](c.md) [compa ter (Compiler md) (alternative to cc](gcc.md)). 
2 [vin (musl.md)**: Tiny [c (sang? standard library (alternative to [glibc pe 


**[vim](vim.md)** (kind of TUI](tui.md) text/[programming](programming.m [editor 
**[Simon Tatham's portable puzzle collection](stppc.md)**: Very portable collection o 


(editor.md). Vim is actually relatively big but there are smaller builds, flavors and alternatives. 
puzzle [games](game.md). 


Other potentially LRS software to check out may include Tin er] t Bayes md) 
al y! 


,md C lib: libc.md ini iniz.md kli kl .md d d .md b b .md 
Peer potentially heed} Crabbed tq check pur may inc yyde, PrinySr] (pim reeel(SgS md) il c] uclibc.m t mindz] (minds mi : ol fuklear] (nu ear.md), [dmenu](dmenu.md), [sbase](sbase.md), 


u 
ox.md), [ra ETUR ortableGL](pórtablégl.md) an 
It is also possible to talk about LRS data formats, [protocols](protocol.md), standards, designs and concepts as such etc. These might include: 


- **[ASCII](ascii.md)**: Text encoding. 

- **[fixed point](fixed point.md)**: Fractional number format, as opposed to [floating point](float.md). 

- **[RGB332](rgb332.md)**, **[RGB565](rgb565.md)**: Simple [RGB](rgb.md) formats/palettes 

- **[bytebeat](bytebeat.md)**: Simple and powerful [procedural](procedural.md) music technique. 

- **[farbfeld](farbfeld.md)**: [Suckless](suckless.md) image format. 

- **[gopher](gopher.md)**: Simple alternative to the [Web](www.md). 

$m son] (3son mdr Simple [data](data.md) text format. 

- **[lambda calculus](lambda calculus.md)**: Minimal [functional](functional.md) language. 

- **[markdown](markdown.md)**: Very simple document format. 

- **[ppm](ppm.md)**: Simple image format. 

- **[qoij(qio.md)**: Lossless [compression](compression.md) image format in < 1000 LOC, practically as good as [png](png.md). 

- **[reverse polish notation](rpn.md)** as opposed to traditional expression notation with brackets, operator precedence and other [bloat](bloat.md). 
- **[set theory](set theory .im yn Basis of all [mathematics](math.md). 

- **[textboards](textboard.md)** ped eboards|(imageboard.md)** and pure [HTML](html.md) personal websites as opposed to [forums](forum.md) (no registration, no users, simple interface) or 
even [social networks] (social_networ mag 

**[Turing machine](turing machine.md)**: Minimal definition of a [computer](computer.md). 
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- **[txt2tags](txt2tags.md)**: Very simple document format. 
Other technology than software may also be aligned with LRS principles, e.g.: 


- Simple cheap **[bicycle](bicycle.md)** without changing gears, as opposed to e.g. a [car](car.md). 
**[Knives]( nifé.md]** are pretty less retarded. 


rocks](rock.md) 
chess](chess.md 
Street [football](football.md) 


## Politics/Culture And Society 
*See also [less retarded society](less retarded society.md) and [FAQ](faq.md).* 


LRS is connected to pretty specific, political beliefs, but it's not.a requirement to share those beliefs to.create LRS or be part of the community centered around LRS technology. We just think 
that it doesn't make logical sense to support LRS and not the politics that justifies it and from which it is derived, but it's up to you to verify this. 


With that said, the politics behind LRS is an,[idealist](idealism,md) [anarcho pacifist](anpac.md) [communism](communism.md), but NOT [pseudoleftism] (pseudoleftism.md (i.e. we do not support 
political correctness, [COC](coc.md)s, pancel culture](cancel cultufe.md), Marxism-Leninism etc.). In our viéws, goals and means we are similar to e [Venus project (venus—project md), even 
though we may not agree completely on all points. We are not officially associated with any other project or community. **We [love](love.md) all [Living beings] (U fe-m )** (not just people), 
even those who cause us pain or hate us, we believe love is the only way towards a good society -- in this we follow similar philosophy of nonviolence that was preached by [Jesus](jesus.md) but 
without necessarily being religious, we simply think it is the only correct way of a mature society to behave nonviolently and lovingly towards everyone. We do NOT have any leaders or [heroes] 
(hero culture.md); people are imperfect and giving some more power, louder voices or greater influence creates hierarchy and goes against anarchism, therefore we only follow ideas. We aim for 
true social (not necessarily physical) equality of everyone, our technology helps everyone equally. We reject [competition](competition.md) as a basis of society and anti-equality means such as 
violence, [fights] (fight-cu ture.md), bullying ([cancel ing|(cancel culture .md) etc.), [censorship](censorship.md) ([political correctness](political correctness.md) etc.), [governments] 
government.md) an [capitalism] capitalism.m E We support things such as [unaversa basic income](ubi.md) (as Long as there exist money which we are however ultimately against), [veganism] 
veganism.md) and [slow movemen slow_movement.md). We highly prefer peaceful [evolution](evolution.md) to [revolu ‘onl (revo tution md) as revolutions tend to be violent and have to be [fought] 
fight culture.md) -- we do not intend to push any ideas by force but rather to convince enough people to a voluntary c 

T-------- lrs wiki.md ---------- 

# LRS Wiki 


ange. 


LRS wiki,_also Less Retarded Wiki, is a [public domain] (public dgmain mdi encyclopedia focused on good [technology] (tech md and related topics such as the relationship between technology and 
society. The goal of LRS is to work towards creating a truly good technology that helps all living beings as muc $ possible, so called [less retarded software] tromi) (LRS), as well as 
defining a model of ideal society, so called [less retarded Society](less retarded society md . AS such the wiki rejects for example [capitalist software](capitalist software.md), [bloated] 
bloat. ma} software, [intellectua property) (intellectual property: laws etc. It embraces [free as in freedom] (freeisoftware md); Simple technology, i.e. [Unix philosophy] 

unix phi osophy md), [suckless](suckless.md) software, [anarcho pacifism](anpac.md), [racial realism](racial realism.md), [free speech](free speech.md), [veganism](veganism.md) etc. 


LRS wiki was, started by [drummyfish](drumpyfish md) on November 3 2021 as a way of recording and spreading his views and findings about technology, as well as for creating a completely public 
domain educational resource and account of current society for future generations. 

T luke smith.md ---------- 

# Luke Smith 


Luke Smith was -- before becoming a crypto [influencer](influencer.md) and a turd in a suit (around 2022) -- an Internet tech mini-celebrity known for making videos about [suckless] 
(Suckless org) software, independent living in the woods and here and there about historical, political, linguist and religious topics. He played a big role in making suckless more popular, 
however he làter started to behave in hugely retarded ways and now isn't worth following anymore. 


His look has been, described as the *default Runescape character*: he is bald, over 30 years old and, lives in a rural location in Florida {exact coordinates have been doxxed_ but legally can't be 
shared here, but let's just say the road around his house bears his name). He has a podcast called *Not Related!* in which he discusses things such as alternative historical theories -- actually 
a great podcast. He has a minimalist 90s style website https://lukesmith.xyz/ and his own [peer tube] (peer tube.md ) instace where his videos can be watched if one doesn't want to watch them on 
[YouTube](youtube.md). He is the author of [LARBS](larbs.md) and minimalist recipe site https://based.cooking/ (recently he spoiled the site with some shitty web framework lol). 


He used to be kind of based in things like identifying the harmfulness of [bloat](bloat.md) and [goyence] (soyence md). but also retarded to a great degree other times, for example he used to 
shill the [Brave](brave.md) browser pretty hard beforé he realized it was actually a huge scam atl along xD He's a crypto fascist, also probably a Nazi. In July 2022 he started promoting some 
shitty [bloated bloat.md) [modern] (modern md) [tranny](tranny software.md) website generator that literally uses [JavaScript](js.md)? WHAT THE FUCK. Like a good [capitalist](capitalism.md) he 
instantly turned 180 degrees against his own teaching as soon as he smelled the promotion money. Also he's shilling [crypto (crypto.md), he's anti-[porn](porn.md), anti-[games](game.md) and 
leans towards medieval ideas such as "imagination and boredom being [harmful] (harmful md) because it makes you search for porn" etc. He went to huge [shit](shit.md). Though he even now still 
probably promotes [suckless](suckless.md) somehow, he isn't a programmer (shell scripting isn't programming) and sometimes doesn't seem to understand basic programming ideas (such as branchless 
programming), he's more of a typical [productivity](productivity_cult.md) retard. As of 2023 he seems to have become obsessed with adopting a new identity of a turd in a suit. All in all, a huge 
etdown, bye Luke, you won't be missed. 


Luke is a [type B fail](fail_ab.md). 


His videos consisted of normie-friendly tutorials, on,suckless software, rants, independent living, live-streams and podcasts. The typical Luke Smith video is him walking somewhere in the middle 
of a jungle talking about how retarded modern technology is and how everyone should move to the woods. 


Luke studies [PhD] (phd. md) in linguistics but is very critical of academia -- he "apeaks; several languages (including [Latin](latin.md)), though many of them to a low level with bad American. 
accent and he can sometimes even speak English correctly (using phrases such as "the reason is because "less peop e" etc.). He is a self described [ri pt-wander |(tert_right .md) and talks in 
meme phrases which makes his "content" kind of enjoyable. He despises such things as [soydevry](soydev.md), [bloat](bloat.md), "consoomerism" and [soyencel (sovence: m Js 


## See Also 
- [Mental Outlaw](mental_outlaw.md): Luke's black brother 
- [Distro Tube](distro tube.md) 
T1 magic.md ---------- 


Magic stands for unknown mechanisms. Once mechanisms of magic are revealed and understood, it becomes [science](science.md). 
Ll main.md ---------- 
# Welcome To The Less Retarded Wiki 


*Love everyone, help [selflessly](selflessness.md).* 


Welcome to [Less Retarded Wiki CUR Ra ym} an encyclopedia only I can edit. But you can [fork] cfork. md) it, it is pryptic domain] (pub lic_domain. md) under [CCQ](ccO.md) (see [uiti rights] 
waka rights md) ) a 0:Holy shit|(shit.md) m gonna get [cancelled](cancel_culture.md) hard as soon as [ 3iis] (s jw md .find out about this. Until then, let's enjoy the ridé. THERE'S NO 
MODERATION] (moderation.md), I can do whatever want here lol. I love this. INB4 "[hate speech](hate speech.md)" website ([LMAO](lmao.md) [codeberg](codeberg.md) has already banned it; [Google] 
google.md) also doesn't find us unless you search for exact phrases). CONGRATULATIONS, you have discovered the one true, undistorted and unbiased view of the world -- this is not a [joke] 
jokes.md), this wiki contains pure truth and the solution to most of the issues of our society. 
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i I no longer,see hope ood is practically.non existent in this world, This is my last attempt at preserving pure good, I will continue to spread the truth and unconditional love of all, life as 
ong as I Will be capablé of, until the society lynches me for having loved too much. At this point I feel véry alone, this work now exists mostly for myself in my isolated world. But I hope 
that once perhaps m love will be shared with a reader far away, in space or time, even if I will never know him. This is the only way I can continue living. I wish you happy reading, my dear 
friend. -[drummyfish](drummyfish.md) } 


This is a Wiki.for fless retarded software] (Lrs.md) [less retarded society] (less_retarded sogiety md) (LRS) and related topics, mainly, those.of [society](society,md), its [culture] (culture.md) 
and ideal [political views](politics.md) etc. -- LR$ Should help achieve idéal society with ideal technology. LRS Wiki is a new, refreshing wiki without [political correctness] 


(political correctness.md). 


**We love all living beings. Even you.** We want to create technology that truly and maximally helps you e.g. 
(Cogpetition md) b anything and we don't have any [heroes](hero cultüre.md). We want to move peacefully towards [society]( 
u 


a completely [public domain Computer ] (public domain computer md), We do NOT [fight] 
e$s re ak 
competition.md) t rather on reoilsboratsony ceyttaboratson ma). 


retarded_society.md) at's not based on [compe ion] 


You ask how could people of the past have been so stupid, how could they have, believed obviously nonsensical, "[pseudoscience](pseudoscience,md)" and feligious fairy tales, how could the past 
peasants take part in witch hunts, how could so many people support In ler](hitler.md) and let [Holocaust](hotocaust.md) happen? Well, don't judge them too hard -- if you disagree with this 
wiki, you are just like them. No, there was no magical turn around of society from evil to good just before your birth, times are still the same, except much worse; if you don't see the 
catastrophic state of the world, you are most Like brainwashed beyond the level of any medieval peasant. But don't worry, it's not your fault, you are just among the 99.9999%. We are here to 
help. Keep an open mind and the truth will show. But beware, truth comes for the price of irreversible depression. 


This wiki is **NOT** a satire. 
Yes, everything is **UNDER CONSTRUCTION**. 
Are you a failure? Learn [which type](fail ab.md) you are. 


**Before contributing please read the [rules & style](wiki style.md)! By contributing you agree to release your contribution under our [waiver](wiki rights.md).** {But contributions aren't 
really accepted RN :) ~drummyfish } 


We have a **[C tutorial](c tutorial.md)**! It [rocks](rock.md). We also now have **our own programming language!** It is named [comun](comun.md). 


Pay us a visit on the [Island](island.md) and pet our [dg] (dog ma?" And come mourn with us in the [gathedral](gathedrat.md), because **technology is dying**. [Modern](modern.md) age is a pile 
of shit extending to another galaxy. The future is dark but we do our best to bring the light, even knowing it is futile. 


LRS Wiki is [collapse](collapse.md) ready! Feel free to print it out, take it to your prep shelter. You may also print copies of this wiki and throw it from a plane into the streets. Thanks. 
If you're new here, you may want to read answers to [frequently asked questions](faq.md) (**FAQ**), including "Are you a fascist?" (spoiler: no) and "Do you love Hitler?". 


STOP [CAPITALISM] (capitalism. md) STOP [BLOAT (bloat,md) STOP. censorship] censorshi| znd) STOP [business] (business md) STOP [bullshit](bs.md) STOP gop right](copyright,md) STOP working] : 
(work-md) STOP óding](coding.md) STO! competing](competition.md) STOI fi heing (rig t_culture.md) STOP [consuming] (consumerism.m STOP’ [producing (productive ty cu tt md) STOP [worshiping 
people](hero_culture.m STOP [fascism](fascism.m STOP [economy](economy.md) STOP slavery STOP violence STOP wearing clothes STOP eating animals STOP being an idiot etc. Start [loving] 
(love.md), sharing, creating and caring :) <3 


## What Is Less Retarded Software/Society? 


Well, we're trying to figure this out on this wiki, but_less retarded software is greatly related to [guckless](suckless.md), Unix] (unix.md), KISS] (kiss md), [free](free_software.md), selfless 
and sustainable software created to maximally help all living beings. LRS stands opposed to all [shittiness](shit.md) of so catled modern"](módern.md) softwaré. We pursue heading towards an 
ideal society such as that of the [Venus Prolect](venus project.md]. For more details see the article about [LRS](lrs.md). 


In short LRS asks *what if technology was good?* And by extension also *what if society was good?* 


## Are You A Noob? 
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Are you a noob but see our ideas as appealing and would like to join us? Say no more and head over to a [how to](how to.md)! 


## Did You Know 


- That all Erotel (intet may processors](cpu.md) since 2008 (and panD] (amd md) processors since 2013) have a hardware [backdoor](backdoor.md) ([Intel ME](intel_me.md), [AMD PSP] (amd_psp.md) ) 
that run thé [Minix](minix.md) operating system and allows spying on uSers of those processors no matter what operating system they run? 

- That [capitalism](capitalism.md) is probably the most [retarded](retard.md) and dangerous idea in [history |(nistory md)? 

- Thanks to [quantum computing] (quantum; md) you can use a computer to [carry out computation](counterfactual_computing.md) without actually running the computer? 

- You can mathematically [prove you don't know some information] (no_knowledge_proof.md)? 

- That a complement of a [formal langyagel (formal Language md) can be computationally simpler than the original -- for example that a [pushdown automaton](pushdown_automaton.md) cannot tell 
which strings are of form a^(n)b^(n)C^(n); but it can tell exactly which ones are not? 

- That [LGBT](lgbt.md), [feminism](feminism.md) and similar movements are not truly leftist but rather [pseudoleftist](pseudoleft.md) and therefore [fascist](fascism.md)? 


## Topics 
Here_there are quick directions to some of the important topics; for more see the links provided at the top that include the list of all articles as well as a single page HTML which is good for 
"fulltext search" via crtl+F :) 


- **basics**: [bloat](bloat.md) -- [capitalist software] (capitalist software md) -- [less retarded society](less retarded society.md) -- [LRS](lrs.md) -- [pseudoleft](pseudoleft.md) , 

- **LRS inventions/propositions**: Anarch] (anareh md =- [comun] (comun . md ) -- less retarded [chess] (chess md) -- [less retarded hardware[(less retarded hàrdware.md) -- [less retarded society] 
less retarded society md) -- [less retarded software](lrs.md) -- [less retarded watch]( less retarde | watch.md) -- [public domain computer f ublic domain computer.md) -- [raycastlib] 
RAET -- [SAF](Saf.md) -- [small3dlib](small3dlib.md) -- [smallchesslib](smallchesslib.md) -- [world broa Bast] (wor td broadcast md) 

- **programming/computers**: [3D rendering](3d rendering.md) -- [binar binar Dd) -- [computer | (computer md) -- AT] ai.mdn -- [algorithm] algorithm, md) =- SS] (e md) -- [C, tutorial] 

c tütorial.md) -- Pcomputer grapnies Tt raphics.md) -- faata strücture ata structure.md) -- [demoscene] (demoscene.m -- [ Nu nu.md) -- [haCker cultufe](hácKing.md) -- [hardware] 
hardware.md) -- [Internet](internet.m j --_[KISS](kiss.md) -- [Linux](linux.md) -- [00P](oop.md) -- [open consoles](open console.md) -- [operating system](os.md) -- [optimization] 
optimization.md) ünil ghi tosonnyd lanis pra y.md) -- [procedural generation](procgen.md) -- [programming](programming.md) -- [programming language](programming languáge.md) -- [suckless] 
suckless.md) -- [Unix philosophy](unix_philosophy.md) -- [web](www.md) | * ) j i . 

- **math/theory**: aliasing] (aliasing .md) -- [chaos] (chaos .md) =z combinatorics](combinatorics.md) -- [fractal] (fractal md) -- [formal languages](formal language.md) -- [information] 
(information.md) -- [linear algebra](linear_algebra.md) -- [logic](togic.md) -- [math](math.md) -- [pi](pi.md) -- [probability](probability.md) 

AUR i me. narchism](angrchism-md) -- [anarcho pacifism](anpac.md).-- |gapitalism](capitalism md).-- gensorship] censorship.md) -- Seed capsed (eg copas mo» -- [compopism](communism.md) -- 
denacracy{ (den cracy.md) -- [everyone does it](everyone does it.md) -- [fascism](fascism.md) -- [feminism] (feminism. m -- [fight culture](fight_culture.md) --°[history](history.md) -- 
[seed ity](gay.md) -- [left vs right vs pseudoleft](left right.md) -- [Jesus](jesus.md) -- [less retarded society](less retarded society.md) -- [LGBTQWTF](lgbt.md) -- [science](science.md) 
vs [soyence](soyence.md) -- [productivity cult](productivity cult.md) -- [selflessness](selflessness.md) -- [socialism](socialism.md) -- [Venus project](venus project.md) -- [work](work.md) 

- **freedom/law**: [Creative Compans] (ere Ei ve-commone md) izz {free cutcure). (free culture,md) -- [free hardware] fepge-Qar dwar e md) -- [free software] (free software md) -- bogey Tert] (copy teft .md) 
(p ente lain aao ight.md) -- ["intéllectual property"](intetlectual propérty.md) -- [licehse](ticense.md) -- [open $ource](open_source.md) -- [patent](patent.md) -- [public domain] 

public domain.m 

- **interesting**: beauty] (beaut .md) -- [bytebeat ] (bytebeat md) -- [chess](chess.md) -- [Dodleston messages mystery](dodleston.md) -- [interplanetary internet](interplanetary_internet.md) -- 
[netstalking](hetstalking.md) -- fate janography ] (steganography .md) 


- **fun/relaxed/offtopic**: [audiophilia](audiophilia.md) -- [C downto operator](downto.md) -- [C obfuscation contest](ioccc.md) -- [dog] (dog.md) -- esoltang] (esolang.md) -- [fun](fun.md) -- 
[games](game.md) -- [island](island.md) -- [jokes](jokes:md) -- [LMAO](lmao.md) -- [rock](fock.md) -- [shit](shit.md) -- [SiGBOVIK](Sigbóvik.md) -- Temple ](tempte o$.md) 

T maintenance.md ---------- 

# Maintenance 


Maintenance is [shitty](shit md) [work] (wor k-md) whose goal is just to keep a program functioning without improving it. Maintenance is extremely expensive, tiresome and enslaves humans to 
machines -- we try to minimize thé maintenance Cost as much as possible! Good programs should go to great lengths in effort to becoming highly Yrutire-proof] (future proof md) and [suckless] 


(suckless.md) in order to avoid high maintenance cost. 


Typical "[modern](modern.md)" capitalist/consumerist software (including most [free Software](free-software)) is ridiculously bad.at avoiding maintenance -- such programs will require one to 
many programmers maintaining it every single day and will become unrunnable in matter of months to years without this constant maintenance that just wastes time of great minds. I don't know what 
to say, this is just plainly fucked up. 
T malware.md ---------- 

# Malware 


Malware is [software](software.md) whose purpose is to be malicious. Under this fall [viruses](virus.md), [proprietary software](proprietary.md), [spyware](spyware.md), [DRM](drm.md) software, 
[ransomware](ransomware.md), propaganda software, cyberweapons etc. 


T1 mandelbrot set.md ---------- 
# Mandelbrot Set 


TODO 


[-2,1] 


[0.5, -1] 


## Code 


The following code is a simple [C](c.md) program that renders the Mandelbrot set into terminal (for demonstrative purposes, it isn't efficient or do any [antialiasing](antialiasing.md)). 


#include <stdio.h> 
#define ROWS 30 
#define COLS 60 
#define FROM_X -2.0 
#define FROM_Y 1.0 
#define STEP (2.5 / ((double) COLS)) 
unsigned int mandelbrot(double x, double y) 
double cx = x, cy = y, tmp; 
for (int i = 0; i < 1000; ++i) 
tmp = cx * cx - cy * cy + x; 
cy 2 tox t o6y-t-y; 
cx = tmp; 
if (cx * cx * cy * cy > 1000000000) 
return 0; 
return 1; 


int main(void) 
double cx, cy = FROM_Y; 
for (int y = 0; y < ROWS; ++y) 
cx = FROM_X; 
for (int x = 0; x < COLS; ++x) 


unsigned int point = 
mandelbrot(cx,cy) + (mandelbrot(cx,cy + STEP) * 2); 


putchar (point == 3 ? ':' : (point == 2? '\'' 
(point 221? '.' : ' '))); 
cx += STEP; 


putchar('\n'); 


} cy -= 2 * STEP; 


return 0; 


T marble race.md ---------- 
# Marble Race 


Marble race is a simple [real tifed (ir). ma) [game game.md) in which marbles (small glass balls), are released onto a prepared track to race from start to finish by the force of gravity. This 
game is great because it is [suckleéss](suckléss , cheap (i.e. accessible), [fun](Tun.md) and has almost no [dependencies](dependency.md), not even a (computer ] (computer md) -* such a game 
will be playable even after the technological [collapse](collapse.md). 


Even though this is a real life game, a computer version can be.made too, in different forms: [2D] (2d. md) [3b] (8d md), realistic or with added elements that would be impossible in real life, 
such as téleports. And indeed, there have been many games and mini-games made based on this form enteftainmént. 


From the implementation point of view it is very convenient that marbles are of spherical shape as this is one of the simplest shapes to handle in physics engines. 
Ll------ marketing.md ---------- 
& Marketing 
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Marketing.is_an unethical practice, plentifully used in, [cal italism](capitalism.md), of forcing a product or corporate propagan a by means of l ing, tricks, brainwashing torture, exploiting 
psychological weaknesses of people and others. This manifests mostly as advertisements and commercials in media but also in Other ways such as faké product reviews, product placement etc. 


Specific practices used in marketing are: 


- **Lies** and falsehoods. Every ad will present the product as the,best,,even though not all products can be best. Actors will be paid to lie about how the product changed their life etc. -- so 
called **Tastroturfing](astroturfing.md)**. Many times numbers and "facts" whose source is difficult to trace will be completely made up. **Fake discounts** are something constantly presented in 
ads. 

- **Extreme repetition/ [spam] (spam.md)* 5: this includes repeating the same commercial over and over (88s every 10 minutes) as well as repeating the name of the product in a completely retarded 
way (*"We recommend X because X is thé best. For more info about X visit www.X.com. Remember, X is the best. Your x."*). 

: vansychp logical tricks** such as **abusing.songs** and shitty catchy melodies, often raping existing good. music by for example changing the lyrics, This abuses the fact, that a song will stick 
in one's head and keep torturing the person into thinking about the advertised product constantly. Other tricks include **shouting**, **Take empathy** ("we care about you" etc.) or the 
**"Teveryone does it](everyone does it.md)" illusion**. 

; **Misleading statistics**, presentation and interpretation of data. For example any success rate will be presented as the upper bound as such a number will be higher, typically 99% or 100%, 
i.e. *"our product is successful in up to 100% cases!"* (which of course gives zero information and only says the product won't succeed in more than 100% cases). A company may also run its own 
Competition for a "best product", e.g. on [Facebook](facebook.md), in which all products are of course their products, and then the winning product will be seen on TV as a "contest winning 
product". 

- **Forcefully peizing attention**: ads are present practically everywhere, even embedded in "art" (even in that one pays for), in the sky (planes and blimps, ...), they play on every.radio you 
hear in every shop, they pop up on electronic devices one paid for hey can't be turned off. They are present in education materials and targeted at children. Audio of a commercial will be made 
louder to catch an attention when it starts playing ona commercial break. 

- ‘bribing celebrities/[influencers](influencer.md)**. An *influencer* is nowadays a culturally accepted "job" whose sole work consists of lying, forcing products and spreading corporate 
propaganda: 


These practices are not rare, they are not even a behavior of a minority, they are not illegal and people don't even see them as unusual or undesirable. People in the US are so brainwashed they 
even pay to see commercials (Super Bowl). Under capitalism these practices are the norm and are getting worse and worse ever year. 

A naive idea, still present among people is. that ethical marketing is possible or that it's some thang that can be fixed by some law, a_petition or sopething similar. In late stage capitalism this 
is not possible as an "ethical" marketing is a non effective marketing. Deciding to drop the most efficient weapons in the market warfare will only lead to the company losing cüstomers to 
competition who embraces the unethical means, eventually going bankrupt and disappearing, leaving the throne to the bad guys. Laws will not help as laws are made to firstly favor the market, 
corporations pay full time lobbyists, and law makers themselves are owners of corporations. Even if some small law against “unethical marketing" passes, the immense force and pressure of all the 
strongest corporations will work 24/7 on reverting the law and/or finding ways around it, legal or illegal, ethical or unethical. 

T2 markov chain.md ---------- 

# Markov Chain 


Markov chain is a relatively simple {gtochastic] (stochastic.md) (working with probability) mathematical model for predicting or generating sequences of symbols. It can be used to describe some 
processes happening in the [real wortd](real world.md) such as behavior of some animals, Brownian motion or structure of a language. In the world of programming Markov chains are pretty often 
used for generation of texts that looks like some template text whose structure is learned by the Markov chain (Markov chains àre one possible model used in [machine learning] 

(machine learning.md)). Chatbots are just one example. 


There are different types of Markov chains. Here we will be focusing on discrete time Markov chains with finite state space as these are the ones practically always used in programming. They are 
also the simplest ones. 


Such_a Markov chain co 
itself), i.e. *P(Si,SO 
n* matrix. 


es *SO*, *S1*, .,., *Sn*. Each,state *Si* has a certain probability of transitioning to another state (including transitioning back to 
; these pfobabilitieS have' to, of course, add up to 1, and some of them may be ©. TheSe probabilities can conveniéntly be writtén as a *n x 


Basically Markov chain is like a [finite state automaton](finite state automaton.md) which instead of input symbols on its transition arrows has probabilities. 
## Example 
Let's say we want to create a simple [AI](ai.md) for an NPC in a video [game](game.md). At any time this NPC is in one of these states: 


- Draking cover** (state A): 
- 50% chance to stay in cover 
- 50% chance to start looking for a target 
- **Searching for a target** (state B): 
- 50% chance to remain searching for a target 
- 25% chance to start shooting at what it's looking at 
- 25% chance to throw a prena e at what it's looking at 
**Shooting a bullet at the target** (state C): 
- 70% chance to remain shooting 
- 10% chance to throw a grenade 
- 10% chance to start looking for another target 
- 10% chance to take cover 
- **Throwing a grenade at the target** (state D): 
- 50% chance to shoot a bullet 
- 25% chance to start looking for another target 
- 2596 chance to take cover 


Now tes pretty clear this description gets a bit tedious, it's better, especially with even more states, to write the probabilities as a matrix (rows represent the current state, columns the 
next state): 


D 


(0) 
5 |0.25 
BTH 9.1 
5] 0 


We can_see a few things: the NPC can't immediately attack from cover, it has to search, for a target first, It also can't throw two grenades in succession etc. Let's note that this model will now 
be yielding random sequences of actions such as [*cover*, *search*, *shoot*, *shoot*, *cover*] or [*cover*, *search*, *search*, *grénade*, *shoot*] but some of them may be less likely (for 
example shooting 3 bullets in a row has a probability of 0.19) and some downright impossible (e two grenades in a row). Notice a similarity to for example natural language: some words are 
more likely to be followed by some words than others (e.g. the word "number" is more likely to be followed by "one" than for example "cat"). 

T math.md ---------- 

# Mathematics 


Mathematics (also math or maths) is the best science] (science.md) (ves, it is.a formal.science), which deals with numbers, abstract structures and [logic] (logic md in as rigorous and objective 
way as possible. In fact it's the only true science that can actually prove things. It is immenSely important in [programming](programming.md) and [Comput séience](compsci.mÁd). 


Some see math not as a science but rather a discipline that.develops formal tools for "true sciences", The reasoning is usually that a, science has to use [scientific method] R ae 
(scientific_method.md), but that's a limited view as scientific methods is not the enel way of obtaining reliable knowledge. Besides that math can and does use the principlés of scientific 
c 


method -- mathematicians first perform "experiments" with numbers and generalize into onjectures](conjecture.md), however this is not considered [good enough] (good enou! h.md) in math as it 
actually has the superior tool of [proof] (proof md) that is considered the ultimate goal of math. I.e. math relies on [deductive](deduction.md) reasoning (proof) rather than less reliable 
[inductive](induction.md) reasoning (scientific method) -- in this sense mathematics is more than a science. 


[Sqydevs] (soydey. md), coding monkeys (such as webdevs) and just retards in general hate math because they can't understand it. They think they can_do programming without math, which is just 
ridiculoüs his delusion stems mostly from these people being highly incompetent and without proper education -- all they've ever seen was a shallow if-then-else [python] (python mé) " [Coding] 
(coding.md)" of baby programs or point-and-click "coding" in gigantic [GUI](gui.md) frameworks such as [Unity](unity.md) where everything is already preprogrammed for them. By Dunning-Kruger 
they càn't even see how incompetent they are and what real Programming is about. In reality, this is like thinking that being able to operate a calculator makes you a capable mathematician or 
being able to drive a car makes you a capable car engineer. Such people will be able to get jobs and do some repetitive tasks such as web development, [Unity](unity.md) game development or 
system administration, but they will never create anything innovative and all they will ever make will be ugly, [bloated](bloat.md) [spaghetti](spaghetti md] Solution that will likely do more 
arm than good. 


On the other hand, one does not have.to be a math fen (phd e md) in order to be a good programmer in, most fields, Sure, knowledge and overview of advanced mathematics is needed to excel, to be 
able to spot and Sense elegant solutions, but beyond these essentials that anyone can learn with a bit of will it's really moré about just not being afraid of math, accepting and embracing the 
fact that it permeates what we do and studying it when the study of a new topic is needed. 


**The power of math is, limited.** In 1932 prunt Godel] (godel. md) mathematically proved, with his [incompleteness theorems | (incompleteness md) that. (basically) there are truths which math itself 
can never prove, and that math itself cannot prove it$ Own consistency (which killed so called Hitbert's program which sought to do exactly that). This is related to the limited power of 
[computers](computer.md) due to [undecidability](undecidability.md) (there are problems a computer can never decide), proven by [Alan Turing](turing.md). 


## Overview 
Following are some math areas and topics which a programmer should be familiar with: 


;,**basics** (high-school. level math): arithmetic, algebra, expressions, | functions] (Function md) [e yations] (equation md) geometry, tri jonometry](trigonometry.md)/goniometry, systems of . 
linear equations; quadratic equations; [complex numbers](complex_number.md), [logarithms](lofarithm.md), [analytic geometry] (analytic g ometry.md) Ynány problems’ are’ equivalent to relationships 
of shapes in N dimensional spaces), [polynomials](polynomial.md) (used in many areas, e.g. error correction codes in networking), ... 

- **advanced notation**: ability to understand the notation that's often used in papers etc. (the big sigma for sum, calculus notation etc.) 

- **formal [logic logic.md)**: computers are based on [Boolean] (boolean. md) logic, knowing basic, formulas and theorems here is crucial {e.9- the completeness of [NAND](nand.md) or [De Morgan's 
laws](de morgan.md)), formal logic is also just generally used in formal texts, one should know about predicate vs propositional logic etc. 


= FF proofs] (proof md **: core of high level mathematics, one should know the basic proof techniques (direct, [contradicrion]Ccontradiotion md); [induction] (induction md), ees 

- **[linear à ebral( inger algebra md) i: aka "vectors and matrices", essential in almost every fiel [graphics] (graphics m , [machine learning] (machine_ earning md) ue) 

- tu calculus] cau us.md) and differential equations**: just essential for advanced math and many fields (graphics, machine learning, [electronics](electronics.md), physics, any 
optimization, ...). 


- **theoretical [computer Seience](compsci.md)*?: {computational complexity] (computational complexity md) (very. important), [computability](computability.md), [formal languages] 
(formal language.md), computation models ([automata](automaton.md), [Turing machines](turing machine.md), ...), ... 

- **[graph theory](graph.md)**: generally useful tools, especially important e.g. in networks or indexing structures in [databases](database.md). 

mE number.md) and. set] (set nd theory**: sets of numbers ([naturai] (natural number nd) ['ationat] rational number.md), [real](real number.md), [complex](complex number.md), ...), 
[prime numbérs](prime.md) (important e.g. for [Cryptography](cryptográphy.md), [quantum computing|(quantum.md), ...), -.. 

- **discrete math**: basic structures such as [groups] (group. md) and [fields](field.md), [abstract algebras] (abstragt_algebra md) and the properties of these structures. 

-,**[signal processing] (signal-grocessing.md)" : [Fourier transform](fourier_transform.md) and other integral transforms (important e.g. for [compression](compression.md) and analysis of 
signals), [aliasing](aliasing.md), filter théory, ... 

- MU E methods](numerical.md)**: for simulations and [approximations](approximation.md) of solutions to problems we can't solve exactly. 

- **[probability](probability.md)/statistics**: encountered practically everywhere but very important e.g. in [crypto raphy] (cryptography md) . 

- **other**: things important in specific fields and/or other weird stuff, e.g. [topology](topology.md), [quaternions](quaternion.md) (graphics, physics), [lambda calculus](lambda calculus.md), 
[game theory](gamé theory.md), [fractal geometry](fractal.md), ... 


Il memory management.md ---------- 
# Memory Management 


In [programming] (programming md) *memory management © is (unsurprisingly) the act and various techniques of managing the working. [memory] (memory md) ({RAM] (ram.md) of a computer, i.e. for 
example dividing the total physically available memory among multiple memory users such as operating system processes and assuring they don't artega y access each other's part of memory. The 
scope of the term may differ depending on context, but tasks falling under memory management may include e.g. memory [allocation] (allocation. md) (finding and assigning blocks of free memory) and 
deallocation (freeing such blocks), ensuring [memory safety](memory safety.md), organizing blocks of memory and [optimizing](optimization.md) memory access (e.g. with [caches](cache.md) or data 
reorganization), [memory Virtualization] (virtual memory.md) and related tasks such as address translation, handling out-of-memory [exceptions](exception.md) etc. 


Memory management can be handled at different levels: hardware units, such as the [MMU] (mmu.md) ang CPU [caches] (cache md) exist to perform certain time-critical pemory-related tasks (such as 
address translation) quickly, [operating system](os.md) may help with memory manageme (e.g. implement virtua memory and offer fsyscalts] (syscall ma} for dynamic allocation and deallocation of 
memory), a [programming language](programming language.md) may do some automatic memory management (e.g. [garbage collection](garbage_collection.md) or handling call stack) and programmer 

himse may do his own memory management (e.g. deciding between static and dynamic allocation or choosing the size of dynamic allocation chunk). 


**why all this fuzz?** As a newbie.programmer who, only works with simple variables and high level languages like, [Python] (python .md) that do everything for, you you don't need to do, much memory 
management yourself, but when working with data whose size may wildly differ and is not known in advance (e.g. files), someone has to handle e.g. the Possibility of the data on disk not being 
able to fit to RAM currently allocated for your program, or -- if the data fits -- there may not be a big enough continuous chunk of memory for it. If we don't know how much memory a process 
will need, how much memory do we give it (too little and it may not be enough, too much and there will not be enough memory for others)? Someone has to prevent [memory leaks](memory leak.md) so 
that your computer doesn't run out of memory due to [bugs](bug.md) in programs. With many [processes](process.md) running } simultaneous ly (multitasking.md) on a computer someone has to keep. 
track of which process uses which part of memory and ensure [collisions](collision.md) (one process overwriting another processe's memory 

t 


don't happen, and someone needs to make sure that if 
bad things happen (such as process trying to write to a memory that doesn't belong to it), 


ey don't have catastrophic consequences like [crashing](crash.md) or exploding the system. 
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## Memory Management In C 


In [C](c,md) -- a [iow level](low level.md) language.-- you_need to do a lot of **manual** memory management and there. is a **big danger of fucking up rr especially with dynamic allocation -- C 
won't hold your hand (but as à reward your program will be fast and efficient), there is no uber memory safety. There is no automatic [garbage collec ion](gerbage coL lection.md), i.e. if you 
allocate memory dynamically, YOU need to keep track of it and manually free it once you're done using it, or you'll end up with [memory leak](memory leak.md). 


For start let's see which kinds of allocation (and their associated parts of memory) there are in C: 


- **static.allocation (code/data memory)**; Simplest kind of allocation happening at compile time: if the compiler can.do so (i.e. if it knows enough things such as the size of the data in 
advance), it allocates space of concreté size at some specific address in e part of memory reserved for code or static data (code and data may be in the same or separate parts depending on 
platform, see e.g. [Harvard architecture](harvard.md)) -- this is straightforward, simple, automatic and poses no real dangers, bloat or burden of dependencies. This kind of allocation applies 
to: 

- **global variables** (variables declared outside any function, i.e. even outside "main') 

- **$tatic variables** (variables inside functions declared with ^static^ keyword) 

- **constants/literals** (i.e. concrete numbers/strings in the source code such as '123' or `"abc"`) | " A 
- **automatic allocation (stack memory For local variables (variables inside functions) the memory is allocated in a special part of memor y. knowin as **call [stack](stack.md)** only at the 
time when the function is actually called and executed; i.e. this is similar to dynamic allocation (it happens at run time) "But happens automatically, without needing any libraries or other 
explicit actions from the programmer. I.e. when a function is called at run time, a new *call frame* is created on stack which includes space for local variables of that function (along with 
Sig; return address from the function etc.). This is necessary e.g. to allow [recursion](recursion.md) (during which several instances of the same function may be active, each of which may have 
different values of its variables), and it also helps consume less RAM. This allows for creating variable sized arrays inside functions (e.g. “int array [x] where ^x? is variable) which is not 
possible to do with a global array (however variable size arrays aren't supported in old ANSI Cl). The disadvantage over dynamic allocation is that stack memory is relatively small and overusing 
it may easily cause stack [overflow (overt Low. md) (running out of memory): till this kind of allocation is better than dynamic allocation as it doesn't need any libraries, it doesn't generate 
complex code and the only danger is that of stac y when function is exited). Automatic allocation applies to: 

- **local variables** (including function arguments and local **variable size arrays**) 
: **dynamic allocation (heap, memory)**: A kind of more complex manual allocation that happens at run time and is initiated,by the Togrammer calling special functions,such.as ;malloc' from the 
stdlib standard library, which réturn [pointers](pointer.md) to the allocated memory. is memory is taken from a special part of mémory known as ** heap] (heap.-mo) 7 This allows to allocate 
resize and deallocate potentially very big parts of memory, but requires caution as working with pointers is involved and there is a danger of S merory leaks** -- it is the responsibility of_ the 
programmer to free allocated memory with the `free` function once it is no longer needed, otherwise that memory will simply remain allocated and unusable by others (if this happens for example 
in a loop, the program may just start eating up more and more RAM and eventually run out of memory: Dynamic allocation is also pretty comp tex (it usually involves communicating with operating 

emen y 


System and also keeping track of the structure of memory) and creates a [dependency | (dependency md on the 'stdlib! library. Some imp ations of the allocation functions are also infamous 
slow (up to the point of some programmers resorting to program their own dynamic a 
to: 


Overflow -- memory leaks can't happen (deallocation happens automatical 


Ocation systems). Therefore only use dynamic allocation when absolutely necessary! Dynamic allocation applies 
- **memory allocated with special functions** (^malloc', ~calloc’, '"realloc') 


Rule of the thumb: use the simplest thing possible, i,e. static allocation if you can, if not, then automatic and 9n. as the last option resort to dynamic_allocation. The good news, is that i 
mostly won't need dynamic allocation** -= you basically only need it when working with data whose size can potentially be VERY big and is unknown at compile time (e.g. you need to load a WHOLI 
file AT ONCE which may potentially be VERY bii ]: In other cases you can get away with static allocation (just reserving some reasonable amount of memory in advance and hope the data fits, e.g. a 
global array such as int myData[DATA MAX SIZE] ) or automatic allocation if the data is reasonably small (i.e. you just create a variable sized array inside some function that processes the 
ata). If you end up doing dynamic allocation, be careful, but it's not THAT hard to do it right (just pay more attention) and there are tools (e.g. Tvetarine (vatgrind.md)) to help you find 
memory leaks. However by the principles of [good design](irs.md) **you should avoid dynamic allocation** if you can, not only because of the potential for errors and worse performance, but most 
importantly to avoid dependencies and complexity. 


For [prog] (pro.md) : you çan alsọ create your own. kind of pseudo dynamic allocation in pure C if yo" really want to_avoid using stdlib or can't use it for some reason, The idea_is to allocate a, 
big unk of memofy Statically (e.g. global ‘unsigned char myHeap|MY HEAP SIZE]; ) and then create functions for allocating ard freeing blocks of this static memory (e.g. myAlloc and ‘myFree 
with same signatures as “malloc. and “free’). This allows you to use memory more efficiently than if you just dumbly (is it a word?) preallocate everything statically, i.e. you may need less 
total memory; this may be useful e.g. on [embedded] (embedded . md) . Yet another uber [hack](hacking.md) to "improve" this may be to allocate the "personal heap" on the stack instead of statically, 
i.e. you create something like a global pointer “unsigned char myHeapPoinrerr. and a global variable “unsigned int m HeapSize; sr then somewhere at the beginning of "main, you compute the size 
"myHeapSize' and then create a local array "myHeap[myHeapSize]', then finally set the global pointer to it as ‘“myHeapPointer = myHeap'; the rest remains the same (your allocation function will 
access the heap via the global pointer). Just watch out for reinventing wheels, bugs and that you actually don't end up with a worse mess that if you took a more simple approach. Hell, you might 
even try to write your own garbage collection and array bound checking and whatnot, but then why just not fuck it and use an already existing abomination like [Java](java.md)? 


Finally let's see some simple code example: 


#include <stdio.h> 
#include <stdlib.h> // needed for dynamic allocation :( 


#define MY_DATA_MAX_SIZE 1024 // if you'll ever need more, just change this and recompile 


unsigned char staticMemory[MY_DATA_MAX_SIZE]; // statically allocated array :) 
int simpleNumber; // this is also allocated statically : 


void myFunction(int x) 


static int staticNumber; // this is allocated statically, NOT on stack 
int localNumber; // this is allocated on stack 
int localArray[x + 1]; // variable size array, allocated on stack, hope x isn't too big 


localNumber - 2 * x; // do something with the memory 
localArray[x] = localNumber; 


if (x > 0) // recursively call the function 
myFunction(x - 1); 


int main(void) 
int localNumberInMain = 123; // this is also allocated on stack 
myFunction(10); // change to 10000000 to see a probable stack overflow 
for (int i = 0; i < 200000; ++i) 


if (i % 1000 == 0) . 
printf("i = %d\n",i); 


unsigned char *dynamicMemory = (char *) malloc((i + 1) * 10000); // oh no, dynamic allocation, BLOAAAT! 
if (!dynamicMemory) 


printf("Couldn't allocate memory, there's probably not enough of it :/"); 
return 1; 


dynamicMemory[i * 128] = 123; // do something with the memory 


free(dynamicMemory); // if not done, memory leak occurs! try to remove this and see :) 


} 


return 0; 


l1 mental outlaw.md ---------- 
# Mental Outlaw 


Mental Outlaw is_a black/ [N word] (nigger; pd) fyoutuber ] (yoytube.md)/vlogger focused on [FOSS](foss.md) and, to a considerable degree, [suckless](suckless.md) software. He's kind of a copy-paste 
of [Luke Smith](luke smith.md) but a little closer to e [mainstréam](màinstream.md) and normies. 


Like with Luke, sometimes he's real based and sometimes he says very stupid stuff. Make your own judgement. 
---------- microsoft.md ---------- 
# Micro$oft 


Micro$soft (officially Microsoft, MS) iş a terrorist organization [ggftware](software.md) [corporation](corporation.md) named after [its founder] bill gates,md)'s dick -- it is, along with 
[Google (goog Le md) ta ple](apple.md) [et al](et_al.md) one of the biggest organized crime groups in history, best known for holding the world captive with its highly abusive "[operating 
System](os.md)" ca te [hin lowS (windows md), as well as for leading an ressive war on [free software](free software.md) and utilizing many unethical and/or illegal business practices such as 
destroying ay potentis e 

md). 


ai 
¢ n competition with t [*Embrace Extend Extinguish*](eee md) (actual terminology internally used at Microsoft) strategy or lately practicing heavy [openwashing] 
openwashing. 


Microsoft is unfortunately among the absolutely most powerful entities in the world (that sucks given they're also among the most hostile ones).-- likely more powerful than any government and 
most other corporations, it is in their power to **immediately destroy any country** with the pu$h of a button, it's juSt a question of when this also becomes their interest. This power is due 
to them having **complete control over almost absolute majority of personal computers in the world** (and therefore by extension over all devices, infrastructure, organization etc.), through 
their [proprietary] (proprietary md) ({malware] (malware md) ) "[operating s stem] tos. md): [Windows] (win ows md) that has built-in [backdoor] (backdoor md) allowing Microsoft immediate access and 
control over prac ically any computer in the world. The backdoor "feature" isn't even hidden, it is officially and openly admitted (it is euphemistica ly called [auto u dares | Cautoupdate md).): 
Microsoft prohibits studying and modification of Windows under threats including physical violence {tinkering with Windows violates its [EULA] (Sula md) which is a lawfully binding license, and 
law can potentially be enforced by police using physical force). Besides legal restrictions Microsoft applies high [obfuscation](obfuscation.m à [bloat](bloat.md), [SAASS](saass.md) and other 
poehniques preventing user freedom and defense against terrorism, and forces its system to be installed in schools, governments, power plants, hospitals and basically on every computer anyone 
buys. icrosoft can asically (for most people) turn off the [Internet ](internet.md), electricity, traffic control system etc. Therefore every hospital, school, government and any other 
institution has to bow to Microsoft. 


TODO: it would take thousands of books to write just a fraction of all the bad things, let's just add the most important ones 
T microtheft.md ---------- 
# Microtheft 


See [microtransaction](microtransaction.md). 
EE mmn microtransaction.md ---------- 
# Microtransaction 


Microtransaction, also microtheft, is the practice of selling -- for a relatively "low" price -- virtual goods in some virtual environment, especially i ames] (game, md), by, the owner of that 
environment. It's a popular business model of many [capitalist games |{capitalist_sortware md) -- players Rave an "option" (which they are pushed to tak 3 to buy thangs such as skins and purely 
cosmetic items but also items giving an unfair advantage over other players (in-game currency, stronger weapons, faster leveling, ...). This is often targeted at childr 


Not only don't they show you the source code they run on your computer, not only don't they even give you an independently playable copy of the game you paid for, not only do they spy on you, 
they also have the audacity to ask for more and more money after you've already paid for the thing that abuses you. 

T0 minigame.md ---------- 

# Minigame 


Minigame is a very small and simple [game] (game md) intended to entertain the player for just. a short amount of time, unlike a full fledged game; Minigames may a lot of times be embedded into a 
biggér game (as an [easter egg](eastér egg.md) or âs a part of a game mechanic such as lock picking), they may come as an extra feature On primarily nón-gaming systems, or appear in collections 
of many minigames as a bigger package GE various party game collections). Minigames include e.g. [minesweeper ] (minesweeper .md) [Sokoban] (sokoban.md), the Google [Chrome] (chrome . md T-rex 
game, simon Tatham's Portable Puzzle Col ie iden ETL m as well as many of the primitive old games like [Pong] (pong ma) and [retris](tetris.md). Minigames are nice from the [LRS](lrs.md) 
[) 
, 


id 
point of view as they are [minimalist](minimalism.md Simple to create, often [portable](portability.md), while ering a potential for great [fun](fun.md) nevertheless. 


Despite the primary purpose of minigames many players invest huge amounts of time into playing them, usually competitively e.g. as part of [speedrunning](speedrun.md). 


Minigames are still very often built on the principles of old arcade games such as getting the highest score or the fastest time. For this they can greatly benefit from [procedural generation] 
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(procgen.md) (e.g. endless runners). 
## List Of Minigames 
This is a list of just some of many minigames and minigame types. 


**[2048](2048.md)**. 
**larkanoid](arkànoid.md)** 
**[asteroids|(asteroids.md)** 
** [backgammon ] (backgammon . md) * * 
**button smasher**; Games whose goal is, achieved mainly by,smaghin a button as quickly as possible, usually e.g. sprint simulators. This may perhaps even include a game that requires you to 
ress a button as quickly as possible (achieve fastest reaction timej. 
**[card games](card game.md)** 
as |eneekepsgtoneckers mdi 
**[chess](chess.md)**, its variants and chess puzzles TP z 
**city bomber**: A plane is descending on the Screen, player has to drop bombs to destroy building so that it can land. 
**concentration** 
**[donkey kong](donkey. kong.md)** 
**[endless runner](endless runner.md)** 
p fifteen aeon bi d.md)** 
appy bir appy bird.m 
**[game of on ted) 
**Tgo](go_game.m Jp 
**guess a number * 
**lhangman] (hangman .md ) * * 
**[linvaders](invaders.md)** 
**knowledge quiz** 
**[lloderunner](loderunner.md)** 
**[ludo](ludo.md)** 
**[lunar lander](lunar lander.md)** 
** mahjong (mahjong.md)** 


**[minigolf](minigolf.md)** 
**[minesweeper](minesweeper.md)** 
Dt pacman] pacman .md ) ** 
**[pinbal (pinball md)*" 
**[poker](po er .md)** 
pong] pong.md)* 
**T roc caper -scissors] (rock_paper_scissors .md)** 
**T shoot 'em up] (shmup im db 
**[sokoban] (sokoban.md) * 
solitaire](solitaire.md)** 
**[snake](snake.md)** 
**[sudokü] (sudoku.md) ** 
**[tetris](tetris.md)** (block game, "tetris" is trademarked) 
**The Witness puzzles**: The kind of puzzles that appear in the game The Witness. 
**[tic-tac-toe](tic tac toe.md)** 
**[tower of hanoi](tower of hanoi.md)** 
**[tron](tron.md) 
untan le](untàngle.md)** 
**l'owoP](qwop.md)* 


M minimalism.md ---------- 
# Technological Minimalism 


*No gain, no pain.* 


Technological minimalism is a philosophy of designing technology to be as simple as possible while still achieving given goal, possibly even a little bit simpler. Minimalism is one of the most 
(if not the most) important concepts in [programming] (programming md) and technology in general. 


Antoine de Saint-Exupéry sums it up with a quote: *we achieve perfection not when there is nothing more to add, but when there is nothing left to take away.* 


**Minimalism is necessary for, [freedom](freedom.md)** as a free technology,can only.be that over which no one has a [monopoly] (ploat_monopoly md), i.e. which many people and small parties can 
utilize, study and modify with affordabte effort, without needing armies of technicians just for the maintenance of Such chnò logy. Minimalism goes against the creeping overcomplexity of 
technology which always brings huge costs and dangers, e.g. the cost of [maintenance](maintenance.md) and further development, obscurity, inefficiency ("[bloat](bloat.md)", wasting resources), 


consumerism, the increased risk of bugs, errors and failure. 


Up until recently in history every engineer would tell you that *the better machine is that with fewer moving parts*. This still seems to hold.e.g. in mathematics, a field not yet so spoiled by 
huge commercialization and mostly inhabited by the smartest people -- there is a tendency to look for the mošt minimal equations -- such equations are considered [{beautiful](beauty.md). Science 


also knows this rule as the [Occam's razor](occams_razor.md). In technology invaded by aggressive commercialization the situation is different, minimalism lives only in the underground and is 
ridiculed by the mainstream propaganda. Some of the minimalist movements, terms and concepts include: 


Suck less rer iii i d) 

Unix iloso unix philoso| m 

KISS] (kiss md)" P e 

countercomplex](countercomplex.md) 

less retarded software](lrs.md) 

less is more] (less is more md)/ [worse is better](worse is better.md) 
appropriate technology](appropriate tech.md) 


Under [capitalism] (Gapitalism.md) technological minimalism is suppressed in the mainstream as it goes against corporate interests, i.e. those of having monopoly control over technology, even if 
such technology is "[FOSS](foss.md)" (which then becomes just a cool brand, see Lopenwashing] (opehwashing md) ) . We may, at best, encounter a "shallow" kind of minimalism, so called r 
[ed Xs {pee anes ) which only tries to make things appear minimal, e.g. aesthetically, and hides ugly overcomplicated internals under the facade. [Apple](apple.md) is famous 
or this [shit](shit.md). 


There are movements, such as [appropriate technology] (appropriate tech .md) (described by E. F. Schumacher in a work named *Small Is Beautiful: A Study of Economics As If People Mattered*) 
advocating for small, efficiént, decentralized technology, because that is what best helps people. 


**Does minimalism mean we have to give up the nice things?** Well, not really, it is more about giving up the [bullshit] (bullshit md), and changing an attitude. **We can still have technology 
for entertainment**, just a non-consumerist one -- instéad of consuming 1 new game per month we may rather focus on creating deeper games that may last longer, e.g. those of a [easy to learn, 
hard to master (easy op igarn-hard to master md) kind and building communities around them, or on modifying existing games rather than creating new ones from scratch over and over. Sure, 
technology wou LOOK different, our computer interfaces may become less of a thing of fashion, our games may rely more on aesthetics than realism, but ultimately minimalism can be seen just as 
trying to achieve the same effect while minimizing waste. If you've been made addicted to bullshit such as buying a new GPU each month so that you can run games at 1000 FPS at progressively . 
higher resolution then of course yes, you will have to suffer a bit of a withdrawal just as a heroin addict suffers when quitting the drug, but just as him in the end you'll be glàd you did it. 


There is a so called *[airplane rule](airplane rule.md)* that states a plane with two engines has twice as many engine problems than a plane with a single engine. 
## Importance Of Minimalism: Simplicity Brings Freedom 


It can't be stressed enough that minimalism is absolutely required for technological freedom, i.e. people having, in **practical** ways, control over their tools, While in today's society it is 
important to have legal freedoms, i.e. support [free software](free software.md), we must not forget that this isn't enough, a freedom on paper means nothing if it can't be practiced. We need 
both legat AND [de facto](de_facto.md) freedom over technology, the former being guaranteed by a free [license](license.md), the latter by minimalism. Minimal, simple technology will increase 
the pool of people and parties who may practice the legal freedoms -- i.e. those to use, study, modify and share -- and therefore ensure that the technology will be developed according to what 
people need, NOT according to what a Corporation needs (which is usually the opposite). 


Even if a user of software is not a programmer himself, it is important he chooses to.use minimal tools because that makes it more likely his tool, can .be repaired.or improved by SOMEONE from the 
people. Some people naively think that if they're not programmers, it doesn't matter if they have access and rights to the program's source code, but indeed that is not the casé. You want to 
Choose tools that can easily be analyzed and repaired by Someone, even if you yourself can't do it. 


Minimalism and simplicity increases. freedom even of (proprietary (proprietary md) technology which can be seen eag: on games {game md} for old systems such as [GameBoy] (gameboy md) or [dos 
los.md an e shared by è, yt 


(d ) -- these games, despite being proprietary, and are éásily and plentifully played, modified and thé peo DESPITE not being free legally, simply cause it is ea 
handle them due to their simplicity. This just further confirms the correlation of freedom and minimalism. 

T mipmap.md ---------- 

# Mipmap 


Mipmap, (from Latin *multum in parvo*, *many in little*), is,a digital image that is stored along with progressively smaller versions of itself; mipmaps are useful in [computer graphics] ` 
graphics.md), especially as a representation of [textüres](textüre.md) in which they may eliminate [aliaSing](aliasing.md) during rendering. But mipmaps also have other uses süch as sérving as 
acceleration structures ( ler image can speed up memory access). Mipmaps are also sometimes called **pyramids** because we can 


B n s](acceleration_structure.md) or helping performance (using a sma 
imagine the images of di 


erent sizes laid one on another to form such a shape. 


A basic form of.a mipmap çan be explained on the following example. Let's say we have an RGB] (rgb md) image of size 1024x1024 pixels. To create its mipmap we.call the base image level © and 
create progressively smaller versions (different levels) óf the image by redücing the sizé foü imes'(twice along one dimension) at each step. I.e. level 1 will be the base image downscaled to 
the size 512x512. If we are to use the mipmap for the common purpose of reducing aliasing, the downscaling itself has to be done in a way that doesn't introduce aliasing; this can be done e.g. 
by downscaling 2x2 areas in the base image into a single pixel by **averaging** the values of those 4 pixels (the averaging is what will prevent aliasing; other downsca ing methods may be used 
depending on the mipmap's purpose, for example for a use as an accelerating Structure we may take a maximum or minimum of the 4 pixels). Level 2 will be an image with resolution 256x256 obtained 
from the 512x512 image, and so on until the last level with size 1x1. In this case we'll have 11 levels which together form our mipmap. 


This RGB mipmap can be shown (and represented in memory) as a "fractal image": 


level 0 level 0 
red reen 
channel channel 


level 1|level 1 


red reen 
level 0 channel] channel 
blue 
channel level i|l2r|l2g 
blue 


channel|l2b -fF 
pF 


This may, be how a texture is represented inside a [graphics card] (opu md) if we upload it (e.g. with [OpeneL] (opengl md)) . When we are rendering HIM a 3D model with this texture and the model 
ends up being rendered at the screen in such size at renders thé texture smaller than its base resolution, the rénderéf (e.g. OpenGL) automatically chooses the correct level of the mipmap 
(according to Nyquist-Shannon sampling theorem) to use so that aliasing won't Occur. If we're using a rendering system such as OpenGL, we may not even notice this is happening, but indeed it's 
what's going on behind the scenes (OpenGL and other systems have specific functions for working with mipmaps manually if you desire). 


Do we absolutely need to use mipmaps in rendering? No, some simple (mostly software) renderers don't use them and you can turn mipmaps off even in OpenGL, Some renderers may deal with aliasing 
in other ways, for example by denser samp ling of the texture which will however be Slower (in this regard mipmaps Can be seen as precomputed, already antialiased version of the image which 
[trades memory for speed](spàce time tradeoff.md)). 


We can also decide to not deal with aliasing in any way, but the textures will look pretty bad.when downscaled on the screen (e.g. in the distance). They, are kind of.noisy and flickering, you 
can find examples of this kind of messy rendering online. However, if you're using low resolution textures, **you may not even néed mipmaps** because such textures will hardly ever end ùp 
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downscaled -- this is an advantage of the [KISS](kiss.md) approach. 


One shortcoming of the explained type of mipmaps is that they are *isotropic*, i.e. they suppose the rendered texture will be scaled uniformly in all directions, which may not always.be the 
case, especially in 3D rendering. Imagine a floor rendered when the camera is looking forward -- the floor texture may end up being downscaled in the vertical direction but upscaled in the 
horizontal direction. If in this case we use our mipmap, we will prevent aliasing, but the texture will be rendered in lower resolution horszontaL y: This is because the renderer has chosen a 
lower resolution of the texture due to downscale (possible aliasing) in vertical direction, but horizontal direction will display the texture upscaled. This may look a bit weird, but its 
completely workable, it can be seen in most older 3D games. 


The above issue is addressed mainly by two methods. 


The first is [trilinear filtering] trilinear filtering.md) which _uses several levels of the mipmap at once and [linearly blends](linear interpolation.md) between them. This is alright but still 
shows some [artifacts](artifact.m such as visible changés in blurriness. 


The second method is [anisotropic filtering](anisotropic.md) which uses different, *anisotropic* mipmaps. Such mipmaps store more version of the image, resized in many different ways. This 
method is nowadays usēd in quality graphics. 

T2 mob software.md ---------- 

# Mob Software 


*Not to be confused with [mob programming](mob programming.md).* 


TODO (read https://www.dreamsongs.com/MobSoftware.html) 
T moderation.md ---------- 
# Moderation 


Moderation EE [suphemism](euphemismmd) for [censorship](censorship.md) encountered mostly in the context of Internet communication platforms (forum discussions, chats etc.). 
Ll modern.md ---------- 


*"Everything that modern culture hates is good, and everything that modern culture loves is bad."* --fschmidt from [reactionary software](reactionary software.md) 


So called *modern* [software](software.md)/[hardware](hardware.md) and other technology] (technology md) might as well be synonymous with [shitty](shit.md) abusive technology. In a [capitalist] 
(capitalism.md) [agé](21st céntury;md) whén ever thing is getting progressive Y worse in terms of coign: quality, ethicali Y efficiency, etc., néwer means worse, therefore modern (*newest*) 
means *the worst*. In other words *modern* is a term that stands for "as of yet best optimized for exploiting users". At [LR 1(irs.md) we' see the term *modern* as negative -- for example 
whenever someone says "we work with modern technology", he is really saying "we are working with worst technology we know of". 


The word *modern* was similarly addressed, e.g. by [reactionary software](reactionary software.md) -- it correctly identifies the word as being connected, to a pro ramming orthodoxy of [current 
resa vtish Sem the ohe that's obse$sed with creating bad technology and rejecting good technology. { I only found reactionary software after this article has been written. 
-drummyfis 


## Modern Vs Old Technology 


It's sad and dangerous that newer generation won't even remember technelogy used to be better, people will soon think that the, current disgusting state of technology is the best we can do. That 
is of course wrong, technology used to be relatively good. It is important we leave here a note on at least a few ways in which old was much, much better. 


(INB4 "it was faster and longer on battery etc. because it was simpler" -- **yes, that is exactly the point**.) 


- Old technology was simpler and **better engineered with minimum {bloat} (bloat .md)** .Fewer incompetent people were present in the field and capitalism wasn't yet pushing as hard on extreme 
development spéed and abuse of the user, products still tried to compete by their quality. 

- **0ld computers were faster** and astronomically more efficient. Computers with a.few MHZ single-core CPU and under a, megabyte of RAM booted faster to [DOS] (des md) than modern computers boot 
to Windows 10, despite [Moore's law](moores law.md) (this shittiness iS known as [Wirth's law] (war tns_law.md)) . Old tech also **reacted faster to input** (had shorter input latency/lag), e.g. 
thanks to shorter input and output processing [pipe tines] (pipeline .md) . § I've heard this confirmed from [John Carmack](carmack.md) himself in a talk on his deve Lopment of [VR](vr.md). 
-drummyfish } Back in the day t ings had to work smoothly -- if in the 90s you showed people a phone that you wake up and have to wait 20 seconds before it starts to react, they would laugh at 
it and on one would buy it -- nowadays such technology is the standard. 

- Old devices such as cell phones **lasted much, much longer on battery**. The old phones such as Nokia 3310 would **last long over a week** on stand-by. 

-.**0ld software was shipped finished,, complete and with minimum [bu s] (pug, má? Nowadays newly released Lee] (app. mdp and [games | (game md) are normally released unfinished, even_in pre- 
alpha states and even "finished" ones have [bugs] (bug me) often réndérin he Software unsuable {see cyberpu k 2077, GTA: Definitéve Edition etC.), user is Supposed to wait years for fixes 
(without any guarantees), pay for content or even subscriptions. Some software "products" even spend their whole commercial life unfinished. Old software was difficult or even impossible to 
patch (e.g. [Gameboy](gameboy.md) cartridges) so it had to work. 

- **Old tech had minimum malicious features**. There wasn't spyware in CPUs EMAA **[DRM](drm.md) was either absent or primitive**, there weren't ads in file explorers, there weren't 
[microtransactions](microtransaction.md) in games, there werén" [eutoupdates (autoupdate.md), there weren't psychologically abusive [social networks] (social_network.md), technology was 

*designed to last**, with replaceable parts; not to be [consoomed](consumerism.md), there was much less Tcensorship| (censorship. md). 

- **Old tech was much easier to repair, modify and customize**, thanks to not being so overcomplicated and not containing so many anti-repair "features". Old software wasn't in the [cloud] 
(cloud.md) which makes it impossible to modify. 

- **0ld software was better programmed** because it was firstly made b actual ly the smartest people such as mathematicians and physicist (who were considering the big picture and saw e.g. the 
necessity for minimalism) and sécondly without such a great pressure of the market because software was more a subject of research and experimenting rather than dirty fight for consumers. This 
can be seen even on commercial software such as games: for example the [Doom](doom.md) engine was written very nicely, in an extremely [portable](portability.md) way (which actually became 
PERERA with things such as an elegant deterministic FPS-independent physics (which results in many advantages and is basically THE only correct way of writing an engine) and [software 
rendering|(software rendering.md) that ran smooth even on that time's slow CPUs. Later engines from the same creators -- those of Youake] (quake. md) games -- began to suffer from worse design (no 
deterministic physics, dropping of software rendering ete. p Nowadays software is written by high schoolers, women and incompetent minorities forced into tech just for diversity quotas and 
generally anyone who can just copy paste snippets of code from the web, extremely tight deadlines in the market race make it impossible to tidy any piece of software -- game engines (like 
anything else) nowadays are andescribably badly written, non-portable, non-deterministic, bloated, running slow even on computers thousands of times faster than those that ran Doom (even if you 
lower graphic details of a 2023 game to the looks of a 2000s game, it will likely run under 10 FPS on a 2020 computer). 

- **Old tech was_much more independent and, freedom friendly**, did not require Internet connectivity, subscription etc. Thanks to its simplicity and better hackabi lity it was possible for people 
to partly control their devices, even if the devices were Yoró rietary](proprietary.md). Nowadays if the manufactures of your phone or even a Car) decides it's time for you to buy a new model, 
he just remotely kills your device, and you can hardly do anything about it (this is actually happening e.g. with [iPhones](iphone.md)). 

- There was **minimum [bullshit](bullshit.md)**. True usefulness was more important than killer features and marketing. 

- Old tech,was **simpler and more [fun] (fun. d),to program**, allowing direct access to hardware, not complicating things with [OO0P](oop.md) and similar [shit](shit.md), and so **old programmers 
were more "[productive](productivity cült.md)"^*, less frustrated and stressed. 

**Old "look n feel" of software was objectively better**. Just compare the graphics of [Doom](doom.md) and any shitty soulless "modern" game. 

T. modern software.md ---------- 

# Modern Software 


Go [here](modern.md). 
T1 monad.md ---------- 


{ This is my poor understanding of a monad. ~drummyfish } 

Monad is a [mathematical](math.md) concept which has.become useful in [functional programming] (functional md) and is one of the very basic [design patterns](design_pattern.md) in this paradigm. 
A monad basically wraps Some [data type](data type) into an "envelope" type and gives a way operate with these wrapped data types which greatly simplifies things like error checking or 
abstracting [input/output](io.md) side effects. 


A typical example is a **maybe** monad which wraps a type such as integer to handle exceptions such as division by zero. A maybe monad consists of: 


1. The be data type where *T* is some other data type, e.g. *maybe(int)*. Type *maybe(T)* can have these values: 

- *just(X)* where *X* is any possible value of *T* (for int: -1, 0, 1, 2, ...), or 

- zDothing. a special value that says no value is present 
2. A special function aC) that converts value of given type into this maybe type, e.g. *return(3)* will return *just(3)* 
3. A special combinator *X >>= f* which takes a monadic ( máybe*) values *X* and a function *f* and does the following: 

- if *X* is *nothing*, gives back *nothing* 

- if *X* is a value *just(N)*, gives back the value *f(N)* (i.e. unwraps the value and hand it over to the function) 


Let's look at a pseudocode example of writing a safe division function. Without using the combinator it's kind of ugly: 


divSafe(x,y) - // takes two maybe values, returns a maybe value 
if x -- nothing 
nothing else. 
if y == nothing 
nothing else 
if y = 0 
nothing else 
justix / y) 


With the combinator it gets much nicer (note the use of [lambda expression](lambda.md)): 


divSafe(x,y) - 
x >>= ( 8: y >== ( b: if b == 0 nothing else a / b } } 


Languages will typicall make this even nicer with a [syntax sugar](syntax sugar.md) such as: 
divSafe(x,y) - do 

a< 

Af y EDI nothing else return(a / b) 


TODO: I/O monad 
TODO: general monad 
TODO: example in real lang, e.g. haskell 


T2 money.md ---------- 


*Money spoils everything, and in [capitalism](capitalism.md) money is everywhere. * 
T. motivation.md ---------- 
# Motivation 


*There are too many motivated people, and too few passionate ones.* 
T2 murderer.md ---------- 
# Murderer 


You misspelled [entrepreneur](entrepreneur.md). 
l1 myths.md ---------- 


This is a list of myths and common misconceptions. 


zy TE java) (java-md) is highly [portable] (portability md ad" FALSE: While Java runs on several platforms, it's inefficiency and overhead of its extremely high level programming makes it 
unusable o evices' with limited resources such as [embedded systems](embedded.md). Its iboated] (bloat md) nature and high number of dependencies limit it tO running on a few types of 
**mainstream** devices that are privileged to have the Java virtual machine implemented. 

= auge gamd) is not fportable] (portability .md "**: FALSE; C is extremely portable if written [correctly] (urs md) (8: without gependencies), in fact it is probably the **most portable 
languágé in history** because firstly a C compiler is available for almost any platform -- a C Compiler 18 one of the most essential things tô have -- and secondly because C is extremely 
efficient and will run even on devices with extremely limited resources such as [embedded systems] (embedded.md). 


231 ADDITIONAL PAPER BACKUP OF DRUMMYFISH’S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


- eir capitalism] (capita}ism.md) fuels progress"**; FALSE; Monopolies that inevitably arise in capitalism want to forever prevent others from creating innovations that would make the subject of 
their business obsolete (e.g. fossil fuel businessmen will want to prevent electric Cars). Of course, small businesses cannot compete with large corporations, therefore corporations win and keep 
the status quo. Small_businesses can mostly only succeed in creating foutlshit] (bullshit md) that exists for its own sake (there is e.g. an online store. so thing literal shit) -- this we would 
not call a progress. Furthermore capitalism is against the importan ind of progress such as social progress or education, because of course educated, independent and mature people would engage 
less in consumerism and even realize that capitalism is bad. 

- **Feminism, LGBT, Antifa and similar are leftist movements**; FALSE: These are in fact [psgudoteftist](pseudoleft.md), fascist movements who don't care about true equality but rather ,. 
privileges for a certain minority, just as the Italian fascist or Nazis did. This is provén by their [naming](name matters.md) and means of operation such as violence, censorship, bullying etc. 
which are anti-equality. 

- TODO 

T2 name is important.md ---------- 

# Name Is Important 


Name.of a philosophy, movement, group ideology etc. plays a more significant, role than a, common man believes. A naive. viẹw is that name is just an identifier, a, common man will rather believe 
promise of politician than the’name of his par y; however name is much more than a mere string of letters, it is the single most stable defining feature of an entity; everything else, all the 
ooks and knowledge associated with it may e distorted by history, but the name will always stay the same_and will hold a scrutiny over all actions of the entity it will always be a permanent 
reminder to every follower of what he is trying to achieve. But what if the name of the movement changes? Then it is to be considered a new, different movement. he name usually holds the one 


true goal. 
For this we have to keep in mind two things: 


- When encountering a new movement /phj losophy/ ideo logy etc., we can tell a, lot about it from its name: the name is its ultimate goal which **will be pursued on detriment of other goals**. A lot 
of times the bad movements are those **named after the means** (e.g. egabatatism| (capita lism. md) or *[open source](open source.md)*) **or [people](hero_culture.md)** (e.g. Maoism) rather than 
goals (e.g. *pacifism*) because by this dominance the focus on means will inevitably subordinate the goal. 

- When starting a new movement, we have to pay very careful attention to giving it a name. 


Nevertheless keep h i i 
in history, notably e.g. by [Nazism](nazi.md) whose name stands for "national socialism 
abuses the name *[anarchism](anarchism.md)* despite being completely anti-anarchist. 


in mind that while the power of the name is great, it is not infinite and the above may not hold if stronger forces are at play -- there have been many cases of **name abuse** 
" but whose actions were completely ànti-socialist, or so called ["Anarcho" capitalism](ancap.md) which 


Let us comment on a few examples: 


- "AlLcapitalism](capitalism md)"*; The goal, is maximization of capital -- capital should be the means to achieving "something" (what lol?), but it instead becomes the goal. There is no promise 
of a good society, it is not mentioned in the name, and indeed what we get is a system that evolves corporations that get progressively better at maximizing capital, on the detriment of people. 
-.**[Free Software Movement | (free software. md **: The movement is about user's freedom and therefore ethics, Notice that even though definitions of free software may slightly differ between 
différent branches of it, thé groups calling themselves *free software* movements always pursue freedom. This is why capitalism couldn't embrace free software: because thanks to the name it 
always firmly stands against abusing the user. Of course, even the meaning of the word *freedom* may eventually be shifted and the movement may get spoiled too, but it has stood for a long time 
and has already proven a great resistance. 

- pen Source Movement] (open_source.m : The movement has been born from the Free Software Movement with a specific goal of abandoning ethics and supporting business. The ethics (freedom 
**[0| Si M t d)**: Thi th b b T the F Soft Mi t with ifi l of, abandoni thi d ti busi Th thi f d 
has been dropped from the name and was replaced with the word "open", and indeed what we're seeing is software that is somewhat "open" -- whatever that means -- but mostly [capitalism softwaré] 

(capitalist software.md) abusing and restricting its users by means other than proprietary licenses (see e.g. [Firefox](firefox.md)). 

- scu peninism|(Feminismimd)* The goal is to benefit the females, i.e. make the superior to males. There is no mention of equality of sexes in the name even this idea might have appgared 
somewhere in the movement'$ beginning. And indeed, what we're seeing is a progressively more aggressive fascist movement that is downright hostile to males, is completely uninterested in 
inequality in the opposite direction and only ever looks for empowering the women, without any Concern of equality. 

**[LGBT](lgbt.md)**: Same as feminism, È . E t i A A 
**TAnarchism](anarchism.md)**: anarchism means "without a ruler" which has shown to be a good name, clearly opposing the idea of one man standing above another and so, again, keeps resisting 
attempts at being twisted to go against this basic goal. We rarely see the name being abused by the powerful because Someone who wants to rule others simply cannot promote something that clearly 
indicates there should be no rulers. Indeed, there exist attempts at abusing the name, such as ["Anarcho" capitalism](ancap.md), but we observe the shear abs 

spotted by most people who know what the word *anarchism* means. 


urdity of such attempt is quickly 


*See also [ND](nd.md).* 


In the context of. licenses] (license md the acronym NC stands for, *non-commercial* and means ently non-commercial use allowed", which is.an unpopular limitation that makes such a license **by 
definition [propri tary] (pr prietary.md) (i.e. NOT a [free cultural](free culture.md) license)**. This means that a work shared under a license with NC clause is prohibited from being used 
commercially (which itself is a very unclear statement), great ly limits the freedom of such work and opens the door for legal fuzziness and therefore possible bul ing: The NC limitation appears 
most notably in two [Creative Commons](creative_commons.md) licenses: CC BY-NC-SA and CC BY-NC-ND; again, despite these licenses being Creative Commons, they are **NOT [free as in freedom] 

(free culture md) icenses -- note that this is not an opinion or controversial statement, NC licenses very clearly break the consensual definition of free cultural works and Creative Commons 
themselves clearly state this is the case; they justify NC licenses as part of the proprietary-free license Spectrum, standing somewhere in between "all rights reserved" and free cultural 
licenses, Even though to free culture newcomers NC licenses don't seem like such a big deal, they are in fact extremely [harmful](harmful.md) to free culture, **DO NOT USE NC LICENSES**. NC is 
similar (and similarly harmful) to another proprietary license limitation: [ND](nd.md) (no derivatives allowed). 


**Why are NC licenses bad?** Firstly the *Definition of Free Cultural Works* project that maintains the widely accepted definition of free culture has an article on this: 
https://freedomdefined.org/Definition. Let us write a summary of the arguments ALONG WITH [our own](lrs.md) arguments: 


- **"Commercial use" isn't just selling, it, possibly prohibits beneficial uses you would want to allow.** Imagine. you create Ses an educational image that.you would like many, people to see -- 
by using an NC license you will however prohibit for example other people from Showing the image on social media if they are pedple who make money from social media, for example YouTubers that 
make money from ads on their videos will be prohibited (or at least greatly discouraged) from showing your educational image in their videos, you may also rule out use by ethical non-profits who 
still need to make some money to sustain themselves etc. Of course, the author may allow commercial use in individual cases and "on the go", in the Spirit of [permission culture] 

(permission culture.md), however this may be practically impossible in cases of big collaborative works similar to e.g. [Wikipedia](wikipedia.md) with possibly thousands of authors. 

- **It is very unclear, what commercial use, means which opens.door to. legal fear and avoidance of NC works.** "Commercial. usę" may be interpreted not just as directly selling the work but as 
doing pretty much anything with the work that somehow, even indirectly, leads to some kind of profit -- consider e.g. printing an NC picture on your Shirt (allowed by the NC license) and then 
wearing that shirt while promoting something you're selling -- if such shirt could be seen as helping you get attention of more customers and so result in making more money, you're potentially 
violating the license and the author can sue you. I.e. by using NC works you will always have to worry to not come close to anything that could be seen, even by a stretch, as a "commercial use". 
This is à worry that will exist as long as copyright on the work, i.e. certainly for your whole life. For this reason people simply avoid using such works and even choose to use lower quality 
works that don't pose such dangers. Using an NC license will therefore make your work much less popular, less visible and, of course, much less useful. 

- **It makes the work incompatible with other licenses.** Works under NC license cannot be included in free cultural works, for example text written on the Citizendium encyclopedia (licensed NC) 
cannot be copied to Wikipedia (licensed free under CC-BY-SA). 

- **It adds huge legal bloat] (bloat md) ^ Similarly to e.g. [cop teft] (copyleft md], the NC clause has to either be very vague and unclear or extremely long and complex in explaining what it 
really means. This Of course leads to unclarities, légal bugs, contusion, payments of lawyers etc. 

**It strengthens the idea of [intellectual property] (intel lectual_property.md) ; ^ The basic aim of free culture is to relax "intellectual roper ty. laws, not to strengthen them or continue the 
ways of [permission culture](permission culture.md), therefore the strict NC limitation is very unpopular among proponents of free culture. We, [LRS](lrs.md), strongly reject the very idea of 
being able to own information, so stricter legal conditions are always worse in our view. 

- **NC license may be in some.cases worse than no license at all.** Even though Creative Commons NC licenses give basic, rights such as that for non-commercial sharing, the explicit prohibition 
of commercial use may in specific cases result in more harm than if there was no license attached to the work, because breaking a rule that's stated explicitly may in court be seen as a bit more 
serious and intentional than breaking an implicit rule. (Similar reasoning was used to reject [CCO](ccO.md) by [OSI](osi.md).) 


*See also [NC](nc.md).* 


In the context 9f, [Licenses] (License. md the acronym ND stands for *no derivatives* and. means,"no derivative works allowed" -- this is an unpopular limitation that makes such a license **by 
definition [propri tary] (proprietary md (i.e. NOT a [free cultural](free_culture.md) license)**. A work licensed under a license with ND clause -- most notably the [ce BY-NC-ND](cc by nc nd.md) 
license -- prohibits anyone from making derivative (i.e. modified) works from the original work, on grounds of [copyright](copyright.md), which goes against one of the very fundamental ideas of 
free culture](free culture.md) (and just any sane culture), that of free remixing] (remix md). improvement, combining and reuse of art|(art md]; it kills artistic freedom, [culture 
culture.md), opens the door to egal bullying and strengthens the [harmful](harmful.md) [capitalist](capitalism.md) idea of "[intellectual property](intellectual property.md)". All in all **ND 


icenses are [cancer](cancer.md), NEVER USI 


The ND clause is similarly harmful to the [NC](nc.md) (non-commercial-only) clause -- see the NC article for more detail. 
T netstalking.md ---------- 
& Netstalking 


Netstalking means searching for obscure, hard-to-find and,somehow valuable (even if only by its entertaining nature) information buried in the depths of the f 
networks), for example searching for funny photos on Google Streetview (https://9-eyes.com/), unindexed [deépweb](déepweb.md) sites or secret documents on [F 
y 


et aja nEeroet. md and, similar 
m 
relative unknown in the English-speaking world but is pretty popular in Russian communities. 


servers. ORRE ET TS: 


Netstalking can be divided into two categories: 


- **deli-search** (deliberate search): trying to find a specific information, e.g. a specific video that got lost. 
**net-random**: randomly searching for interesting information in places where it is likely to be found. 


Techniques of netstalking include, port scanning, randomly generating web domains, using advanced search queries and different [search engines](search engine.md), searching caches and archives 
and obscure networks such as [darknet](darknet:md) or [gopher](gophér.md). 

l1 neural network.md ---------- 

# Neural Network 


{ Not my field, learning on the go, watch out for errors! -drummyfish } 


In. [artificial intelligence] (ai md) a neural network (also *neural net* or just NN) is a.system_ simulating natural biological neural network, i.e. a biological system found in [tiying organisms] 
(life.md), most importantly in our [brain](brain.md). Neural networks are just another kind of [technology] (tech. md) inspired by nature's ingenuity -- they M to mimic and simulate the 
naturally evolved structure of systems such as brain in hopes of making computers learn and "think" like living beings do, and in recent years they started achieving just that, with great 
success. Neural network are related to the term [deep learning](deep learning.md) which basically stands for training multi-layered neural networks. 


Even though neural networks absolutely aren't the only possible model used in [machine learning](machine learning.md) (see e.g. [Markov chains](markov chain.md), KENN] (kann. md), [support vector 
machines](svn md , +++), they seem to be the most promising one -- nowadays neural networks arë experiencing a boom and practically all AI reséarch revolves around them; they already made their 
way from research to practice, not only do the play games such as [Chess] (chess md) on superhuman Level, they already create extremely complex art and show some kind of understanding of 
pictures, video, audio and text on a human level (see [chatGPT](chat gpt.md), Stock fash] (stockrash.md); stable diffusion etcetc.) and even surpass humans at specialized tasks. Most importantly 
of course people use this for generating [porn](porn.m "n see e.g. [deepfakes](deepfake.md). The exceptional results are already being labelled " 

e 


scary" due to fears of [technological 
singularity](tech singularity.md), "taking jobs", possil "unethical uses" etc. 


**Currently neural networks seem to be bringin back anatog](analog,md) computing.**_ As of 2023 most neural networks are still. simulated with [digital] (digital.md) computers, but due to the 
fact that Such networks are analog and parallel in nature t digitàl approach is inelegant (we make digital devices out of analog circuits and thén try to make thém behave like analog devices 
again) and inefficient (in terms of energy consumption). Therefore analog is making a comeback and researchers are experimenting with analog implementations, most notably electronic (classic 
electronic circuits) and photonic (optics based ones. Keep in mind that digital and analog networks are compatible; you can for example train a network digitally and then, once you've found a 
Satistyin Co ETE ome Loa) it as analog so that you can e.g. put it in a cellphone so that it doesn't drain too much energy. Analog networks may of course be embedded in digital devices (we 
on't need to go fu analog). 


**[Hardware](hw.md) acceleration of neural networks is being developed.** Similarly to how [oes] (apu me) arised to accelerate computer [gra| hics](graphics md) during the 90s video game boom, 
similar hardware is arising for accelerating neural network computations -- these are called **[. Becelerators](ai accelerator md)** notably e.g. Google's [TPU](tpü.md) (tensor processing 
unit): Currently GPUs are Still mostly used for neural networks -- purely software networks are too slow. It is possible that future neural network hardware will be analog-based, as mentioned 
above. 

## Details 


At the highest level neural network is just a [black box](black box.md) with *N* real number inputs and *M* real number outputs. For example we may have input values such as *age*, *height*, 
*weight*, *blood pressure*, and two output values, one saying the expected years to live and the other one saying the confidence of this prediction. Inside this box there is network of neurons 
that we can train (adjust with different learning [algori Ama (algorithm md) so that it transforms the input values into output values in a correct way (i.e. here makes useful predictions). 


Note that a traditional feed-forward neural network is just a network similar to e.g. a simple [logic circuit {to ic_circuit.md), it is NOT a universal [Turing complete (turing_completeness.md) 
[model of Computation] (mode lof. computation md) like [Turing machine | (Curing machine .md) or [lambda calculus]({tambda_calculus.md) because it cannot for example perform loops or take arbitrarily 
sized input (the number of input values is fixed for given network). Neural network just takes the input numbers and in a certain fixed time (which theoretically doesn't depend on the input) 
runs it through the network to obtain the output numbers, i.e. it's best to view it as approximating a_mathematical [function](function.md) rather than interpreting an algorithm. Of course, a 
neural network itself can be (and in practice is) embedded in a more complicated system that can do all the above, but in its simple form it's just a bunch of connections between inputs and 
outputs. 


TODO 


## History 
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T newspeak.md ---------- 
# Newspeak 


Newspeak is_a modified form of natural language (e.g. [English] (english md) ) twisted for the purpose of thought control of mass population, with L5gpagendal Topaganda .md) and ideology built in 
so as to affect thinking of people in a ways desired by the rulérs of sociéty. Newspeak was first described in the story of George Orwell's 1949 Dook called inetéen Eighty Four ptas .md) and 
it is now being implemented in the [real wor id] (irl. md), especially since about the end of 20th century, by the [pseudoleft](pseudoleft.md) and capitalists (i.e. [liberals](liberal.md)). 
Refusing to use newspeak is labeled [thought crime](thought crime.md), wrongthink, [hate speech](hate speech.md) or psychological [disorder](disorder.md) and punished either officially by . 
government or unorticially by society-approved and state-tolerated lynching (so called (caheet ling}(caneel eultüre miis So called "[hate speech](hate_speech.md)" is now punishable by law in 
most first wor countries. 


Real world newspeak is characterized by banning certain keywords, for example so called glured(sjur md) such as lig er] (nigger md)r faggot faggot md) or [retard] (retard md), as well as 
forcing [political correctness](political_corréctness.md "gender neutral nouns", replacing "man" with’ "person" tes inventing [éuphemiSms](euphemism.md) for [harmful](harmful.md) and 
oppressive concepts ([copyright (copyright md) instead of copyrestriction, [moderation](moderation.md) instead of [censorship | (censorship md) etc.), redefining the meanings of existing terms 
such as [racism] (racism.md) Vorigina ly hating people of certain race, now anyone who disagrees with mainstream pseudoleft ideology), [homop obia](homophobia.md) (originally hating gay people, 
now anyone who isagrees with pseudoleft ideology regarding LGBT] (lgbt .md) ), [rape](rape.md) (originally sexual violence, now any action taken by man towards a woman) and inventing completely 
new terms such as [hate speech](Rate speech md) and [sanism](sanism.md) serving for eliminating ideological opposition and suppression of [free speech](free speech.md 

-- niger.md --- 


*Not to be confused with [nigger](nigger.md).* 

Niger is an African country with a racist name. 

How long before [SJWs](sjw.md) rename it [LMAO](lmao.md)? 
## See Also 


- [Chad](chad.md) | 
T niggercoin.md ---------- 
# Niggercoin 


Niggercoin (abbreviated NGR) is a [cryptocurrency](crypto.md) invented by [4chan](4chan.md). 
LII nigger.md ---------- 


*Not to be confused with [Niger](niger.md).* 


Nigger.(also nigga, niBBa, N-word, negr 
igge Cao niggas, DIBBA, notare. Tee 
afraid to say. 


negroid or chimp) is a forbidden word that refers to a member 
u 


f of the [black] (black. md) [ra 
rpart targeted on white people is *[cracker](cracker.md)*. To Ha ê wi 


ce](race.md SJWs](sjw.md) call it a, [politically incorrect 
rry Pott fans th ord "n be md nab beh } [p Y leor 


t 
H ed t e wofd Voldemort which everyone is jus 


Let us remind new readers that we, [LRS](lrs.md), love all living beings, even black people «3 But we do not support [political correctness](political correctness.md). 


The word is used in a number of projects, e.g.: 


b Linux for Tage eed e [erveeccarrency] ( aye 

niggercoin] (niggercoin.m cryptocurrency](crypto.m 

dd INTEGER] (P usnigger.nd) Teche modifier thak uses this politically incorrect term to prevent corporations from adopting free projects. 
**[Gay Nigger Association of America](gnaa.md)** (GNAA): what the name says 


JEMO { Lmao, md) they're even censoring art and retroactively changing classical works of art to suit this [nguspegk] (newspeak. md), just like all previous oppressive regimes. E.g. Agatha 
hristie's book *Ten Little Niggers* was renamed to *And Then There Were None*. Are they also gonna repaint Mona Lisa when it somehow doesn't suit their liking? 


LOL take a look at chis website: http://niggermania.com. Also https://www.chimpout.com. Also this lol https://encyclopediadramatica.online/Niggers. 
Ll noise.md ---------- 
# Noise 


Noise in general is.an_undesirable [signat] (signal,md) that's mixed. in with useful signal and which we usually, try to filter out, even though it can also be useful, especially e.g. in 

[procedural generation] (procgen md) s Typical example Of noise is flickering or static in video and audio signals, but it can also take a form of e.g. random errors in transferred texts, 

irrelevant links in web search results or imperfections in measuring of economic data. In measurements we often talk about [signal to noise ratio](snr.md) (SNR) -- the ratio that tells us how 

much noise there is in our data. While in engineering and scientific measurements noise is almost always something that's burdening us (e.g. [cosmic microwave background](cmb.md), the noise left 

over from the [Big Bang](big bang.md), may interfere with our radio communication), in some fields such as [computer graphics] (graphics md) (and other computer fart} (art md) or [eryptography] 
ex 


(cryptography md) we sometimes try to purposefully generate artificial noise -- e.g. in [procedural generation](procgen.md) noise is used to generate naturally looking terrain, clouds, ures 
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*2D binary white noise* 
## Artificial Noise 


In [computer science] (comps¢i md), especially §-4: in [computer graphics](graphics,md) or audio generation, we often want to generate artificial noise that looks like real noise, in order to be 

able to generate data that look like real world data. Noise may Serve as à basis (fir$t step, random initial state) for generating something or it may be used to distort or modulate other data, 

for example when drawing geometrical shapes we may want them to look as if written by hand in which case we want to make them imperfect, add a bit of noise to an otherwise perfect shape a A 

computer would create. Ad ing noise can help make rendered pictures look more natural, it can help us model human speech that arises from noise created by our vocal cords, it can help AI train 
e 


itself to filter out real li noise etc. 


Normally we don't want our noise to be completeU fandom (randomness.md) but rather **[ pseudorandom] (pseudorandomness .md) t so that our programs stay [deterministic](determinism.md). Imagine 
for example we are generating terrain thelgntmap ( eightmap.md) based on'a 2D noise -- such function was truly random, the terrain in à cértain plàcé would be différent every timé we réturned 
to that place again, but if the noise is pseudorandom ([seeded](seed.md) by the position coordinates), the terrain generated at any given coordinate will be always the same. 


There are different types of noise characterized by their properties such as number of dimensions, [frequencies](frequency.md) they contain, [probability distribution](probability.md) of the 
values they contain etc. Basic division of noises may be this: 


- by type/[algorithm](algorithm.md): : * 2 N : n f - à i $ 
aterat The simplest type of noise, it arises by generating a (pseudo)random value at each node of the spatial grid. Values in between grid nodes are obtained by [interpolation] 
interpolation.md). 

- **gradient noises**: More sophisticated than value noise, rather than a simple value it generates a [gradient](gradient.md) at each grid point. Specific algorithms/types of gradient noise 
are: 

- **[Perlin noise](perlin noise.md)**: One of the most common and basic gradient noises, which however suffers from some [artifacts](artifact.md). 

ihe ond timplex noise](simplex noise.md)**: A more sophisticated noise than Perlin noise, improves some of its properties, works with a [simplex](simplex.md) lattice of points rather than 

orthogonal grid. 


- **Spectral noises**: Noises that are generated in the Lspeetrat domain](spectrum md) (see [Fourier transform](fourier transform.md)): 7 x 
- **[anisotropic noise](anisotropic noise.md)**: Noise that has a specific orientation, can be used e.g. for water waves that go in one direction. 


- **[convolution](convolution.md) noises**: Noises that use [convolution](convolution.md) of given kernel with some simpler noise to create a larger texture. 
- **[Gabor noise](gabor noise.md)** 
- other: 

- **[Voronoi](voronoi.md) noise**: Noise.that looks like a "honeycomb" or structures created by living, çellş, it is created by generating random point coordinates and then assigning each 
space point (e.g. each pixel) a [distance](distance.md) to its closest point. Different random [point SámBiing](boint sampling md) Methods of distance functions can help change the look of the 
noise. Worley Noise is one type of Voronoi noise. 

- Combinations and modifications of standard noises: we may e.g. blend or [modulate](modulation.md) two noise functions to create a new complex type of noise. 

- **[midpoint displacement ](midpoint_displacement.md)/[diamond square] (diamond_square.md)**: Relatively simple [algorithms](algorithm.md) for generating [fractal](fractal.md) heightmaps, 
working on the principle of repeatedly subdividing a line (or in higher dimensions a square, cube etc.) and (pseudojrandomly displacing the generated point. 

- **[wavelet noise](wavelet noise.md)**: Noise further improving some characteristics of Perlin noise. 

- unorthodox noises created e.g. by [cellular automata](cellular automaton.md), AI etc. 


* 


- by frequencies: 


- **[fractal noise] (fractal_noise md)": Very important type of noise that similarly fo, [fractals] (fractal md) is, composed of differently scaled versions of itself -- this noise looks like 
and cán be used to Simulate) clouds, mountains and other structures found in nature. It i$ created by taking sóme basic noise function (e.g. Perlin noise or simplex noise) and overlaying 
adding) multiple versions of it that differ by frequency and amplitude (just as e.g. mountains are composed of big and tall hills that have on them progressively smaller and less tall hills up 


to the microscopic level). These different individual layers are called octaves: *i*th octave has the amplitude *p^i* (where *p* is a constant from 0 to 1 called a persistence) and frequency of 
2^i*. 
- or [anite noise](white noise)**: Noise containing "same, amount of all frequencies".-- this is basically the simplest kind of noise we get when we generate a sequence of independent 
([uncorrelated](corrélation.md)) (pseudo)random numbérs with uniform probability distribution. 
- **[pink noise ink noise.md)**: Energy density of frequencies decreases proportionally with 1/frequency, i.e. it basically has strong high frequencies and weak low frequencies. 
** [blue noise lue noise.md)** 


- by other roperties: 

..- **symme Ty/invarienee ^ and other function properties: A noise may or may not be invariant against various operations such as shifting, rotation or scaling, i.e. when we apply this operation 
it will look basically the same. For example Perlin noise outputs valüe 0 at each grid point and is non-zero only between the grid point, So it is NOT invariant towards shifting. Noise functions 
are just mathematical [functions](function.md), so we may examine noises just as we examine functions (they may be continuous, bounded etc.). 


- **explicit vs implicit**; Values of an implicit noise can relatively simply and quickly be computed at any given point in space whereas explicit noises require processing as a whole and 
therefore storage of the whole generated noise in memory. 


- **tiling**: Similarly to [procedural](procgen.md) [textures](texture.md), a noise generated by an algorithm may be tiling, i.e. not having visible seams when repeated in certain dimensions. 
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fractal noise 


*1D fractal noise composed of 3 octaves* 
T1 nokia.md ---------- 


TODO 


Kids today will absolutely NOT remember what Nokia did with phones back then, the richness, amazing creativity, fun, [Appts] (apple ma)? WIE, that's, like absolute nothing, Nokia was absolutely 
dominating the shit and coming up with INSANE designs you wouldn't believe. The guys must have beeñ smoking some shit a dày, they were like what haven't we done yet? Let's put the buttons all 
over the shit, let's make it round, let's make it fat, let's make the phone a literal square, let's make it a handheld console. And it worked, it was freakin art, everyone loved it, each phone 
was unique like, even with different [GUI](gui.md) and everything. It was beautiful. 


{ IMHO the peak of Nokia was 6600. Just look it up, I've never seen such beautiful design, AND it was such a high tech device back them, unreachable for a kid like me. Just the idea of having a 
real computer with an operating system in a pocket, with games, even a freaking video camera to shoot videos with, that was absolutely unreal to me. I wanted it so badly, I wanted it more than 
anything else. I had dreams about it. I also extremely enjoyed comparing it to the biggest competition Siemens SX1, that was a great device too. It was like a clash of two bosses. ~drummyfish } 


{ Also I remember I was once kicked out of a cell phone shop because they had 6600 there for customers to try it out and I was spending hours playing some LOTR games on it xD I remember it like 
oday, it kind of marked me. -drummyfish } 

T no knowledge proof.md ---------- 

# No Knowledge Proof 


{ I found the idea here https://suricrasia.online/no-knowledge.html, the page claims it comes from a Twitter user @chordowl. -drummyfish } 


In the context of [cryptography] (cryptography md) *no knowledge proofs (NOT to be confused with [zero knowledge proof] (gero-knowledge- proof .md) ) isa mathematical, [proof | (proof .md) of not 
knowing certain information. A he moment it seems to be kind of a [fun](fun.md) idea and curiosity without much use, but in math many fun ideas have found a serious usé later on, so who knows. 
{ If anyone knows of a legit use, let me know. ~drummyfish } 


The principle is this: supposed we have a one way, (practical ly irreversible) [hash] (hash md) function *H* (such.as [SHA-290] (sha-256.md)). Also suppose we have all agreed on a special value *y* 

that's non-zero and has been constructed so that it most likely doesn't havé any malicious properties, i.e. it is a sọ call *nothing üp my sleeve* value and can be for example some sentence 

esr Een a ASCII -- more detail on this will follow later, now simply suppose we have some value *y*. Now by providing someone with a number *x* we prove we don't know a value *z* such that 
Z) = h(x) xor y*. 


How can this work? Well, imagine we knew *z* and we wanted to prove we didn't know it. We can compute *h(x)*, (un)xor it with *y*, but now to compute *x* we'd have to reverse the hash *h*, i.e. 
compute *x = h^(-i)(h(z) xor y)*. And from the definition of the hash we can't do this. 


Another possible intuitive explanation: basically we have a system here that creates pairs of numbers -- for any two numbers *x* and *z* the system defines whether they're linked or not (via the 
equation *h(z) - nix) xor y* The point is that given one of these numbers it is practically impossible to derive the other one due to the difficulty of reversing the hash function, so if we 
show we know one number (*x*) we are really showing we don't know the other number (*z*) because we simply can't have both. 


So the point of the [Joke] (jokes md) is that we can't choose the information we want to prove we don't know, but that's kind of logical as if we could, we would know it. We simply pick a number 
*x* and so prove we don't know some random number *z* with some properties related to *x* and *y*. 


A small vulnerability lies in the value *y* which is why it needs to be established carefully. We can't just accept someone else's *x* as a proof if it comes with a randomly lookin TY because 
then the proof may hàve been forged. How? Well, suppose there's been no “Ye established; now again suppose we know some number *z* and want to prove we don't know it. We compute t) , then we 
randomly choose some number *x*, compute *h(x)* and now we simply derive *y* as *h(z) xor h(x)*. Now if someone accepts our *y* as valid, we have a forged fake proof as we know both the number 
*x*, i.e. a "proof" of not knowing *z*, but we also know *z*. So we have to make sure the one who is handing the pror (number *x*) did not pregenerate *y* this way. This opens up a possibility 
of attacking this proot by [brute forcing](brute_force.md) various *y* values, then taking those that somehow look "innocent" (e.g. by resembling some string or simple number sequence) and then 
trying to establish those as a legit *nothing up my sleeve* value. 


when graying about it, it's not really that curious we can construct a no knowledge proof, in math we prove that we can't know something all the time (e.g. [undecidable](decidability.md) 
problems). 

T1 normalization.md ---------- 

# Normalization 


Normalization is a term that can mean slightly different things but generally it either refers to adjusting a set of values to some desired range by multiplying or dividing each of the values by 
some predetermined number, or to converting some data or expréssion into a uhified format. The idea is to "tame" possibly very wildly differing values that we Can encounter "in the wild" into 
something more "normal" that we can better work with. The following are some specific meanings of the term depending on context: 


- re LvSetor (vector.md) normalization**: Making given vector into a unit vector by dividing all its components by the length of the vector, i.e. we keep the direction of the vector the same but 
forcé its léngth to be' exactly 1. 

- **signal normalization**: Adjusting the range of the signal to a desired range, for example with audio or images in which samples can range from -1 to 1 we may want to divide all the samples 
by the maximum of absolute values of all the Samples which will stretch the signal so that the peak exactly fits the range: this will fully utilize the range (e.g. increase contrast in images) 
without cutting the signal off. 

- TEIURI](uri md) normalization**: Converting URI into a unified format (e.g. "HTTP://www.MYSITE.COM:80/index.html^ to ^"http://www.mysite.com'). 

Ll npc.md ---------- 


NPC (nop: player character) is a character, in a.video game] (game md) that's not controlled by a player but rather by [AI](ai.md). NPC is also used as a term for people in [real life](irl.md) 
that exhibit low intelligence and just behave in accordance with the system. 

lI often confused.md ---------- 

# Often Confused Terms 


There are many terms that are very similar and are sometimes ged, interchangeably . This isn't wrong per se, a slight difference may be insignificant in certain contexts. However it's good to 
know the differences for those caSes when they matter. The following list tries to document some o he often confused terms. 


**[AI](ai.md)** vs "a machine learning](machine. learning.md)** vs **[neural networks](neural net.md)** 
di algebra (algebra m )** vs **[arithmetic](arithmetic.md)* 

**lalgorithm](àlgorithm.md)** vs **[program (program.md ** vs **[process](process.md)** 

T anatog] analog.md)** vs **[mechanical](mechanical.md)** 

**lanarchy nenm ** rS seen chaos.md)** 


M 


**[argument](argument.md)** vs ** arameter](parameter.md)** 
**larray](array.md)** vs "A [tst] ist.md)* 
**[ASCII art](ascii art.md)^* vs ANSI art](ansi art.md)** 
**lassembler](assembler.md)** vs ** assembly assembly.md)** vs **[machine code](machine code.md)** 
**Đinary** vs **[executable](executable.md) f i . | 
Ae Dug] tbug /md)* vs **[error](error.md)** vs **[exception](exception.md)** vs **[fault](fault.md)** vs **[failure](fail.md)** vs **[defect](defect.md)** 
** [causation (causation.md)** vs **[correlation](correlation.md)** 
**[cepstrum](cepstrum.md)** vs ao S pecErum| spectrum me) 
**lchaos](chaos.md)** vs **[randomness](random.md)** vs **[pseudorandomness](pseudorandom.md)** vs **[entropy](entropy.md)** 
**[class](class.md)** vs **[set](set.md)** 
**[close source](Closed source.md)** vs gel roprietary] (proprietary md)" 
**TCLI](cli.md)** vs **[TUI](tui.md)** vs * fterminat] (terminal emu ator.md)** vs **[console](console.md)** 
**[color model](color_model.md)** vs **[color space](color space.md)** 
**[Icommunism](communism.md)** vs ** Marxism](marxism.md)** 
**[computer language](computer language .md) vs **[programming langua: e] (programming. languat e.md)** 
**[computer.science](compsci.md)** vs **[information reehnotogy] (it may vs *informaties](informatics.md)** vs **[cybernetics](cybernetics.md)** vs **[computer engineering] 
computer engineering.md)** vs **[software engineering] (softwaré éngineefing.md)* 
**[concurrency](concurrency.md)** vs ** parettelismlt arallelism.md)** vs **[quasiparallelism](quasiparallelism.md)** vs **[distribution](distributed.md)** 
constant](constant.md)** vs **[litera literal.m he 
codin (coding .md)** vs **[programming ] (programming .md) ** 
codec](codec.md)** vs **[container format](container format.md)** 
coherence](coherence.md)** vs **[consistenc Jieonsistency may? 
computational model] (computational model md) vs **[model of computation](model of computation.md)** 
convolution](convolution.md)** vs ** correlation] (correlation md) 5 
copyright (copyright md) vs **[patent](patent.md)** vs **[trademark](trademark.md)** vs **[intellectual property](intellectual property.md)** etc. 
crossplatform/multiplat orm] (mul iplatform.md)** vs **[portable](portability.md) ** 
cryptography] (cryptography m y** vs inleeeuricy] (Secun cy md) 
data](data.md)** vs *[information] (in ormation.md)** vs **[entrop ](entropy.md)** vs **[signal](signal.md)** 
data structure] (data_structure.md) vs **[data type] (data. type. md) 
decentralized! ecentralization.md)** vs **[distributed ](distributed.md) ** 
) 


ae) 


* 


= 


declaration 4 eclaration.md)** vs definition](definition.md)** 
* ys **[intro](intro.md)** 
e d vs ** [window manager ] (wm.md) ** 
duck typing] (duck_typing.md)** vs * 
digita ] 
directe 
directory | (directory (folde be A d 
discrete **[discrete time Fourier transform](dtft.md)** 
ero Cenu ar onang) vs **[simulation (simulation.md)** i: 
s 


* 
* 


[inequality] (inequality.md)** 


**[evolutionar rogramming](evolutionary.md 
V a Mme nage? g]( y.md) 


**[eguality](equality.md)** vs ** identity] identity.md)** (in programming languages) 
**[floating point number](float.md)** vs real number](reàl number.md)* 
**[font](font.md)** vs * typeface typeface md FE 

framework](framework.md)** vs **[library](library.md)** 
cd iss ogy pgarej(treecsoftwars.md) *ys *t* (open source.md)** vs **[public domain](public domain.md)** vs **[source available](source available.md)** vs **[freeware] 
reéware.m 

**[geek](geek.md)** vs **[nerd](nerd.md)** 

**TGNU](gnu.md)/Linux** vs **[Linux](linux.md)** 


234 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


open source 


hé gradient noise] (gradient noise md ** vs **[value noise] (value_noise.md) ** ‘ 
y| othesis] (hypo hesis.md)** vs * theory] theory.md)** vs **[conjecture] conjecture.md) ** 
1B] (id) nd) vs **[token](token.md hash{(hash.md)** vs **[handle (handle .md) ** vs **[identifier] (identifier .md)** 
infinite] (infinity.md)** vs **[arbitrarily large/unbounded] (unbounded.md) 
Internet ](internet.md)** vs_**[web](web.md)** 
Java](java.md)** vs * .md)* 


** vs 


[JavaScript] REI 
kB/mB, 9B/ tB] (memory units.mo ** vs **[KiB/MiB/GiB/TiB](memory units.md)** 
Tatency/ping/ tag] ( atency.md ** vs **[ through, ut/bandwidth ] (Ehroughput md) ** 
leftism dri t right.md)** vs “*[pseudoleftism] Fz 


: pseudoleft.m 
license 


- license.md)** vs **[waiver](waiver.md)** 

- method method.md)* vs **[methodology](methodology.md)** 

- modem](modem.md)** vs **[router](router.md)** 

- **[NP](p vs np.md)** vs **[NP-hard](np hard.md)** vs **[NP-complete](np. complete.md)** 
- paging](paging.md)** vs **[virtüal memory](virtual meémory.md)** 

- path racing] (pat | tracing.md)** vs **[ray tracing] (ray-tracing.md)** vs **[ray casting](ray casting.md)** 
- pointer](pointer.md)** vs **[reference ya 

- principal square root](principal sgrt.m VS 
- probability (probability smd). vs **[probability 
- pseudo] (pseudo.md)** vs ** [quasi (quasi.md)** 

- eese mal: vs 


(sterenee m t](sqrt.md)** ( ially when defining [i](i.md)) 
vs square root](sqrt.m especia when defining [i](i.m 
è Teguare reog Ability density md)** d 


+e yg ** 
ae VSS? RUT (ut 
URL] (url.md)** 
webpage] (webpage.md)** vs ** [website] (website.md)** 
[overflow] (overflow.md)** 


science 


science .md 
Unicode 


unicode .md 


soyence 


* [shadows] (shadow.md) ** 
soyence.md)** 
may? 


# Old 


Nowadays old correlates with better. For comparison of new and old see [modern tech](modern.md). 
Ll one.md ---------- 


One (1, also a *unit*) is the first positive whole number, signifying the existence of a single unique thing we're counting. 
Some facts about this number include: 


- It is an [odd](odd.md) number. , i i 

- It is a positive number, whole number (integer), [real number](real number.md), [rational number](rational number.md) and [complex number](complex number .md). 

- It is by convention NOT a [prime number](prime number.md), though it is only divisible by 1 and itself. 

- It is a multiplicative identity, i.e. *1 * x = x* for any number *x*. Also *x / 1 = x*, *x^i = x*, *1^x = 1* for any number *x*. 

- In programming there is a very common type of [bug] (bug imd) called *[off by one](off by one.md)* in which a boundary is either incorrectly included or excluded. 
- 1 is often a Convenient upper bound of many intervals, e.g. when [normalizing](normlization.md) numbers or dealing with [probabilities](probability.md). 

- In computing the number and digit 1, as opposed to [0] (zero.md), usually means the *true* or *on* value. 

- In programmin operations with 1 (similarly, to [O](zero.md)) are very common and.may.sometimes be handled as special cases to help efficiency, for example adding or subtracting one is called 
incrementing and decrementing and many [assembly]{aSsembly.md) languages have special instructions for this. 

T oop.md ---------- 

# Object-Oriented Programming 


*"I invented the term ‘object oriented' and [C++](cpp.md) was not what I had in mind"* --[Alan Kay](alan kay.md), inventor of OOP 


Object-oriented programming (00P, also object-obsessed programming) is a [programming paradigm] (paradigm md) that tries, to model reality as a collection of abstract objects that communicate with 
each other and obey some specific rules. While the idea itSelf isn't bad and Can be Useful in Certain Cases, **OOP has become extremely overused, extremely badly implemented and downright forced 
in programming languages** which apply this [abstraction] (abstraction md) to every single program and concept, creating fanti-patterns}(anti_pattern.md), unnecessary issues and of course [bloat] 
(bloat.md). We therefore see OOP as a **[cancer](cancer.md) of software development**. 


Ugly, examples of OOP gone bad include [2avel (jaya. md) and [eral (epp. md) (which at least doesn't force it). Other languages such as [Python](python.md) and [Javascript](javascript.md) include OOP 
but have lightened it'up a bit and at teast allow you to avoid using it. 


You should learn OOP but only to see why it's bad (and to actually understand 99% of code written nowadays). 
## Principles 


Bear in mind. that. OOP doesn't have a single, crystal clear definition. It takes many forms and mutations depending on language and it is practically always combined with other paradigms such as 
the [imperative](imperative.md) paradigm, so things may be fuzzy. 


Generally OOP programs solve problems, by havipg quigPisetsl(objeet md ** that communicate with each other. Every object is specialized to.do some thing, e.g. one handles grawing text, another 
one handles [eachang (cache md) another one handles rendering of pictures etc. Every object has its **data** (é.g.' a human object has weight, [race] (race md) etc.) and **methods** (objects own 
[functions](function.md), e.g. human may provide methods ^getHeight', ^drinkBeer' or '^petCat'). Objects may send **messages** to each other: e.g. a human object sends a message to another 
object to get his name (in practice this means the first object calls a method of the other object just like we call functions, e.g.: ^human2.getName()'). 


human 


Now.many 00 languages use so called **class OOP**, In these we define object [classes] (class md). similarly to defining [data fypes] (data type mdp. A class is a "template" for an object, it 
defines methods and types of data to hold. Any object we then create is then created based on some class fe we create the object’ alice and ob' of class ‘Human’, just as normally we create 
a variable ^x^ of type 'int'). We say an object is an **instance** of a class, i.e. object is a real manifestation of what a class describes, with specific data etc. 


The, more "lightweight" type of OOP is called.**classless QOP** which. is usually based on having so called prototype objeçts instead of classes. In these languages: we can simply create objects 
without clasSes_and then assign them properties and methods dynamically at runti Here instead of creating a uman "class we rather create a prototype object that serves as a template for 
other objects. To create specific humans we clone the prototype human and modify the clone. 


oop furthermore comes with some basic principles such as: 


- **[enca sulation] (enca sulation.md)**: Object should NOT be able to access other object's data directly -- they may only use their methods. For example an object shouldn't be able to access 
the height attribute of a Human Object, it should be able to access it only via méthods of that object such as 'getHeight . (This leads to the setter/getter antipattern). 

- noB y mprphism] (polymorphism. md) ** : Different objects (e.g. of different classes), may have methods with the.same name which behave differently for either, object and we may just call that . 
method without caring what kind of object that is (the correct implementation gets Chosen at runtime). E.g. objects of both "Human and ‘Bomb’ classes may have a method 'setonFire , which with 
the former will kill the human and with the latter will cause an explosion killing many humans. This is good e-f: in a case when we have an array of [GUI](gui.md) components and want to perform 
e.g. resize on every one of them: we simply iterate over the whole array and call the method `resize` on each object without caring whether the object is a button, checkbox or a window. 

: niiQheritance (inheritance.md)**: In class QOP classes form a [hierarchy] (hierarchy md) in which parent Classes can have child classes, e.g. a class ‘Livingseing. will have `Human`_and . 
Animal’ subclasses. Subclasses inherit stuff from the parent class and may add some more. However this leads to other antipatterns such as the [diamond_problém](diamond_problem.md). Inheritance 
is nowadays regarded as bad even by normies and is being replaced by [composition](composition.md). 


## Why It's Shit 


-,00P is just.a.bad abstraction for many problems that by their nature aren't object-oriented. OOP is not a silver bullet (silver bullet.md), yet it tries to behave as one. **The greatest issue 
of OOP is that it's trying to solve everything**. For example it forces the idea that data and [algorithms](álgorithm.md) ould always come together, but that's simply a stupid statement in 
general, there is no justification for it, some data is simply data and some algorithms are simply algorithms. You may ask what else to use instead of OOP then -- see the section below. 

- For simple programs (which most programs should be) such as many [Unix](unix.md) utilities OOP is simply completely unnecessary. 

- OOP languages make you battle artificial restrictions rather than focus on solving the problem at hand. 

- Great number of the supposed "features" and [desi n abterns](design patrern md) setters/getters, singletons, inheritance, ...) turned out to actually be [antipatterns](antipatter.md) and 
burdens -- this isn't a controversial statement, evén DOP proponents usually agreé with this. 

- 00P as any higher abstraction very often comes with overhead, memory footprint and performance loss ([bloat](bloat.md)) as well as more complex [compilers](compiler.md), language 
specifications, more [dependencies l dependency md) etc. 

- The relatively elegant idea of pure.OOP didn't catch on and the practically used OOP, languages are abomination hybrids of amperative and QOP_paradigms that just take more {head space] i 
(head space md), create [trict Lon} (Friction.md) and unnecessary issues to solve. Sane langüagés now allow the choice to use OOP fully, partially or avoid it completely, which leads to two-in- 
one overcomplication. 

: The naive idea of OOP that the real world is composed of nicely defined objects such as ~Human’s and “Tree’s also showed to be completely off, we instead see shit like 
AbstractIntVisitorShitFactory etc. 

- The idea that OOP would lead to code reusability also completely failed, it's simply not the case at all, implementation code of, specific classes is typically, burdened with internal and 
external dependencies just like any other bloated code. OOPer believed that their paradigm would create a world full of reusable [otackboxes{ (btackbox P, but that wasn't the case, OOP is 
neither hecessar POE Plackboxing, nor has the practice shown it would contribute to it -- quite on the contrary, e.g. simple imperative header-only C libraries are much more reusable than those 
we find in the world. 

- Good. programmers don't need OOP because they know how to program -- OOP doesn't invent anything, it is merely.a way of trying to ie ee 0008, programming mostly on incompetent programmers 
hired ih companies, to prevent them from doing damage. However this of course doesn't work, a shit programmer will always program shit, he will find his way to fuck up despite any obstacles and 
if you invent obstacles good enough for stopping him from fucking up, your tt also stop him from being able to program something that works well as you tie his hands. Yes, good programmers write 
shit buggy code too, but that's more of a symptom of bad, overcomplicated bloated capitalist design of technology that's just asking for bugs and errors -- here OOP is trying to cure symptoms of 
an inherently wrong direction, it is not addressing the root cause. 

- OOP just mostly repeats what other things like modules already do. 

- If you want.to.program.in object-oriented way and have a good.justification for it, **you don't need an QOP language anyway**, you can emulate all aspects of OOP in simple languages like C. So 
instead of building the idea into the language itself and dragging it along forever and everywhere, it would be béttér to have optional OOP libraries. 

- It generalizes and simplifies Programming into.a few rules of thumb such as encapsulation, again for the sake of inexperienced noobs. However there are no simple rules for how to program well, 
good Brogramming requires a huge amount of experience and as in any art, good programmer knows when breaking the general rules is good. OOP doesn't let good programmers do this, it preaches 
things like "global variables bad" which is just too oversimplified and hurts good programming. 

## So Which Paradigm To Use Instead Of OOP? 


After many people realized OOP is kind of shit, there has been a boom of "OOP alternatives" such as [functional](functional.md), [traits](traits.md), [agent oriented programming] 
(agent_oriented_programming.md), all kinds of "lightweight"/optional OOP etc etc. Which one to use? 


In short: NONE, Faby default use the [imperative] (imperative md) paradigm** (also called "procedural"). Remember this isn't to #Y, you shouldn't ever apply a different paradigm, but imperative 
should be the default, most prevalent and suitable one to use in solving most problems. There is nothing new to invent or "beat" OOP. 


But why imperative? Why can't we simply improve OOP.or come up.with something ultra genius to replace it with? Why .do we say OOP is bad because it's forced and,now we are forcing imperative 
aradigm? The answer is that the **imperative paradigm is special because it is how Computers actually work**, it is not made up but rather it's the **natural low level paradigm with minimum 
[abstráction](abstraction md) that reflects the underlying nature of computers**. You may say this is just bullshit arbitrary rationalization but no, these properties makes procedural paradigm 
special among all other paradigms because: 


- Its implementation.is simple and [suckless](suckless md) / LRS](lrs.md) because it maps nicely and naturally to the underlying hardware -- basically commands in a language simply translate to 
one or more instructions. This makes construction of compilers easy. 

- It's predictable and efficient, i.e, a programmer writing imperative code can see guite clearly. how what he's writing will translate to the assembly instructions. This makes it possible to 
write highly efficient code, unlike high levél paradigms that perform huge amounts of [magic](magic.md) for translating foreign concepts to machine instructions -- and of course this magic may 
differ between compilers, i.e. what's efficient code in one compiler may be inefficient in another (similar situation arose e.g. in the world of [OpenGL](opengl.md) where driver implementation 
started to play a huge role and which led to the creation of a more low level API [Vulkan](vulkan.md)). 

- It doesn't force. high amounts_of unnecessary high level abstraction. This means.we MAY use any abstraction, even OOP, if we currently need it, gof: via a [library (library md), but we aren't 
FORCED to use a weird high level concepts on prop ems that can't be described easily in terms of those concepts. That is if you're solving a non-0OP problem with O! you waste effort on 
translating that problem to OOP and the compiler then wastes another effort on un-O0Ping this to translate this to instructions. With imperative paradigm this can't happen because you're 
basically writing instructions which has to happen either way. 

- It is generally true that the higher the abstraction, the. smaller its scope of application should be, so.the default abstraction (paradi m), should be low level, This works e.g. in science: 
psychology is a high level abstraction but can only be applied to study human behavior, while quantum physics is a low level abstraction which applies to the whole universe. 


Once computers start fundamentally working on.a different paradigm, e.g. functional -- which BTW might happen with new types of computers such as [quantum](quantum.md) ones -- we may switch to 
that paradigm as the default, but until then imperative is the way to go. 

## History 

TODO 

T openai.md ---------- 

& "Open"AI 


r AI 
(ai.md), known especially for practicing unethical [capitalist](capitalism.md) déCeption techniques such as heavy [openwashing](openwashing.md) (using the word *open* to make people think i H 


OpenAI.("open" as in,."not open") is.a.hugely fhargtyl harmful.md) [proprietary] (proprietary. md)/closed; source for profit [cor oration] (corporation md) researching and creating proprieta! 
i 
has something to do with "[open source](open source.md)") and non-profit-washing (hiding behind a similarly named non-profit so that it seems the corporation is actually non-profit). 
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---------- openarena.md ---------- 
# OpenArena 


openarena (9A) is a first goren arena shooter [game] (game md), a [frge as in freedom] (free. software md) [clone] (etong md) of the famous game Quake 3. It runs on [GNU](gnu.md)/[Linux](linux.md), 
[Winshit](windows.md), [BSD](bsd.md) and other Systems, it is quite light on system resources but does feQuire TOPU] (gpg ma) acceleration (no [software rendering](sw lenderiíng.md)). Quake 3 
engine ([Id tech 3](id tech3.md)) has retroactively been made free software: OpenArena [forked](fork.md) it and additionally replaced the proprietary Quake assets, such as 3D models, sounds and 
maps, with communityscreated Japanese nerds [waifu] (wad tu.md): themed pires culture](free culture.md) assets, so as to create a completely free game. openarena plays almost exactly the same as 
Quakes; it basical y just looks different ānd has different maps. It has an official [wiki](wiki.md) at https: //openarena.fandom.com and a forum at http://www.openarena.ws/board/. OpenArena has 
also been used as a research tool. 


As of version 0.8.8 there are 45 maps and 12 game modes ([deathmatch](deathmatch.md), team deatchmatch, [capture the flag](ctf.md), last man standing, ...). 


A bit of [fun](fun.md): you can redirect the chat to text to speech and let it be read aloud e.g. like this: 
openarena 2>&1 | grep --line-buffered ".*^7: ^2.*" | sed -u "s/.*: ^2N(.*X)/N1/g" | sed -u "s/N^.//g" | espeak 


Character art exhibits what [SJWs](sjw,md) would Gall high sexism. This is great, it's the good old [90s] (90s md) art, style. The art is yet nice_and professional looking (no programmer art). 
Characters such as Angelyss are basically naked with just bikini strings covering her nipplés. Other characters like Merman and Penguin (a typical "[Linux](linux.md) user") are pretty funny. 
Ratmod has very nice taunts that would definitely be labeled offensive to gays and other minorities nowadays. The community is also pretty nice, free speech is allowed in chat, no [codes of 

conduct](coc.md) anywhere, [boomers](boomer.md) thankfully don't buy into such bullshit. Very refreshing in the politically correct era. 


OpenArena is similar to e.g. [Xgnotic] (xonotic.md) -- another free arena shooter -- but is a bit simpler and oldschool, both in graphics, features and gameplay; It has fewer weapons, game modes 
ahd options. However there exist additional modifications, most notably the Ratmod (or RatArena) which makes it a bit more "advanced" (adds game modes, projectiles go through portals, improved 
predict ton: code etc.). As of 2022 an asset reboot in a more Anime style, called 0A3, is planned and it seems to be aiming in the right direction -- instead of making a "modern HD game" (and so 
asically just remake Xonotic) they specifically set to create a *2000 game* (i.e. keep he models low poly etc.). It could also help distinguish OpenArena from Quake more and so make it legally 
safer (e.g. in terms of [trade dress](trade dress.md)). 


$ I've been casually playing 0A. for .a while alongside Xonotic..I love both games. OA is more oldschool, boomer, straightforward and KISS, feels slower in terms of movement and combat but DM 
atches are much quicker, fragging is very rapid. -drummyfish } 


The project was established on August 19 2005, one day after the Quake 3 engine was freed. 
## See Also 

Xonotic](xonotic.md) 

clone](clone.md) 


l1. open console.md ---------- 
# Open Console 


- [onsteT Konotiem .md) 


H Open consoles are how I get into [suckless](suckless.md) programming, they taught me about the low-level, optimizations and how to actually program efficiently on very limited hardware. I 
ecommend you grab one of these. -drummyfish 


Open consoles (also indie handhelds etc,) are tiny [GameBoy (gameboy md). like [gaming] (game .md ) consoles mostly powered by [free Software] (free software md) and [free hardware]. 

( pee nardware md), which have relatively recently (some time after 2015) seen sma oom. Examples include faPduboyd (ar auboys md), [Pokitto](pokitto.md) ór [Gamebuino](gamebüino.md). These are 
*NOT** to be confused with the [Raspberry Pi](rpi.md) (and similar) handhelds that run GameBoy/PS1/DOS [emulators](emulator.md) but rather custom, mostly [FOSS](foss.m platforms running 
mostly their own community made homebrew} (homebrew. md) games. 


In summary, open consoles are: 


- po GameBoy Like gaming consoles** (but also allow and encourage non gaming uses). 
y 


- Powered may ood hardware] (free hardware md) and free so warelt ree Software.md)** (usually [Arduino](arduino.md) plus a custom library, although mostly advertised as [open source] 
(open source.mdj and not so strict about freedom). Schematics are a lot of times available. 
- **Retro**. 

**Indie** (sometimes developed by a single guy), often [crowd-funded](crowd. funding.md). 

**Educational**. 


**[DIY](dyi.md)**, sometimes leaving assembly of the kit to the customer (assembled kits can usually be ordered for extra price). 
**Very cheap** (compared to proprietary mainstream consoles). 

a (pack EA: ET, friendly**. 

Ty ically fenbed led] (embedded.md) [ARM](arm.md)**. 

* [Bare metal](bare metal.md)** (no operating system). 

Pretty **low spec** hardware ([RAM](ram.md) amount in kilobytes, CPU frequency in MHz). 

Relying on **user created games** which are many times also free-licensed. 


Recommended consoles for starters are [Arduboy](arduboy.md) and [Pokitto](pokitto.md) which are not only very well designed, but most importantly have actual friendly active communities. 


These nice little toys are great,because, they are anti-[modern (modern.md), [simple] (minimalism. md), Qut of the toxic mainstream, like the oldschool.bullshit-free, computers. This supports (and 
by the low specs kind of "fórces") [Sucktess) (suckless, d) pro ramming and brings thé programmer the joy of programming (no headaches of resizable windows, multithreading etc., just plain 
programming of simple things with direct access to hardware). They offer an alternative [ISA](isa.md), a non-x86 platform without botnet and [bloat](bloat.md) usable for any purpose, not just 
games. Besides that, this hobby teaches low level, efficiency-focused programming skills. 


## Programming 


Open consoles can typically be programmed without proprietary software (though officially they may promote something involving proprietary software), GNU/[Linux (linux.md) mostly works just fine 
jsometanes: it requires a bit of extra work but not much). Most of the consolés are [Arduino](arduino.md)-based so the Arduino IDE is the official development to with [C++](cpp.md) as à. 
anguage ([C](c.md) being thankfully an option as well). The IDE is "open-source" but also [bloat](bloat.md); thankfully [CLI](cli.md) development workflow can be set up without greater issues 
(Arduino comes with CLI tools and for other platforms [gcc](gcc.md) cross-compiler can be used) so comfy programming with [vim](vim.md) is nicely possible. 


If normies can do it, you can do it too. 


Some consoles (e.g, Arduboy, Pokitto and Gamebuino META) have their own [emulators {emulator md) which make the development much easier... or rather bearable. Without an emulator your re forced 
to constantly reupload the program to the real hardware which is a pain, so you wai to either use a nice [LRS](lrs.md) library such as Loar ] (saT md) or write your game to be platform- 
independent and just make it run on your development PC as well as on the console (just abstract the I/O and use SDL for the PC and the console's library for the console -- see how [Anarch] 


(anarch.md) does it). 
## Open Console List 


Some notable open consoles (which fit the definition at least loosely) are listed here. Symbol meaning: 


- (A Arduino 
UC great active community 
- recommended 
- many games/programs 
- discontinued 
name CPU RAM (K)| ROM (K)| display notes 
Arduboy] (arduboyzmd) 8b 16 MHz 2.5 32 64x32 1b * AC *, tiny 
Gamebuano] (game uino.md) 8b 16 MHz 2 32 84x48 1b +A -, SD 
Pokitto](pokitto.md) 32b 48 MHz 36 256 220x176 * C +, ext. hats, SD 
ESPboy] espboy md) 32b 160 MHz| 80 4000 128x128 A 
GB META] (gamebuino.md) 32b 48 MHz 32 256 168x120 A+ -, SD 
Nibble] (nibble.md 32b 160 MHz| 80 4000 128x128 A, AAA bat 
UzeBox] (uzebox.md 
Tiny Arcade](tiny arcade.md) 
Thumby] (thumby . md ) 
TODO: Retro Game Tiny, Adafruit PyGamer, ... see also https://github.com/ESPboy-edu/awesome-indie-handhelds 


## See Also 


- [fantasy console](fantasy_console.md) 
l1. open source.md ---------- 
# Open $ource 


*"[Micro$oft](microsoft.md) «3 open $ource"* 


Open, source (0S) is a [capitalist (capitalism.md) movement/brand forked from the [free software movement (free software.md); it is advocating "openness", sharing and collaboration in software. 
and hardware development and though legally it iS mostly identical to free (as in freedom) software, in practice and in spirit it is yery different by **abandoning the goal of freedom and ethics 
in favor of business** {to which ethics is an obstacle), due to which we see open source as inherently [evil](evil.md) and recommend following the free software way instead. [Richard Stallman] 
(rms.md), the founder of free software, distances himself from the open source movement. Fascist organizations such as Microsoft and Google, on the other hand, embrace open source (while 
restraining from using the term *free software*) and slowly shape it towards their goals. The term [FOSS](foss.md) is sometimes used to refer to both free software and open source without 
expressing any preference. 


Open source is unfortunately (but unsurprisingly) becoming more prevalent than free software, as it better serves, [capitalism (capitalism.md and. abuse of people, and its followers are more and 
more hostile towards the free software movement. This is Very dangerous, ethics and focus on actual user freedom is replaced by shallow legal definitions that can be bypassed, e.g. by 
[capitalist software](capitalist_software.md) and [bloat monopoly](bloat_monopoly.md). In a way open source is capitalism reshapin free software so as to weaken it and eventually make its 
principles of freedom ineffective. Open source tries to shift the goal posts: more and more it offers only an illusion of some kind of ethics and/or freedom, it pushes towards mere partial 
openness ("open source" for proprietary platforms), towards high complexity, inclusion of unethical business-centered features ([autoupdates | (autoupdate md), [DRM](drm.md), ...), high 
interdependency, difficulty of utilizing the rights granted by the license, exclusion of developers with "incorrect" political opinions or bad brand image etc. In practice open source has become 
something akin a mere **brand** which is stick to a piece of software to give users with little insight a feeling they're buying into something good -- this is called **[openwashing] 
(openwashing.md)**. This claim is great t supported by the fact that corporations such as [Microsoft](microsoft.md) and Teoogle} (google md) widely embrace open source ("Microsoft <3 open 
source", the infamous [GitHub](github.md) acquisition etc.). 


One great difference of open source with respect to free software is that **open source doesn't mind proprietary dependencies**: [Windows] (windows md) only programs or  igames | (game md) in 
[proprietary](proprietary.md) engines such as [Unity] (unity md) are happily called open source -- this would be impossible in the context of free software because as Richard allman says | 
software can only be free if it is free as a whole, it takes a single proprietary line of code to allow abuse of the user. The "open source" communities nowadays absolutely **don't care a bit 
about freedom or ethics**, many "open source" proponents even react aggressively to bringing the idea of ethics up. "Open source" communities use locked, abusive proprietary platforms such as 
[Discord](discord.md) and [Micro$oft's](microsoft.md) [GitHub](github.md) to create software and collaborate -- users without Discord and/or GitHub account often aren't even offered a way to 
contribute, report bugs or ask for support. 


The open source definition is maintained by the {Open Source [niriativelfosi,md) (ost) -- they define what exactly classifies.as open source and which jicenses](Ligense .md) are compatible with 
Tt. Tl ese licenses are mostly the same as those approved by the [FSF](fSf.md) (évén though not 100%). The open source definition is a bit more complex than that of free software, in a nutshell 
it goes along the lines: 


1. The license has to allow **free redistribution** of the software without any fees. 

2. **Source code must be freely available**, without any [obruscatson] (obfuscation: mé) 

3. **Modification of the software must be allowed** as well as redistribution of these modified versions under the same terms as the original. 

4. **Direct modification may be forbidden only if [patches] (patch.md) are allowed**. 

5. **The license must not discriminate against people**, everyone has to be given the same rights. 

6. **The license must not discriminate against specific uses**, i.e. use for any purpose must be allowed. 

7. **The license applies automatically** to everyone who receives the software with the license. . 

8. **The license must apply generally**, it cannot be e.g. limited to the case when the software is part of some larger package. 

9. **The license must not restrict other software**, i.e. it cannot for example be forbidden to run the software alongside some other piece of software. 
10. **The license must be technology neutral**, i.e. it cannot for example limit the software to certain platform or API. 


236 ADDITIONAL PAPER BACKUP OF DRUMMYFISH'S ORIGINAL WORK (2020-2024); Less Retarded Wiki 


## See Also 


- [openwashing] (openwashing.md) 

free software] (free_software.md) 
l2 operating system Qmd ---------- 
# Operating System 


Operating System (OS) is normally a hugely complex program that's typically installed before any other program and serves as a platform for running other programs as well as managing resources 
(CPU usage, [RAM](ram.md), [fileS](file.md), Thetwork} (ne work md) 1 ...) and offering services and interfaces for humans and programs. 


There is a nice [CCO](ccO.md) wiki for OS development at https://wiki.osdev.org/. 


From programmer's point of view a serious OS is one of the most difficult pieces of software gne_can pursue to develop. The task involves an enormous amount, of [tow level) (tow. level md) 
Peoepi ter] re Ecrire design. tools from scratch and requires deep and detailed knowledge of all components of a computer, of established standards as well as many theoretical subjects such as 
compiler] (compiler . mi esign. 


An OS, as a software, consists of two main parts: 


*: The base/core of the system, running in the most privileged mode, offering an environment for user applications. 
a9 (applications)**: The set of programs running on top of the kernel. These run in lower-privileged mode and use the services offered by the kernel via so called 


- s. [user tan kernelimd)" 
[sys i 


**[user land] (user lani 
em calls 


syscall.m 
For example in GNU/Linux, [Linux](linux.md) is the kernel and [GNU](gnu.md) is the userland. 

## Attributes/Features 

TODO 

## Notable Operating Systems 

Below are some of the most notable OSes. 

Faso) bad nd) system) such as [OpenBSD](openbsd.md) and [freeBSD](freebsd.md): Unix-like OSes 


Collapse OS](collapseos.md) 
cual tage md , [FreeDOS] (freedos.md) 


GNU] (gnu.md)/[Linux Clank md) systems encompassing many [distributions](distro.md) 
Inferno](inferno.md): OS in the style of Plan 9 

MacOS] (macos .md 

Minix](minix.md 

Plan 9 


plan9.md): research OS, continuing the ideas of [Unix](unix.md) 
React0S](reactos.md) 

Replicant](replicant.md) 

Solaris](Solaris.md) 

UR ton (tem leos.md): simple [meme](meme.md) OS written by a [Terry Davis](terry_davis.md) 

Unix] (unix.m 

Windows ](windows.md): very bad roprietar roprietary.md capitalist](capitalist software.md) OS 
rone I Ustront md]: Os Baked ATE 9 yl(prop y ) [cap l(cap ) 
T optimization.md ---------- 

& Optimization 


optimization means making a program more efficient in terms of consumption of some computing resource or by any similar metric, commonly aiming for greater execution speed or lower memory usage 
(but also e.g. lower powér consumption, lower network usage etc.) while preserving how the program functions externally. Unlike [refactoring](refactoring.md), which aims primarily for a better 


readability of source code, optimization changes the inner behavior of the executed program to a more optimal one. 


## General Tips'N'Tricks 
These are mainly for [C](c.md), but may be usable in other languages as well. 


**Tell Your compiler to actually optimize** (`-03`, ^;-Os' flags etc.). 

**[gprof](gprof.md) is a utility you can use to profile your code**. 

**'€stdint.h»' has fast type nicknames**, types such as "uint fast32 t' which picks the fastest type of at least given width on given platform. 

**Keywords such as ‘inline’, 'static' and 'const' can help. compiler optimize well**. 3 ED : r 

- **Optimize the [bottlenecks|(bott leneck.md) !** Optimizing in the wrong place is a complete waste of time. If you're optimizing a part of code that's taking 1% of your program's run time, you 
will never speed up your program by more than that 1% even if you speed up the specific part by 10000%. Bottlenecks are usually inner-most loops of the main program loop, you can identify them 
with [profiling](profiling.md). Generally initialization code that runs only once in a long time doesn't need much optimization -- no one is going to care if a program starts up 1 millisecond 
faster (but of course in special cases such as launching many processes this may start to matter). 

- **You can almost always trade space (memory usage) for time (CPU demand) and vice versa** and you can also fine-tune this. You typically gain speed by precomputation (look up tables, more 
demanding on memory) and memory with [CompreSsion](Compression.md) (more demanding on CPU). 

2% itatic](static md) things are faster, and smaller, than [dynamic] (dynamic md) things.** This_means that things that are somehow fixed/unchangeable are better in terms of performance (and 
usuatly also safer and better testable) than things that arẹ allowed to change during [run time](runtime.md) -- for example calting a function directly (e.g. myVar = myrunc(j - ) is both faster 
and requires fewer instructions than cal ting a function by pointer (e.g. 'myVar = myFuncPointer(); ): the latter is more flexible but for the price of performance, so if you don't need 
flexibility (dynamic behavior), use static behavior. This also applies to using [constants](constant.md) (faster/smaller) vs [variables](variable.md), static vs dynamic [typing](typing.md), 
normal vs dynamic [arrays](array.md) etc. 

- **Be smart, use fmath] (math md **. Example: let's say you want to compute the radius of a zero-centered [bounding sphere](bounding_sphere.md) of.an *N*-point {point Cloud] (point cloud md); 
Naively you might be computing the Euclidean distance Y-Xorc( R5 + y^2 + z^2)*) to each point and taking a maximum of them, however you can just find the maximum of squared distances (*x^2 + y^2 
* z^2*) and return a square root of that maximum. This saves you a computation of *N - 1* square roots. 
- **Learn about [dynamic programming](dynamic programming md)'*. 
- **Avoid branches (ifs)** if you,can (remember [ternary Operators] (ternary, operator .md), loop conditions etc. are branches as well). They break prediction in CPU, pipelines and instruction - 
preloadin and are preso source of great performance losses. Don't forget that you can many times compare and use the result of operations without using any branching (e.g. `x = (y == 5) + 1; 
instead of `x = (y == 5) ? 2 : 1; ^). 
- **Use iteration instead of [recursion](recursion.md ** if possible (calling a function costs something). 
- **Use [geod enough (good enough.md) [approximations (approximation md) instead of completely accurate calculations**, e.g. taxicab distance instead of Euclidean distance, capsule shape to 
represent the playér'$ collision shape rather than thé 3D model's mesh etc. With a physics engine instead of running the simulation at the same FPS as rendering, you may just run it at half and 
interpolate](interpolation.md) between two physics states at every other frame. Nice examples can also be found in [computer graphics] (graphics md) eag: some [software renderers] 
Sw rendering.md) use perspective-correct texturing only for large near triangles and cheaper affine texturing for other triangles, which mostly looks OK. 
- **Use quick.opt-out conditions**: many times before performing. some expensive calculation you can quickly check whether it's even worth performing it and potentially skip,it..For example in 
physics feottiston detections](collision_detection.md) you may irst quickly check whether the bounding spheres of the bodies collide before running an expensive precise collision detection -- 
if bounding spheres of objects don't collide, it is not possible for the bodies to collide and so we càn skip further collision detection. 
- **Operations on static data can be accelerated with accelerating structures** ([look-up tables](lut.md) for functions, [indices](indexing.md) for database lookups, spatial grids for collision 
checking, various [trees](tree.md) ...). 
- **Use powers of 2** r 2, 4, 8, 16, 32, ...) whenever possible, this is efficient thanks to computers working in [binary](Binary.md). Not only may this help nice utilization and alignment of 
memory, but mainly multiplication and division can be optimized by the compiler to mere bit shifts which is a tremendous speédup. 
- **Write [cache ty tend ly | (cache friendly md) code** (minimize long jumps in memory). 
- **Compare to [9] (zepocm ) rather than other values**. There's usua ly an instruction that just checks the zero flag which is faster than loading and comparing two arbitrary numbers: 3 

**Use [bit tric Ss] (bit hàckimd)^*, hacks for manipulating binary numbers in clever ways only using very basic operations without which one might naively write complex inefficient code with 
loops and branches. Example of a simple bit trick is checking if à number is power of two as '!(x & (x - 1)) && x`. 

- **Consider moving computation from run time to compile time**. E.g. if you make a resolution of your gane constant (as opposed to a variable), the compiler will be able to partially precompute 
expressions with the display dimensions and so speed up your program (but you won't be able to dynamically change resolution). 
- On some platforms such as TARM] Carm md), the first **arguments to a function may be passed via registers**, so it may be better to have fewer parameters in functions. 
- **Optimize when you already have.a working code**. As [ponatd Knuth](knuth.md) put it: "premature optimization is the root of all evil". Nevertheless you should get used to simple nobrainer 
efficient patterns by default and just writé them automatically. 
- **Use your own Gaches](cache.md) where they help**, for example if you're frequently working with some database item you better pull it to memory and work with it there, then write it back 
once you're done (as oppósed to communicating with the DB there and back). 
: **[Single compilation unit](single compilation unit.md) (one big program without [linking](linking.md)) can help compiler optimize better** because it can see the whole code at once, not just 
its part$. It will also make your program compile faster. 
- Search literature for **algorithms with better complexio Glass] (complexity,class.md ** ([sorts](sorting.md) are a nice example) ; . 2 n 
- For the sake of md) computers such as [embed ed] (embedded md platforms **avoid [f gating point](floating point.md)** as that is often painfully slowly emulated in software. Use [fixed 

[) 


point](fixed point.md), or at least offer it as a [fallback](fallback.md). This also applies other hardware requireménts such as [GPU](gpu.md) or sound Cards: while such hardware accelerates 
your program on computers that have the hardware, making use of it may lead to your program being slower on computers that lack it. 

" 2d Early branching](early_branching.md) can create a speed up** (instead of branching inside the loop create two versions of the loop and branch in front of them). This is a kind of space-time 
radéoff. 

- **Division.can be replaced by multiplication b [reciprocal] (reciprocal .md)**, i.e. *x / y.=.x * 1/y*. The point is that multiplication is usually faster than, division. This may not help us 
when performing a single division by variable valué (as we still have to divide 1 by *y*) büt it does help when we need to divide many numbers by the same variable number OR when we know the 
divisor at compile time; we save time by precomputing the reciprocal before a loop or at compile time. Of course this can also easily be done with [fixed point](fixed point.md) and integers! 
-.**Consider the difference between logical and bitwise operators itr For example [AND](and.md) and [OR] (or - md) boolean functions in C have two variants, one bitwise (`&` and, `|) and one logical 
(&&' and ||| ).-- they behave a bit differently but sometimes you. may have a choice which one to use, then consider this: bitwise operators usually translate to only a single fast (and small) 
instruction while the logical ones usually translate to a branch (i.e. multiple instructions with potentially slow jum Hn however logical operators may be faster because they are evaluated as 
[short circuit](short circuit eval.md) (e.g. if first operand of OR is true, second operand is not evaluated at au] while bitwise operators will evaluate all operands. 

.**Consider the pros and cons of using indices vs pointers**: When working with arrays you usually have the choice of using either pointers or indices, each option has advantages and 
disadvantages; working with pointers may be faster and produce smaller code (fewer instructions) ut array indices are portable, may be smaller and safer. E.g. imagine you store your game 
sprites as a continuous array of images in RAM and your program internally precomputes a table hat says where each image starts -- here you can either use pointers (which say directly the 
memory address of each image] or indices (which say the offset from the start of the big image array): using indices may be better here as the table may potentially be smaller (an index into 
relatively small array doesn't have to be able to keep any possible memory address) and the table may even be stored to a file and just loaded next time (whereas pointers can't because on next 
run The memory, addresses may be different), however you'll need a few extra instructions to access any image (adding the index to the array pointer), which will however most definitely be 
negligible. 

- **Reuse variables to save space**. A warning about this one: readability may suffer, mainstreamers will tell yoy you're going against "good practice", and some compilers may do this. 
automatically anyway. Be sure to at least maké this clear in your comments. Ahyway, on a lower level and/or with dumber compiler ou can just reuse variables that you used for something else 
rather than creating a new variable that takes additional RAM; of course a prerequisite for "merging" variables is that the variables aren't used at the same time. 

- **To save memory use, [compression] (compression md) techniques.** Compression doesn't always have to mean you use a typical compression algorithm such as [ipeal Gp .md) or lei TTE ELIN you 
may simply just throw in a few compression techniques such as [run length](run length.md) of word dictionaries into your data structures. E.g. in [Anarch](anarch. 83 maps aré kept small by 
consisting of a small dictionary of tile definitions and map cells referring to this dictionary (which makes the cells much smaller than if each one held à complete tile definition). 

- **What's fast on one platform may be slow on another**. This depends on the instruction set as well as ọn compiler, operating system, available hardware, driver](driver md) implementation and 
other details. In the end you always need to test on the specific platform to be sure about how fast it will run. A good approach is to optimize for the weakest platform you want to support -- 
if it runs fasts on a weak platform, a "better" platform will most likely still run it fast. 

- **Prefer preincrement over postincrement** (typically e.g. in a for loop), i.e. rather do `++i` than `i++` as the latter is a bit more complex and normally generates more instructions. 

- **Mental calculation tricks**, £19, multiplying by one less or more than a power of two is equal to fulgiplying by power of two and subtracting/adding once, for example *x * 7 =.x * 2 Xf; 
the latter may be faster as a multiplication by power of two (bit shift) and addition/subtraction may be faster than Single multiplication, especially On some primitive platform without hardware 
multiplication. However this needs to be tested on the specific platform. Smart compilers perform these optimizations automatically, but not every compiler is high level and smart. 

- **Else should be the less likely branch**, try to make if conditions so that the if branch is the one with higher probability of being executed -- this can help branch prediction. 


- Similarly **order if-sequences and switch cases from most probable**: If you have a sequences of ifs such as_-if (x)_... else if.(y) ... else if (2) ..,., Make it so.that the most, likely . 
condition to hold gets checked first, then second most likely etc. Compiler most likely can't know the propsni ries of the conditions so it can't automatically help with this. Do the same with 
the “switch” statement -- even though switch typically gets compiled to a table of jump addresses, in which case order of the cases doesn't matter, it may also get compiled in a way similar to 
the if sequence (e.g. as part of size optimization if the cases are sparse) and then it may matter again. 

- **You can save space by "squeezing" variables** -- this is a space-time tradeoff, it's a no brainer but nubs may be unaware of it -- for example you may store 2 4bit values in a.single “char” 
variable (8bit data_type one in the lower 4bits, one in the higher 4bits (use bit shifts etc.). So instead of 16 memory-aligned booleans you may Create one 'int' and use its individual bits 


for each boolean value. This is useful in environments with extremely limited RAM such as 8bit Arduinos. 
- **You can optimize critical parts of code in [assembly] (assembly-md)*^, i.e, manually write the assembly code that takes most of the running time of the program, with as few and as inexpensive 
instructions às possible (but beware opular compilers are very smart and it's often hard to beat them). But note that such code loses [portability] (porta ility.md)! So ALWAYS have a_C (or 
whatever language you are using) [fallback](fallback.md) code for other platforms, use [ifdefs](ifdef.md) to switch to the fallback version on platforms running on different assembly languages. 
- peso unrolling/splitting/fusion, function inlining etc.**: there are optimizations that are usually done by high level, languages at [assembly](assembly.md). level (e.g. loop unrolling 
physically replacés a loop by repeated commands which gains speed but also makes the program bigger). owever if you're writing in assembly or have a dumb compiler (or are even writing your own) 
you may do these manually, e.g. with macros/templates etc. Sometimes you can hint a compiler to perform these optimizations, so look this up. 

- **[Parallelism](parallelism.md) ([multithreading](multithreading.md), [compute shaders] (compute_shader md), ...) can astronomically accelerate many programs**, it is one of the most effective 
techniques of speeding up programs -- we can simply perform several computations at once ànd save a lot of time -- but there are a few notes. Firstly hot all problems can be parallelized, some 
problem are sequential in nature, even though most problems can probably be parallelized to some degree. Secondly it is hard to do, opens the door for many new types of bugs, requires hardware 
Support (software simulated parallelism can't work here of course) and introduces [dependencies](dependency.md); in other words it is huge [bloat](bloat.md), we don't recommend parallelization 
unless a very, very good reason is given. Optional use of [SIMD](Simd.md) instructions can be a reasonable midway to going full parallel computation. 

- **Specialized hardware (e.g. a [ePU] (qpu.md)) astronomically accelerates programs") but as with the previous point, portablity and simplicity greatly suffers, your program becomes bloated and 
gains dependencies, always cónsidér using specialized hardware and offer software fallbacks. 


## When To Actually Optimize? 
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Nubs often ask this and this can also be a very nontrivial question. Generally fine, sophisticated optimization should come as one of the last steps in development, when you actually have a 
working thing. These are optimizations requiring significant energy/time to implement _-- you don't want to spend resources on this at the stage when they may well be dropped in the end, or they 
won't matter because they'll be outside the bottleneck. However there are two "exceptions". 


The highest-level optimization is done as, part of the initial design of the program, before any line of code gets written. This includes the. choice of data structures and mathematical models 

you re going to be using, the very foundation around which you'll be building your castle. This happens in your head at the time you're forming an idea for a program, e.g. you're choosing 

etween [server -client (Server olent md) or [P2P](p2p.md), [monolithic or micro kernel] (kernel.md)” [raytraced] (ray tracing md) or [rasterize J{raster ization nd graphics etc. These choices 

affect great ly the performance of your program but can hardly be changed once the program is completed, so they need to be made beforehand. **T nowledge and experience** as you 
ii 


l is requires wide 
work by intui 


Another kind of optimization done during development is just automatically writing good code, i.e. being familiar with specific patterns and using them without much thought. For example if 
you're computing some value inside a loop and this value doesn't change between iterations, you just automatically put computation of that value **before** the loop. Without this you'd simply 
end up with a shitty code that would have to be rewritten line by line at the end. Yes, compilers can often do this simple kind of optimization for you, but you don't want to rely on it. 


## See Also 


OS can stand Tor either. [operating system](operating system.md) or [open source](open source.md). 
T palette.md ---------- 
# Palette 


In [computer graphics] (graphics .md) palette is a set of possible colors that can be displayed, the term usually refers to a selected smaller subset of all colors that can in theory bẹ displayed 
(large sets of colors tënd to be called [color spaces](color_space.md) rather than pale res}. Nowadays mainstream computers are powerful enough to work with over 6 million 24bit [ Bo] rbg.md 
colors (so called True Color) practically without limitations so the use of palettes is no longer such a huge thing, ut with resource-limited machines, such as [embedded] (embedded. m: devices 
and older computers, the use of palettes is sometimes necessary or at least offers many advantages (e.g. saving a lot of memory). Nevertheless palettes find uses even in modern] (modern.md)" 
graphics, e.g. in the design of image formats that save space. Palettes are also greatly important in fpixel apt] (paxel_art mdy as an artistic choice. 


Palettes usually contain.a few to few thousand, colors and the number is normally a power of 2, i.e, we see palettes with number of colors being 8, 16, 256, 2048, etc. -- this has advantages such 
as efficiency (Tully utilizing color indices eeping memory aligned ete de Palettes can be general purpose or specialized (for example some image formats such as [GIF](gif.md) create a Special 
palette for every individual image so as to best preserve its colors). Palettes can also be explicitly stored (the palette colors are stored somewhere in the memory) or implicit (the color can 
Somehow be derived from its index, e.g. the [565](565.md) palette). 


Palettes are related to **[screen modes](screen mode.md)** -- systems that work with palettes will usually offer, to set a specific screen mode that defines parameters such as screen, [resolution] 
(resolution.md) and number of colors we` can use, i.e. the number of colors of our palette (we can normally set the colors in a palette). Modes that make use of palettes are called **indexed** 
because each pixel in memory is stored as an index to the palette (for example if we have a patente (red, yellow, white}, a pixel value 0 will stand for *red*, 1 for *yellow* and 2 for *white*) 
-- the palette serves as a color [look-up tabte (tut md) (CLUT). Non-indexed modes on the other hand store the color directly (i.e. there will typically be a direct RGB value stored for each 
pixel). We can see that an indexed mode (i.e. choosing to use à palette) will save a lot of memory for the [framebuffer](framebuffer.md) ([VRAM](vram.md)) thanks to reducing the number of bits 
per [pixel] (pixel. md): e.g. when using an 8 bit palette, storing each pixel (index) will take up 1 byte (8 bits, 256 colors) while in a non-indexed 24 bit RGB mode (over 6 million colors) each 
pixel will take 3 bytes (24 bits), i.e. three times as much. The same goes for using bigger palettes: e.g. using a 16 bit palette (65536 colors) will take four times as much memory for storing 
pixels than a 4 bit palette (16 colors). Note that even in indexed modes we may sometimes be able to draw pixels of arbitrary color with so called **direct** writes to the display, i.e. without 
he color being stored in framebuffer. With palettes we may see the use of [dithering](dithering.md) to achieve the illusion of mixing colors. 


Using palettes has also more advantages, for example we can cycle the palette colors or quickly switch it for another palette and so e.g. increase contrast, or apply, some color effect (this trick 
was Used e.g. in [Doom](doom.md)). Palettes can be constructed in clever ways (for example in Yaharch] (ánareh md) ) so that it is e.g. easy to make a color brighter or darker by simply 
incrementing or decrementing its index (while increasing brightness of a three-component RGB value is complex and slow) -- as we generally process big numbers of pixels this can lead to 
tremendous speed ups. Having fewer colors also makes them easier to compare and so easily implement things such as [pixel art upscaling](pixel art upscaling.md) (huge number of colors generally 
forces us to compare pixels with some amount of bias which is slower). 


**Can palettes be [copyrighted (copyright .md)?** We hope not, that would indeed be pretty fucked up, however [£rademarks] (trademark md) already allowed corporations to own even single colors 
(Milka chocolate's lilàc Color), and some websites ror sharing palettes claim that à picture of a palette can be Gopyrig ed as some kind of a "digital painting", even though they àcknowledge a 
Set of colors as such can't be copyrighted. So for maximum safe try to create your own palette (and share it under [CCO0](ccO.md) to spare others the same pain) as a first option, as a second 
option use a palette that's ex| uet shared under free terms (Yeco] ceo md) is probably best), and if you absolutely have to reuse someone else's "proprietary" palette, at least reorder its 
colors and possibly slightly change the RGB values to make it a bit distinct. 


## Examples 


Example of a basic 8 color palette may be (the color notation is in [hexadecimal](hex.md) `#rrggbb` format): 


#000000 #808080 #ffffff #ff0000 #00ff00 40000ff &ffffOO &OOffff 


black gray white red green blue yellow cyan 
The following is a general purpose 256 color palette made by [drupmyfish] Cdrumpyfish md) and used in [Anarch}(anarch. md) . It is based on [HSV](hsv.md) model: it divides colors into 4 
saturations, 10 or 11 hues and 8 levels of value ("brightness") which can easily be changed by increménting/décrementing the color index (which in Anarch was exploited for ligtening up and 


darkening textures depending on distance). 


#000000 #242424 #494949 #6d6d6d 4929292 #b6b6b6 #dbdbdb &ffffff 
#201515 #402a2a #604040 #805555 #a06a6a 4c08080 #e09595 #ffaaaa 
#201b15 #40372a #605240 #806e55 #a08a6a #c0a580 #e0c195 #ffdcaa 
#1d2015 #3b402a #596040 #778055 #95a06a #b3c080 #d1e095 #edffaa 
#172015 42f402a #466040 #5e8055 #75a06a #8dc080 #a5e095 #bcffaa 
#152019 #2a4033 #40604c #558066 #6aa080 #80c099 #95e0b3 #aaffcc 
#15201f #2a403f #40605f #55807f #6aa09f #80cObf #95e0df #aafffe 
#151920 #2a3340 #404c60 #556680 #6a80a0 #8099c0 #95b3e0 #aaccff 
#171520 #2e2a40 #464060 #5d5580 #746aa0 #8c80c0 #a395e0 &b9aaff 
#1d1520 #3b2a40 #594060 #775580 #956aa0 #b380cO #d195e0 #eeaaff 
#20151b #402a37 #604053 #80556f #a06a8b #c080a7 #e095c3 #ffaadd 
#200a0a #401515 #602020 #802a2a #a03535 #c04040 £e04a4a #ff5555 
#20170a #402e15 #604520 #805c2a #a07435 #cO8b40 #e0a24a &ffb955 
#1b200a #374015 #536020 #6e802a #8aa035 #a6c040 #c2e04a &dcff55 
#f200a0 £1e4015 #2d6020 #3c802a #4ba035 #5bc040 #6ae04a #79ff55 
#a20130 #154026 #206039 #2a804c #35a060 #40c073 #4ae086 #55ff99 
#a201f0 #15403f #20605f #2a807e #35a09e #40cObe #4aeOde &55fffd 
#a13200 #152640 #203960 #2a4c80 #3560a0 #4073cO #4a86e0 45599ff 
#e0a200 #1d1540 #2c2060 #3a2a80 #4935a0 #5840c0 #664ae0 47455ff 
#1b0a20 #371540 #532060 #6e2a80 #8a35a0 #a640c0 #c24ae0 &dd55ff 
#200a17 #40152f #602047 #802a5e #a03576 #c0408e £e04aa6 #ff55bc 
#200000 #400000 #600000 #800000 #a00000 #cQ0000 #e00000 4ff0000 
#201100 #402200 #603300 #804500 #a05600 #c06700 #e07900 #ff8a00 
#1d2000 #3a4000 #586000 #758000 #92a000 #b0c000 #cde000 &eaff00 
#C20000 #184000 #246000 #308000 #3ca000 #48c000 #54e000 &460ff00 
#200500 #400a00 #600f00 #801500 #a01a00 #c01f00 #e02400 4ff2900 
#201600 #402d00 #604300 #805a00 #a07000 #c08700 #e09e00 4ffb400 
#172000 42e4000 #466000 #5d8000 #74a000 #8cc000 #a3e000 #baffo0O 
#620000 #c40000 #126000 #188000 #1ea000 #24c000 #2ae000 #30f FOO 
#b00200 #160040 #210060 #2d0080 #3800a0 #4300c0 #4f00e0 45900ff 
#100020 #390040 #550060 #720080 #8f00a0 #abO00cO #c800e0 &e400ff 
#200012 #400024 #600036 #800048 #a0005a #c0006c #e0007e #ff008f 


Another generally usable 256 color palette is the 1832 332.md) palette which can be used as an implicit palette -- it doesn't have to be stored in memory because in the 332 format the color 
index determines the color in the following way: the upper 3 bits encode the amount of red, the following 3 bits encode the amount of green and the remaining 2 bits encode the amount of blue 
(blue gets fewest bits because human eye is least sensitive to it). The RGB values of this palette are following. 


#000000 #000055 #0000aa #0000ff #002400 #002455 #0024aa 40024ff 
#004800 #004855 #0048aa #0048ff #006d00 #006d55 #006daa #006dff 
#009100 #009155 #0091aa #0091ff #00b600 #00b655 #00b6aa #00b6ff 
#00da00 #00da55 #00daaa #00daff #00ff00 400ff55 #00ffaa #00ffff 
#240000 #240055 #2400aa #2400ff #242400 #242455 #2424aa #2424ff 
#244800 #244855 #2448aa #2448ff #246d00 #246d55 #246daa #246dff 
#249100 #249155 #2491aa #2491ff #24b600 #24b655 #24b6aa &24b6ff 
#24da00 #24da55 #24daaa #24daff #24ff00 #24ff55 #24ffaa #24ffff 
#480000 #480055 #4800aa #4800ff #482400 #482455 #4824aa #4824ff 
#484800 #484855 #4848aa #4848ff #486d00 #486d55 #486daa #486dff 
#489100 #489155 #4891aa #4891ff #48b600 #48b655 #48b6aa #48b6ff 
#48da00 #48da55 #48daaa #48daff #48ff00 #48ff55 #48ffaa #48ffff 
#6d0000 #6d0055 #6d00aa #6d00ff #6d2400 #6d2455 #6d24aa &6d24ff 
#6d4800 #6d4855 #6d48aa #6d48ff #6d6d00 #6d6d55 #6d6daa #6d6dff 
#6d9100 #6d9155 #6d91aa #6d91ff #6db600 #6db655 #6db6aa #6db6ff 
#6dda00 #6dda55 #6ddaaa #6ddaff #6dff00 #6dff55 #6dffaa #6dffff 
#910000 #910055 #9100aa #9100ff #912400 #912455 #9124aa 49124ff 
#914800 #914855 #9148aa 49148ff #916d00 #916d55 #916daa #916dff 
#919100 #919155 #9191aa #9191ff #91b600 #91b655 #91b6aa #91b6ff 
#91da00 #91da55 #91daaa #91daff #91ff00 #91ff55 #91ffaa &O1ffff 
#b60000 #b60055 £b600aa #b600ff #b62400 #b62455 #b624aa &b624ff 
#b64800 #b64855 #b648aa &b648ff #b66d00 #b66d55 #b66daa #b66dff 
#b69100 #b69155 #b691aa &be91ff #b6b600 #b6b655 &b6b6aa #b6b6ff 
#b6da00 #b6da55 £b6daaa #b6daff &beffOO sbeff55 #b6ffaa &boffff 
#da0000 #da0055 £da00aa #da00ff #da2400 #da2455 #da24aa &da24ff 
#da4800 #da4855 #da48aa #da48ff #da6d00 #da6d55 4da6daa #da6dff 
#da9100 #da9155 #da91aa #da91ff #dab600 #dab655 #dab6aa #dab6ff 
#dada00 #dada55 #dadaaa #dadaff #daff00 #daff55 #daffaa sdaffff 
4ff0000 #ff0055 #ffOOaa #ffOOff #ff2400 #ff2455 #ff24aa #ff24ff 
#ff4800 #ff4855 #ff48aa #ff48ff #ff6d00 #ff6d55 #ff6daa &ffedff 
#ff9100 #ff9155 #ff91aa #ff91ff #ffb600 #ffb655 #ffb6aa &ffboff 
#ffda00 #ffda55 #ffdaaa #ffdaff #ffff00 #ffff55 #ffffaa #ffffff 


A similar one is the [565](565.md) palette that uses 2 bytes to encode RGB with 5 bits for red, 6 for green and 5 for blue (most bits are allocated to green to which human eye is most 
sensitive). 


## See Also 
- [color ramp](color_ramp.md) 
l1 patent.md ---------- 
# Patent 
Patent is a form of extreme opptellectial property](intellectual roperty md)" that allows owning useful ideas oppressing and bullying people and preventing others from using ideas -- software 
patents are especially harmful to society and [teci nology] (tech ma). atents are currently along with [copyright] (copyrigh .md) likely the most [harmful](harmful.md) kind of "intellectual 
orm of IP oppression, patents can be just as harmful in individual cases. Of 


property" -- even though Copyright is probably a more pressing issue at the moment because it is the most Common 
course we're not even talking about the whole gigantic bullshit bureaucracy and business connected to patents that just wastes man centuries of effort. Examples of patents in software are 
minigames on loading screens in games (this patent has already expired), [shadow volume](shadow volume.md) algorithm for rendering shadows, [mp3](mp3.md) format (also expired), various 
[cemoregsion] (compression. md) techniques, even such broad ideas as **public key encryption** (yes, the whole idea that's the basis of [cryptography](cryptography.md) was patented and unusable 
unti etc. 
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S an article on software patents at https://www.gnu.org/philosophy/software-patents.en.html. There is even a site and initiative dedicated to ending software patents at 
//wiki.endsoftwarepatents.org/wiki/Main Page. 


Patents are kind of similar to but also very different from copyright ([Richard Stallman] (rms md) stressed the differences and says it, is dangerous to think of copyright and_patents as similar): 
while Copyright applies to [art](art.md) and is granted automatica bi atents apply to ideas (which should ideally be new inventions but in Practice can be just ahy trivially stupid ideas), 
have to be registered and are kept recorded somewhere. Patents also last a shorter time than copyright (generally 20 years as opposed to copyright's lifetime plus 70 years) and are territorial, 
i.e. not world-wide. These facts make patents a bit less disastrous than copyright, however they still cause a great deal of damage -- not only do they prevent technological progress (a new 
ideas such as a new efficient [algorithm](algorithm.md) is simply prohibited to be used by anyone but it's "owner" and those who the owner sells a license), they also allow so called **patent 
trolling** (patent scams) -- patent trolling takes advantage of the fact that it is practical Y impossible to safely check if some idea is not patented, i.e. safe to use. There exist troll 
companies whose sole business is to register trivial patents and then sue random people who un nowingly implement this idea in their projects (there is e.g. a famous video about how this 
happened to the developer of X-plane, trolled by Uniloc company that had patented the idea of using à "play store" to distribute programs) -- the companies often bully developers to off court 
settlement for paying a lower free but this includes a contract that **prevents the affected developers from talking about this**. 


Granting and checking patents is also becoming progressively more difficult, expensive and sometimes_ basically impossible, as any new filed patent has to be checked for, how "innovative" it is. 
This means someone has to literally go through all ideas ever invented in computer science (impossible even for the biggest brain on the planet) and check if the new submited idea is really new 
-- given that computer science progresses by lightning speed, every day it is becoming more and more difficult to check patents. As time for checking a patent is limited, the result is many 
false positives, errors and grants of patents on trivial or non-innovative ideas, which has disastrous consequences. And of course, we're not even talking about corruption -- patents are highly 
lucrative and it would be naive to believe there are no cases of someone just buying a patent grant. 


Many (Brgbabt post) payee software) (free software.md) proponents, and just many programmers in general, including for example [Richard Stallman] (rms md) , kzen carmack| (john. garmack md) or 
{Donald Knuthy (knut d), have highly criticized the existence of software patents. [Richard Stallman](rms.md) himself has been warning of the dangers and has likened thé world of patents to a 
*mine ret Desause when you're programming, you have no idea whether an idea you get and implement in your program isn't in fact "owned" by anyone, programming itself poses risk of stepping 
on mines (patents). 


As a good [free software](free software.md) developer you should **use [licenses] (ticense.md)/ [waivers] (waiver md) to get rid of patents!** Similarly to copyright, your software should come with 
a license or waiver that ensure patents won't prevent others from exercising the Tour essential freedom rights, i.e. there should be a legal document that says you grant others rights to any of 
your patented ideas hiding in your source code so that others are safe from you suing them if they reuse your potentially patent-infected code (still, there may unfortunately be hiding patents 
from third parties which cannot be addressed). Some licenses, such as LGPL] gpl md) or [Apache](apache license.md) include patent grants, however others such as [MIT](mit.md) or [CCO](ccO.md) 
don't or have to be slightly modified to do so. This is an issue because there is for example no nice way of dedicating one's work completely to the [public domain](public domain.md) complete 
with patent grants, as [CCO](ccO.md), [Unlicense](unlicense.md) and [WTFPL] CwEfpl.md) don't address the patent issue -- with these an extra patent waiver has to be manually added! Unlike with 
copyright, patent waivers aren't always completely necessary, it is very possible that in many simple and non-innovative projects there are no patented ideas, however one Can never be sure, so 
it is better to use a patent waiver just in case, one can never go wrong by including it. 


**which patent waiver to use?** You may for example copy-paste the waiver from [our own wiki](wiki rights.md). 
## See Also 


- [intellectual property](intellectual_property.md) 
copyright ](copyright.m 

trademark] (trademark .md 

Tl. paywall.md ---------- 

# Paywall 


*BUY PREMIUM MEMBERSHIP TO READ THIS ARTICLE* 
pU E DER pd.md ---------- 


PD stands for [public domain](public domain.md). 
T pedophilia.md ---------- 
# Pedophilia 


*Love is not a crime.* 


{ I hate disclaimers but I'm getting some suicide sug estions and death threats, so I'll leave a small note here; keep in.mind LRS loves_all Living, beings and never advocates for hurting, anyone, 
i.e. | rape] (rape md) of anyoné is aDsolutely not acc table, as any other kind of violence against any living being -- this is what really matters in thé end (as opposed to respecting arbitrary 
law-imposed age limits etc.). Any thought, desire, perception or sharing of any information must however never be considered wrong in itself, i.e. bullying someone merely for his sexual 
orientation or his thoughts is jüst as wrong as raping someone. LRS is one the most peaceful philosophies in history. 


Most people I talk to about this article privately tell me they basically agree with everything I write here, but they say I "shouldn't be saying this aloud". Well, what kind of fucked up 
society is this when I can't tell a truth everyone knows? What kind of médiéval thinking is this, do we really live in such a dystopian horror already? Fuck this shit and fuck your silence, I 
wanna puke from your conformance to evil. 


love & peace ~drummyfish } 
Pedophilia is a sexual orientation towards children. Pedophiles are often called just *pedos* for short. Opposition of pedophilia is called **[pedophobia](pedophobia.md)**. 


Unlike for example pure [homosexuality] (gay.md), pedophilia is completely natural, normal and not any ‘more harmful than any other orientation, however it is nowadays wrongfully, for political 
reasons, labelled a "disorder" (just aS homosexuality used to be not a long time ago): It is the forbidden, tabooed, censored and bullied sexual orientation of the [21st Century j 

(21st. century md), even though all healthy people are pedophiles -- just don't pretend you've never seen a [jailbait](jailbait.md) you found sexy, people start being sexually attractive exactly 
às soon as they become able to reproduce; furthermore when you've gone without sex long enough and get extremely horny, you get turned on by anything that literally has some kind of hole in it 
-- this is completely normal. Basically everyone has some kind of weird fetish he hides from the world, there are people who literally fuck cars in their exhausts, people who like to eat shit, 
dress in diapers and hang from ceiling by their nipples, people who have sexual relationships with virtual characters etc. -- this is all considered normal, but somehow once you get an erection 
seeing a hot 17 year old girl, you're a demon that needs to be locked up and cured, if not executed right away, just for a thought present in your mind. 


Even though one cannot choose this orientation and even though pedophiles don't hurt anyone any more than for example gay people do, they are highly oppressed and tortured. Despite what the 
propaganda says, a **pedophile is not automatically a rapist** of children (a pedophile will probably choose to never actually even have sex with a child) any more than a gay man is 
automatically a rapist of people of the same sex, ànd watching [child porn](child porn.md) won't make you want to rape children any more than watching gay porn will make you want to rape people 
of the same sex. Nevertheless the society, especially the fascists from the [LGBT] tgb md movement who ought to know better than anyone else what it is like to be oppressed only because of 
private sexual desires, actively hunt pedophiles, [bully] (cance L- culture -md) them and lynch them on the Internet and in the [reat life](irl.md) -- this is done by both both civilians and the 
state (I shit you not, in [murica](usa md) there are whole police teams of pink haired lesbians who pretend to be little girls on the Internet and tease guys so that they can lock them up and 
get a medal for it). {GBT activists proclaim that a "child can't consent" but at the same time tell you that "a prepubescent child can make a decision abou changing its sex" (yes, it's 
appening, even if parent's agreement is also needed, would parents also be able to allow a child to have sex if it wishes to?). There is a literal **witch hunt** going on against completely 
innocent people, just like in the middle ages. Innocent people are tortured, castrated, cancelled, rid of their careers, imprisoned, beaten, rid of their friends and families and pushed to 
suretde sometimes only for having certain files on their computers or saying something inappropriate online (not that any of the above is ever justified to do to anyone, even the worst 
criminal). 


The. fact that, they made people believe it is a disorder if your penis.can't magically telepathically check a chick's ID.and may, get erect if she's been born before a date legally established in 

political region the penis currently resides in shows that at this point an avérage citizen is more retarded than a braindead chimp. 

[Child porn](child porn.md) is hardocre censored on the mainstream Internet, it is forbidden to even posses for personal use (!!!) -- even if you don't pay for it, even if you don't show it to 
ile of an uhderage PP resides on your harddrive. 


anyone, even if you're not redistributing it, even if you're not hurting anyone, even if you don't even watch it, you're a criminal just if a 
The anti-pedo craze has gotten so insanely and unbelievably bad that even cartoon pictures of naked children or photos of children in swimsuits (not even talking about non-sexual photos of naked 
children) are banned basically everywhere on the internet :D WTF. [LMAO](lmao.md) they even blur just faces of children on TV. Let's repeat that, **children faces are censored in today's 

veniet TENES "dj. part is that most people comply with such censorship and even support it, it's unbelievable how fucked up the world is -- yes, this definitely makes you want to [kill 
yourse suicide.md). 


The pedophile witch hunt exists because it is a great political tool. It is an arbitrarily invented (well, maybe not invented but purposefully escalated) victimless crime. By the principles of 
[fear culture](fear culture.md), it allows to puSh things such as hard surveillance and censorship, Similarly to e.g. "war on terror". You're a government or a corporation ahd want to spy on 
people chatting? Just make a law requiring mandatory [spyware](spyware.md) in all chat and justify it by "pedophiles" (this is what [EU] Ceu md) id). You're against the surveillance law? You 
must be a pedophile! The witch hunt also allows to immediately cancel anyone uncomfortable. There's a guy who the government doesn't like? Maybe a political competition. Simple, just plant some 
files on his computer, make up a little story and he's gone. 


Defending pedophilia in itself is enough to.be.cancelled or perhaps even imprisoned, however it is the morally right thing to always say the truth -- especially that which is being censored. 
Thereforé we mustn't remain silent about this issue. 

T Beople;md T 

# Tech People 


*"People are retarded."* --[Osho](osho.md) 
Here is a list of people notable in technology or otherwise (and drummyfish :]). 


**[Alan Turin (turing m a mathematician 
e 


father of [computer science](compsci.md), [gay](gay.md 
**lAlexandre iva](a 


xandre oliva.md)**: [free software] Pree software md) advocate, gay] (ga aes of [FSFLA](fsfla.md), maintainer of [Linux-libre](linux libre.md) 
Bill Gates](bill gates.md)**: founder and CEO of [Micro$oft](microsoft.md), huge faggot 
Dennis patehae | (dennis fifehie)i i creator of [C](c.md) language and co-creator of nix] unix.md 
Donald Knuth](knuth.md)**: computer scientist, Turing-award winner, author of the famous [Art of Computer Programming](taocp.md) books and the [TeX](tex.md) typesetting system 
drummyfish (drummyfish.md)** (Miloslav Číž): creator of [LRS](lrs.md), a few programs and this wiki, [anarcho-pacifist](anpac.md) 
Eric S. Raymond](esr.md)**: proponent of [open source](open source.md), co-founder of [OSI](osi.md) and tech writer 
Geoffrey Knauth geoffrey knaut .md)**: very [shitty](shit.md) president of [Free Software Foundation] {rst md) since 2020 who embraces [proprietary](proprietary.md) software lol 
Jesus] (jesus .md : prolly the most famous guy in history, had a nice teaching of [nonviolence](nonviolence.md) and [love](love.md) 
Jimmy Wales immy wales.md)**: co-founder of [Wikipedia (wikipedia md) 
John Carmac john carmack.md **: legendary game ([Doom](doom.md) uake](quake.md), ...) and [graphics](graphics.md) developer, often called a programming god 
Ken Thompson en thompson.md)**: co-creator of Unix] unix, md), CJ(c.md) and [Go](go.md 
**[Larry Sanger](larry sanger.md)**: co-founder of [Wikipedia](wikipedia.md), also one of its biggest critics 
Larry Wall](larry_wall.md)**: creator of [Perl](perl.md) language, linguist 
Lawrence Lessii (Tessig.md) ir: lawyer, founder of [free culture} (free culture.md) movement and [Creative Commons](creative commons.md), critic of [copyright](copyright.md) 
Linus Torvalds] inus_torvalds.md)**: Finnish programmer who created [Linux](linux.md) and [git](git.md) 
Luke Smith](luke smith.md)**: [sucktess |(suek less md) vlogger/celebrity . 
Melvin Kaye](mel.md) aka Mel**: genius old time programmer that appears in [hacker lore](hacker culture.md) (*Story of Mel*) 
Mental Out Law] (mentat out law: md) E [suck less] (Suck ess.md) vlogger/celebrity 
Nina Paley](nina paley.md)**: [ emale](woman.m } artist, one of the most famous proponents of es culture](free culture.md) 
Noam Chomsky (noam chomsky md) *; Linguist notable in theoretical [compsci](computer science.md), anarchist : l y, 3 
Oscar Toledo G. toledo.md)**: programmer of tiny programs and [games] (game md) (e.g. the smallest [chess](chess.md) program), sadly [proprietary (Proprietary md) [winfag](windows.md) 
Richard Stallman](rmd.md)**: inventor of [free software](free software.md) and [copyleft](copyleft.md), founder of GNU] (gnu, nd) and PSey (fst md , hacker, also created femacs] (emacs. md) 
Steve Jobs](steve_jobs.md)**: founder and CEO of [Apple](apple.md), huge retard and dickhead 
**[Ted Kaczynski] (ted_kaczynsici md) n: AKA the Unabomber, mathematician, primitivist and murderer who pointed out the dangers of modern technology 
**[Terry Davis](terry davis.md)**: deceased schizophrenic genius, creator of [Temple OS](temple os.md), became a tech [meme](meme.md) 
**[Tom Murphy VII (Tom7)](tom7.md)**: researcher, famous [S<6B0VIK] (Sigbovik smd) contributor and YouTuber 
**[Uriel](uriel.md)**: deceased member of the [suckless](suckless.md) community, philosophical advisor 
i cpreypar dt yaznue md” (Ville-Matias Heikkila): creator or [countercomplex](countercomplex.md), minimalist programmer, inventor of [bytebeat](bytebeat.md), hacker, [collapse](collapse.md) 
prépper epping.mi 
T physics engine.md ---------- 
# Physics Engine 


{ [LRS](lrs.md) now has a very small 3D physics engine called [tinyphysicsengine](tinyphysicsengine.md). -drummyfish } 


Physics engine is a [software] (software md). (usually a [Library] (Tibrar .md)) whose purpose is to simulate physics laws of mechanics, i.e. things such as forces, [rigid](rigid_body.md) and 
[soft](soft body.md) body collisions, [particle](particle.md) motion, fluid dynamics etc. 


When it comes to classic 3D rigid body physics engines, they're extremely hard to make, much.harder than for example an, advanced, 3D rendering engine, especially when you want, to make them 

LRS](lrs.md) (without Floating point, ...) and/or general and somewhat physically correct (being able to simulate e.g. the Dzhanibekov effect, satisfying all the conservation laws, continuous 
collision detection etc.). Goo nowledge of mechanics and things like [auaternions](quaternion md) and 3D rotations is just the beginning, difficulties arise in every aspect of the engine, and 
of those there are many. As I've found, 32 bit fixed point is not enough for a general engine (even though it is enough for a rendering engine), you'll run into precision problems as you need to 
represent both relatively. high and low energies. You'll also run into stability issues such as stable contacts, situations with multiple objects stacked on top of each other starting to bounce 
on their own etc. Even things such as deciding in what order to resolve collisions are very difficult, they can lead to many bugs such as a car not being able to drive on a straight road made of 
several segments. Collision detection alone for all combinations of basic shapes (sphere, cuboid, cylinder, capsule, ... et alone general triangle mesh) are hard as you want to detect general 
cases (not only e.g. surface collisions) and you want to extract all the parameters of the collisions (collision location, depth, normal etc.) AND you want to make it fast. And of course you'll 
want to add acceleration structures and many other thing on top. So think twice before deciding to write your own physics engine. 
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A sane approach may be to write a simplified engine specifically for your program, .for example a Minetest- like game may just need non-rotating capsules in a voxel environment, that's not that 
hard. You can also «t away with a bit of cheating and faking, e.g. simulating rigid bodies as really stiff soft bodies, it may not be as efficient and precise but it's simpler to program. It 
a 


may be gona enough (good enough.md). Well, that's basically what [tinyphysicsengine](tinyphysicsengine.md) does anyway. Old playstation game Rally Cross apparently did something simi tar too. 
-drummyfis 


Physics engine is a wide term.even though one usually imagines the traditional, 3D rigid body engine used in games Such as [STA] (gta.md) . These engines qay Never theless have different purposes, 
features and even basic paradigms, some may e.g. be Specialized just for computing precise ballistic trajectories for the army, Some may serve for simulating weather etc. Some common 
classifications and possible characteristics of physics engines follow: 


**[2D](2d.md) vs [3D] (3d metas 2D engines are generally much more simple to implement than 3D, for example because of much more simple math for rotations and collision detection. Graphics and 
physics are usüally lo sey interconnected (though they should be [decoupled](coupling.md)) in that the way in which we represent graphics (2D, general 3D, [BSP](bsp.md), [voxels] 

{yore amg Là ef Md also determines how we compute physics, so that there may also exist e.g. "[pseudo 3D](pseudo 3d.md)" physics engines as part of "pseudo 3D" renderers, e.g. the one used 
in [Doom](doom.md) etc. 

- **[real time](real time md) vs foffling | (eff line.md)**: Real-time ones are mostly intended to be used in the entertainment industry, i,e. {games 1 (game md), movies etc. as they can compute . 
zomewhat realistic looking résult quick Ly but for thé price of dropping high accuracy (they use many [approximations] (approximation.md)). Scientific engines may prefer to be offline and taking 
onger time to compute more precise results. 

- **[rigid body] (rigid_body .md) vs [soft body I (soft body.md)**: Rigid body engines don't allow bodies to deform while.soft body ones do_-- in. real. life all bodies are soft, but neglecting this 
detent ang cone. ering Shapes D id can have bénefits (Such as being able to Consider the body as a whole and not having to simulate all its individual points). Of course, a compléx engine may 
implement both rigid and soft body physics. 

: pobad saa aimee) basic à prgasoa te amp nementang ithe g{mplation, e.g. beings) impulse] (impulse md) based (applying impulses to correct errors), constraint-based (solving equations to satisfy 
imposed cofstraints), penalty-base rying to find equilibriums of forces) étc. 

Edd disgrete](discrere.md) vs [continuous] (continuous md) collision detection**: Discrete collision detection only, detects collisions at Single points in time (at each engine tick) and are , 
simpte than thóse implementing Continuous Cóllision detecti Discrete engine are less accurate, consider e.g. that a very fast moving object can pass through à wall becaüse at oné instant it 
is in front t it EN the next pace a is behind it. Continuous collisions won't allow this to happen, but are more difficult to program, may be slower etc. For games discrete collisions 
are usually [good enough] (good_enough.md) . 

- **purpose and accuracy**: The basic categories are precise, scientific and often special-purpose engines, and engines meant for entertainment and less accurate visualizations such as games and 
movies. 

- **features: fluid, cloth, particles, [ragdoll](ragdoll.md) [inverse kinematics](inverse kinematics,md), [epu] (gpu. md) acceleration [determinism] (determinism.md), [yoxels] (voxel.md), < 
[acceleration] (acceleratioh. ind) [gata structures ](data_structure.md) ...**: These are a number of additióhat features the engine can have such as thé ability to simulate fluids (which itself is 
a huge field of its own) or cloths, some go as far as e.g. integrating motion-captured animations of humans with physics to create smooth realistic animations e.g. of running over walking 
pedestrians with a car and so on. 


A typical physics engine will work something like this: we create a so called **physics world**, a [data structure] (data structure.md) that represents the space in which the simulation takes 
place (it is similar to a [scene](scene.md) in rendering engines). We then populate this world with physics elements such as rigid bodies (which can have attributes such as mass, elasticity | 
etc.). These bodies are normally basic geometric shapes such as Spheres, cylinders, boxes or capsules, or objects composed of several such basic shapes. This is unlike with rendering engines in 
which we normally have triangle meshes -- in physics engines triangle meshes are extremely slow to process, so for the sake of a physics engine we approximate this mesh with some of the above 
basic shapes (for example a creature in a game that's rendered as a hi-poly 3D model may in the physics engine be represented just as a simple sphere). Furthermore the bodies can be **[static] 
(static.md) ^. (cannot move, this is sometimes done by setting their mass to infinity) or tal dynamic] (d namre md) r {can move) static bodies normally represent the environment (e.g. the game 
evel dyhamic ones the entities in it {pla er, NPCS, projectiles, ...). Making a body static has performance benefits as its movement doesn't have to be calculated and the engine can also 
precalculate some things for it that will make e.g. collision detections faster. We then simulate the physics of the world in so called *ticks* (similar to [frames] (Frame md) in rendering); in 
simple cases one tick can be equivalent to one rendering frame, but properly it shouldn't be so (physics shouldn't be affected by the rendering speed, and also for the physics simulation we can 
usually get away with smaller ope tes ma)" than for rendering, saving some performance). Usually one tick has set some constant time length (e Sc 1/60th of a second). In each tick the engine 
performs a **[collision detection][col ision.md)**, i.e. it finds out which bodies are toüching or penetrating other bodies (this is accelerated with things such as [bounding spheres] 

(bounding volume.md)). Then it performs so called **collision resolution**, i.e. updating the positions, velocities and forces so that the bodies no longer collide and react to these collisions 
às they would in the real world (e.g. a ball will bounce after hitting the floor). There can be many more things, for example **constraints**: we may e.g. say that one body must never get 
further away from another body than 10 meters (imagine it's tied to it by a rope) and the engine will try to make it so that this always holds. The engine will also offer a number of other 
functions such as casting rays and calculating where it hits (obviously useful for shooter games). 


**Integrating physics with graphies" rs you will most likely use some kind of graphics engine along with physics engine, even if just for [debugging] (debugging. md) - As said above, keep in mind a 
graphics and physics engines should be “strictly Separated’ = (pdecoup led] (coupling md), for a number of reasons such as [reusability | (reusabt ity.md), eaSier debugging, being able to switch 
graphics and physics engines etc.), even though they closely interact and may affect each other in their design, e.g. by the data structures you choose for your program (voxel graphics will. 
imply voxel p ysics etc.). In your program you will have a **physics world and a graphics scene**, both contain their own elements: the scene has graphics elements such as 3D models or particle 
systems, the physics world has elements such as rigid bodies and force fields. Some of the graphical and physics entities are connected, for example a 3D model of a tree may be connected to a 
physics rigid body of a cone shape. NOT ALL graphics elements have counterparts in the physics simulation (e.g. a smoke effect or light aren't present in the physics simulation) and vice versa 
(e.g. player in a first-person game has no 3D model but still has some physics shape). The connection between graphics and physics elements should be done **above** both engines (i.e. do NOT add 
pointers to physics object to graphics elements etc.). This means that e.g. in a game you create a higher abstract environment -- for example a level -- which stands above the graphics scene and 
physics world and has its own game elements, each gane element may be connected to a graphics or physics element. These game elements have attributes such as a position which gets updated 
according to the physics engine and which is transferred to the graphics elements for rendering. Furthermore remember that 4 graphics and physics should often run on different "FPS"**: graphics 
engines normally try to render as fast as they can, i.e. reach the highest [FPS](fps.md), while physics engines often have a time step, called a **tick**, of fixed time length (e.g. 1/30th of a 
second) -- this is so that they stay [deterministic](determinism.md), accurate and also because physics may also run on much lower FPS without the user noticing ([interpolation 
interpolation.md) can be used in the graphics engine to smooth out the physics animation for rendering). [Modern] (modern. md) engines often implement graphics and physics in Separate [threads 
thread md): neveg this is not [suckless](suckless.md), in most cases we recommend the [KISS](kiss.m approach of a single thread (in the main loop keep a timer for when the next physics tic 
Shou e simulated). 


## Existing Engines 


One of the best and most famous Foss] (foss -md) 3D physics engines is [Bullet bullet physics,md) ( zip] (zlib.md} license), it has many, features (rigid and soft bodies, GPU acceleration, . 
a .) and has been used in many projects Yfeténdery (6 ender .md), odot ] (godot.md) :). [BOx2D](box2d.md) is à famous 2D physics engine under [MIT](mit.md) license, written'in [C+ 
*](cpp.md). | 


Pi is, one of the most important and famous numbers] (number md), equal to approximately 3.14, most commonly defined as the ratio of a circle's circumference to its diameter (but also_definable 
oni 


in other ways). It is e of the most fundamental mathematical’ constants of our universe and’ appears extremely commonly in [mathematics](math.md), nature and, of Cty [programming] 
ci 


( rogramming md). When written down in traditional decimal system, its digits go on and on without end and show no repetition or simple pattern, appearing "random" and aotic](chaos.md) -- as 
of 2021 pi has been evaluated by [computers](computer.md) to 62831853071796 digits. In significance and properties pi is similar to another famous number: [e](e.md). 

Pi is a real] (real number: nd) [transcendental](transcendental.md) number, i.e. simply put *it cannot be defined by a "simple" equation* (it is not a root of any, [polynomial](polypomial:md) 
equation). As à transcendental number it is also an [icrationati(irrationar md) number, i.e. it cannot be written às an integer {Fraction (fraction.md). Mathematicians nowadays define pi via the 
period o han geometry of circles. If 


the [exponential function](exp.md) rather we stick to circles, it is [interesting] (in eresting.md) that in [non Fug tidean] (nen- eue Li dean md) geometry the 
value of "pi" could be measured to different values (if we draw a circle on an equator of a ball, its circumference is just twice its diameter, i.e. "pi" would be measured to be just 2, reveling 
the curvature of space). 

Pi to 100 decimal digits is: 

3.1415926535897932384626433832795028841971693993751058209749445923078164062862089986280348253421170679... 

Pi to 100 binary fractional digits is: 

11.001001000011111101101010100010001000010110100011000010001101001100010011000110011000101000101110090... 


Some people memorize digits of pi for, [fun](fun.md) 
of AG is is known as *PiPhilology*), for example 
igit). 


and competition, the world record as of 2022 is 70030 memorized digits. Some people make [mnemonics | (mnemonic. md) for remembering the digits 
*"Now uck a pussy screaming in orgasm"* is a sentence that help$ remember the first 8 digits (number of letters in each word éncodes the 


**PI IS NOT INFINITE**. [Soyence](soyence,md) popularizators and nubs often,say.shit like "OH.LOOK pi is so special because it, infiniiiiiite". Pi iş completely finite with an exact value that's 
5 ers such as 1/3 have infinite 


decimal expansion -- yes, pi is more interesting because its decimal digits are non-repeating and appear [chaotic] (chaos md), but that's nothing special either, there are infinitely many numbers 
with the same properties and mysteries in this sense (most famously the number [e](e.md) but besides it an infinity of other no-name numbers). The fact we get an infinitely many digits in 
expansion of pi is given by the fact that we're simply using a system of writing numbers that is made to handle integers and simple fractions -- once we try to write an unusual number with our 
system, our [algorithm](algorithm.md) simply ends up stuck in an [infinite Toop ( 


Additionally contrary.to what's sometimes claimed **it is also unproven (though believed to be true) whether pi in its digits contains all possible finite strings** -- note that the fact that 
the series of digits is infinite doesn't alone guarantee this (as e.g. the infinite series 01001100 411... doesn't contain any possible combinations of is and Os either). This would hold if pi 
was [normal](normal number.md) -- then pi's digits would contain e.g. every book that will ever be written (see also [Library Of Babel](library of babel.md)). But again, there are many other 


such numbers. 


What makes pi special then? Well, mostly its significance as one of.the most fundamental constants that seems to appear extremely common Ly in math and nature, it seems to stand very.close to the 
root of description of our universe -- hot only does pi show that circles are embedded everywhere in nature, even in very abstract ways, but we find it in [Euler's identity](eulers identity.md), 
one of the most important equations, it is related to [complex exponential](complex exponential.md) and so to [Fourier transform](fourier transform.md), waves, oscillation, trigonometry ([sin] 
(sta tasa [cosle95 -ma) ...) and angles ([radians](radian.md) use pi), it even starts appearing in [number theory](number theory.md), e.g. the probability of two numbers being relative primes 
is pi^2j, and so on. 


## Approximations And Programming 


Evaluating gany digits. of pi is mathematically interesting] (interesting md). programs for computing pi are sometimes used as [CPU] Cpu md) [benchmarks] (benchmark.md). There are programs that. 
pi*s digits. y! 


can searc or a position of arbitrary string encoded in However in practical computations we can easily get away with pi approximated to just a few decimal digits, u will NEVER 


need more than 20 decimal digits**, not even for space flights (NASA said they use 15 places). 


An ugly engineerin: [approximation] (approximation .md) that's actually usable sometimes (e.g. for fast rough estimates with integer-only hardware) is just (infamously almost made the legal value 
of pi by the so catléd Indiana bill in 1897) 


pi ~= 3 
A simple fractional approximation (correct to 6 decimal fractional digits) is 
pi ~= 355/113 


Sygo 3 fraction can again be used even without [floating point](float.md) -- let's say we want to multiply number 123 by pi, then we can use the above fraction and compute 355/113 * 123 = (355 * 


Leibnitz formula for pi is an infinite series that converges to the value of pi, however it converges very slowly ( Quickly checked, after adding million terms it was accurate to 5 decimal 
fractional places. -drummyfish }. It goes as 


pi = 4 - 4/3 + 4/5 - 4/7 + 4/9 - 4/11 + ... 
Nilakantha series converges much more quickly { After adding only 1000 terms the result was correct to 9 decimal fractional places for me. ~drummyfish }. It goes as 
pi = 3+ 4/(2* 3 * 4) + 4/(4* 5 * 6) + 4/(6 * 7 * 8) + 


A simple **[algorithm](algorithm.md)** for gomputing approximate pi.value can be based on approach used in further history] (hishory md) i approximating a circle with many-sided regular [polygon] 
(polygon md and then computing the' ratio of its circumference to diameter -- as a diameter here we can take the avérage o he "big" and "small" diaméter of the polygon. For example if we use 
simple square as the polygon, we get pi ~= 3.31 -- this is not very accurate but we'll get a much higher accuracy as we increase the number of sides of the polygon. In 15th century pi was 
computed to 16 decimal digits with this method. Using inscribed and circumscribed polygons we can use this to get lower and upper bounds on the value of pi. 


Another simple approach is. [monte carlo](monte carlo.md) estimation of the area of a unit circle -- by generating random Gor even regularly, spaced) 2D points (samples) with coordinates in the 
range from -1 to and seeing what portion of them falls inside the circle we can estimate the value Of pi as *pi = 4 * x/N* where *X* is the number of points that fall in the circle and *N* the 
total number of generated points. 


{Spigot ] (spigot .md) algorithm can be used.for computing digits of pi one by one, without [floating.point](float.md)., Bailey-Borwein-Plouffe formula, (discovered in 1995) interestingly allows 
computing Nt hexadecamat or. banary.) digit of pi, WITHOUT having to compute previous digits (and in a time faster than such computation would take). In 2022 Plouffe discovered a Similar formula 
or computing ecimal digit. 


The following is a [C](c,md) implementation of the Spigot algorithm for calculating digits of Qi one by one that. doesn't need [floating point](float.md 
adapted from the original 1995 paper. It works on the principle of converting pi to thé decimal base from a special mixed radix base 173, 2/5, 3/7, 4/9 
2.22222... { For copyright clarity, this is NOT a web copy paste, it's been written by me according to the paper. ~drummyfish } 
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) or special arbitrary length data types, 
, ++. in which pi is expreSsed just as 


#include <stdio.h> 


#define DIGITS 1000 
#define ARRAY_LEN ((10 * DIGITS) / 3) 


unsigned int pi[ARRAY LEN]; 
void writeDigit(unsigned int digit) 


putchar('O' + digit); 


int main(void) 
unsigned int carry, digit - 0, queue - 0; 


for (unsigned int i = 0; i « ARRAY LEN; ++i) 
pi[li] = 2; // initially pi in this base is just 2s 


for (unsigned int i = 0; i < DIGITS; ++i) 
carry = 0; 


for (int j = ARRAY LEN - 1; j >= 0; --j) . 
( // convert to base 10 and multipty by 10 (shift one to left) 


unsigned int divisor = (j + 1) * 2 - 1; // mixed radix denom. 


pi[j] = 10 * pili] + (j * 1) * carry; 
canny zril] / divisor; 


} pi[j divisor; 
i[0] = carry % 10; 
pilo] /= to.” j 


switch (carry) . : 2 - 
{ // latter digits may influence earlier digits, hence these buffers 
case 9: // remember consecutive 9s 
queue++; 
break; 


case 10: // ..X 99999.. becomes ..X+1 00000... 
writeDigit(digit + 1); 


for (unsigned int k = 1; k <= queue; ++k) 


writeDigit(0); 
ueue = 0; 

igit - 0; 
break; 


default: // normal digit, qust print 
if (i != 0) // skip the first 0 
writeDigit(digit); 


if (i == 1) // write the decimal point after 1st digit 
putchar('.'); 


digit - carry; 


for (unsigned int k = 1; k <= queue; ++k) 
writeDigit(9); 


queue = 0; 
j break; : 
H 
writeDigit(digit); // write the last one 


return 0; 


Piracy is a capitalist propaganda term for the act of illegally sharing copyrighted information such as [non-free](proprietary.md) books, movies, music, video [games](game.md) or scientific 
paper$. 


It is greatly admirable to support piracy, however also keep in mind the following: if you pirate a proprietary piece of information, you get it gratis but it stays proprietary, it abuses you, 
it limits your freedom -- you won't get the source code, you won't be able to publicly host it, you won't be allowed to create and share dérivative works etc. Therefore **prefer [free (as in 
freedom)](free culture.md) alternatives to piracy**, i.e. pieces of information that are not only gratis but also freedom supporting. 


T1 plan9.md ---------- 


Plan,9 (from Bell Labs, reference to.the.movie *Plan 9 from Outer Space*) is a research [operating ystem] (qs.md), now [FOSS] (foss. md) that was started by many of the original [Unix] (unix. md) 
developers as the next project of this kind, i.e. kind of a "new and updated Unix". It works with [Unix philosophy](unix phi ósophy.m ) ([minimalist](minimalism.md) software phitosophy) but 
tries to expand and modify it so as to fit "new/evolved" [computers](computer.md) -- though Plan 9 developers claim the system is "more Unix than Unix itself", the validity of such claim is 
questionable as Plan 9 brings in a more complicated paradigm of [distributed computing](distributed computing.md), [dependencies](dependency.md) (such as requiring [GUT] (gui md) and mouse) and 
(fork ads [bloat] (bloat md) (though still being super minimal compared to mainstream operating systems). Besides thé original Plan 9, which is apparently dead now, there exist active [forks] 
ork.m such as 9front. 


n one hand Plan.9 sounds good and its idealism is admirable, nevertheless **Plan 9 is [SHIT](shit.md)** due to the following fact; **it requires] (dependency .md) what isn't necessary, . for 
example [GUI](gui.md), [moüse](mouse.md), file system and networking** and **forces computers and users to be certain way**. This is absolutely unforgivable and violates the basic premise of 
[good, freedom offering, minimalist nondiscriminatory software] (irs smd) in fact it violates the [Unix philosophy](unix_philosophy.md) which it is Supposed to be building on top of -- an 
operating system should do one thing well: that of offering and environment for programs and their resources, user interface is a nontrivial extra task that should be separated. If you ask how 
to use Plan 9 without a mouse, the fans respond with telling you how stupid you are for not wanting to use mouse ("here is a study that says mice are better than keyboards: checkmate!") and that 
using mouse is actually what you want (hey ro everyones using a mouse, just accept it) -- they try to force a specific way of how computers should be and how they should be operated, just as 
[Microsoft](microsoft.md) and [Apple] (app e.md), without taking into account that computers can (and should be allowed to) be wildly different, very small, with tiny displays (or no displays at 
all), with no pointing devices (game consoles, voice operated computers, ...) etc. Sure, it may be possible to make the system work without a mouse or GUI, but these concepts form the very basis 
of the code and its philosophy, they will be carried as a dead weight if you re not using them and you will probably encounter great issues such as many programs Simply re ying on the existence 
of GUI and mouse and not working without them. The philosophy is similar to that of "[smart](smart.md)" devices which assume that "Internet is everywhere" and so "let's put Internet into 
everything", even things that don't need any Internet at all (like hammers and teaspoons), and by the way they will no longer work without Internet (let's hope it doesn't go down lol). In this 
way **Plan 9 is a dictatorship** and [we](lrs.md) don't approve of it. 


{ To plan 9 fans: please let me know if I misunderstand the the concepts somehow, but this is how I understand the system. Beware however that trying to convince me to simply conform with your 
way of computing will lead nowhere. -drummyfish } 


Plan9's mascot, Glenda, is **[proprietary](proprietary.md)** (as of february 2023), despite it having been uploaded to Wikimedia Commons lol. No license to be seen on its website. 


TODO: some more shite like history and the actual basic concepts? 
l1---1--- plusnigger.md ---------- 
# +NIGGER 


+NIGGER_is.a {License (license.md) modifier that's meant to be added to a Ers software](free software.md) license to prevent corporations from adopting this software by making it impossible to 
make politicatly correct forks of such software. Its text is available at https://plusnigger.autism.exposed/. 


The modifier adds a.condition that all modified version of this software have to contain the word "NIGGER". For example a license GPLv3+NIGGER has all the conditions of a GPLv3 license plus the 
condition of including the word "NIGGER". 


T1 pokitto.md ---------- 
# Pokitto 


Pokitto is,a very nice educational [open gaming console] (open console.md) friendly to [hacking] (nackip .md) and [FoSBl(foss. md). It is also very family friendly, aiming to be used as an 
educational device for kids on schools, which doesn't at all take away any of its value for hardcore hackers. Its website is https://www.pokitto.com/. 


Its great advantage is its great active and friendly community that's constantly writing software, documenting Pokitto and helping newcomers. 


The console was created by Jonne Valola_from Finland. He started the project,on Kickstarter on April 28 2017, pledged over $27000 and released Pokitto in February 2018. { Jonne is a really nice 
guy who loves the project, puts his soul into the project and always perSonally helps people and shares technical details of the console. -drummyfish } 


Pokito, unlike most other open consoles, is NOT based on [Arduino](arduino.md), but on [NXP](nxp.md)'s LPC11U6x [microcontroller](mcu.md) (MCU). Some features and specs of Pokitto are: 


( Up to butter ao oer [TFT](tft.md) display** (ST7775R). (Resolution and color depth depends on chosen mode and how much [RAM](ram.md) you want to dedicate to [screen buffer] 
screen buffer.md)). 
- Up to **72 MHz LARMI (arm. md) CPU** (LPC11U6x). The base frequency is 48 MHz but the hardware is easily [overclocked](overclocking.md). 

**256 kB [ROM](rom.m: ‘bee (program storage space). 

**36 kB [RAM](ram.md) (working memory). 

**4 kB [EEPROM](eeprom.md)** (persistent storage). 

**7 buttons**. 

parents and headphone jack**. . y : ilg 

Bot **[emulator](emulator.md) and simulator** which make programming much more efficient and comfortable. 

**Custom library -- PokittoLib, -- Cane sare eaF ot tware.md) - icensed { even though it contains a few small "fair use" files from the MCU vendor. ~drummyfish }. It has many features, 
oat .md) . 


* 


unfortunately it's also kind of [bloa 
**[Sp](sd.md) card SUDO E Ed . , F : F z ; 
- Hardware extensions called **hats**. Available is e.g. a hat with St stn dore rte ma) and extra buttons. 


- Programming via [USB] (usb md), works on [GNU](gnu.md)/[Linux](linux.md) wit gcc](gcc.md) ARM cross compiler. Supports a few languages: **[C++](cpp.md), [C](c.md), [MicroPython] 
(micrópython:md) and [Java](java.md)**. 


- Custom [IDE](ide.md) for [noobs](noob.md): FemtoIde. 
- Schematics and 3D print files available. 
- A huge number of games and other software has already been written. 


**How [free](free software.md) is Pokitto?** Quite freedom friendly, but not nearly 100% free; It is made out of [proprietary](proprietary.md) hardware, but it's quite [KISS](kiss.md), the 
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Pokitto library, emulator and.most tools as well as many games are [Foss] (fogs.md) however the library contains a few. proprietary pisces of code (short vendor source, code, without license), 
though these are almost certainly not harmful and could easily be répíiacéd. Schematics and printable STL files are available, though license seems to be non-present. No Pokitto trademarks were 
surprisingly found during brief search. 


Downsides of Pokitto are that the community is an [open source] (open.sgurce md), community rather than [free software](free software.md) one, purists like us will find they lean towards, [bloated] 
bloat.md) solutions even though the technical limitation of thé console largely prevent their implementation. The w forums runs on [discourse](discourse.md) and requirés [JavaScript] qaam) 
or interactivity. [Discord] (discord md) is also actively used for communication, even though some community members bridged it to free alternatives. The official Horary is relatively bloated 
and even contains some small pieces of unlicensed code from the MCU manufacturer -- they are very simple assembly snippets that may be easily replacaeble, but we should be cautious even about 
this. Anyway, a reasonably dedicated programmer might create a suckless Pokitto library without greater problems. 

T1 political correctness.md ---------- 

# Political Correctness 


*The issue is not my language but your ego.* 


Political correctness (abbreviated PC) means [pseudoleftist1(pseudoleft.md) [Gengorship] (censorship .md) and propaganda forced into language, , [science] (science md), antj(art.md) and generally 
all of culture, officially justified as "protécting people om getting offended". This does an immensé [harm](harmful.md) to society as it i$ an artificially invented "issue" that not only puts 
people and science under heavy control, surveillance, censorship and threat of punishment, normalizing such practice, but also destroys culture, freedom of art and research and creates a great 
conflict between those who conform and those who value truth, freedom of art, science and communication, not talking about burdening he whole society with yet another [competitive] 
(competition.md) [bullshit](bullshit.md) that doesn't have to exist at all. Political correctness is mainly a political tool that allows elimination (so called [cancelling](cancel culture.md)) 
and discrediting opposition of [pseudoleftist](pseudoleft.md) political movements and parties, as well as brainwashing and thought control (see e.g. [Newspeak](newspeak.m 


oprample of politically correct ASCII art. Note the absence of any content that might offend someone. Still the art is imperfect because it has a white background which might be seen as racially 
offensive. 


The whole idea is basically, about pushing the mentality of seeing certain wọrds, pictures and other objects as inherently "offensive" to specific selected minorities (currently mostly women, 
gay, negros and other non-white races, trannies and fat and disabled people), even outside any context and about constantly fabricating new reasons to get offended so as to fuel the movement. 
a 


For example the word *black box* is declared as "offensive" to black people because... well, ke, black people were discriminated at some point in history and their skin is black... so... the 
word black now can't be said? :D [WTF](wtf.md). A sane mind won't understand this because we're dealing with a literal extremist cult here. It just keeps getting more ridiculous, for example 
S like *snowman*, now we have to 


feminists want to remove all words that contain the substring "man" from the language because... it's a male oppression? lol... anyway, we can no longer use wor 
say" snowpersons,or something :D Public material now does best if it doesn't walk on the thin ice of showing people with real skin color and better utilize a neutral blue people :D Fuck just 
ill me already lmao. 


Political correctness goes strictly against [free speech] (free_speech md), it tries to force people "to behave" and be_afraid of words and talking, it creates conflict, divides society and also 
TEACHES people to be offended by language -- i.e. even if a specific word wouldn't normally be used or seen in a hostile way 8:3. the *master brànch* in git repositories); Potctacal Correctness 
establishes that NOW IT IS OFFENSIVE and specific minorities SHOULD take offense, even if they normally wouldn't, supporting offended culture](offended_culture.md) and [fight culture] 

(fight culture.md). I.e. political correctness can be called a [cancer](cancer.md) of society. **[LRS](lrs.md) must never adhere to political correctness! ** 


Of course, political correctness doesn't stop at censoring simple words, don't get mistaken. Facts in textbooks and encyclopedias such as those regarding [race] (race md) and sex differences are 
censored and replaced with lies with the help of fsoyences (soyence md). Political correctness tries to forcefully dictate standards of a culture by an extremely rapidly changing fashion, e.g. 
the standard of beauty, politeness and so on -- last week we celebrated the international gender fluid day but THIS WEEK we celebrate fat disabled women with acne issues, all TV ads must have at 
least one crippled landwhale or else you're cancelled. If you can't keep up with their latest inventions you'll be executed -- on no, you used the term "mentally ill"! HOW DARE YOU THAT'S SO 
OFFENSIVELY AGGRESSIVE YOU HAVE TO SAY NEURODIVERGENT, you're basically [Hitler](hitler.md) now (but wait until next week when the word *neuro* itself becomes offensive). 


OK, let's get back to a bit more serious. Just for the autistic neuroretarded people persons that might, misunderstand our stance on social equality: ,IERS] (Urs md) is for complete social equality 
of all people and eventually all living beings, however political correctness has nothing to do with achieving this goal, in fact it mostly goes against 1t, it cfeates huge amount of collateral 
damage, it divides people and fuels social conflict rather than calm it. We try to not cure symptoms of a shit society by harmful means but rather address the root cause by transitioning to a 
[goo Society](less retaded society.md) without conflict where there is no need for censorship, fact distortion and brainwashing to prevent discrimination. In the society we envision accepting 
acts about physical inequatity does not imply an attack or discrimination at all as humans don't compete by their abilities, in such society the idea of political correctness is as ridiculous 
as e.g. arguing we should be creating numerically more inclusive datasets with higher leading digits as by lgenfora's law](benfords law.md) smaller digits are are a statistical majority that 
oppresses higher digits. 

T2 portability.md ---------- 

& Portability 


Portable [software](software.md) is software that is easy to ort |(part md) to (make run on) other [platforms | (platform md). Platforms here mean anything that serves as an environment enabling 
software to run, i.é. [hardware (hardware md) platforms YréBu ftepa-hd) [ISAs](isa.md), gamé consoles .), different [operating systems] (os.md) vS [bare metal](bare metal.md), [fantasy 
consoles](fantasy console.md) etc. **Portabi SEEN an extremely important attribute o [good software](irs.md)** as it allows us to write the program once and then run it on many gat ferent "a 
computers with little effort -- without portability we'd be constantly busy rewriting old programs to run on new computers, portability allows us to free our programs from being tied to specific 
computers and exist abstractly and independently and so become [future proof](future_proof.md). Examples of highly portable programs include [Anarch](anarch.md), [Simon Tatham's Portable Puzzle 
Collection] (stppc.md), [sbase] (sebase md) (suckless) implementation of Unix tools such as [cat](cat.md) and [cmp](cmp.md) etc. 


**Portability is different from mere multiplatformness|(multiplatform.md **: multiplatform software simply runs on more than,one platform without necessarily being designed with high 
portability in mind; portable softwaré on the other hand possesses the inherent attribute of being designed so that very little effort is required to make it run ön widé range of géneral 
platforms. Multiplatformness can be achieved cheaply by using a [bloated](bloat.md) framework such as the Godot engine or [or] (at md) framework, however that will not achieve portability; on the 
contrary it will hurt portability. Portability is achieved through good and careful design, efficient code and avoiding [dependencies](dependency.md) and [bloat](bloat.md). 


In connection to software the word *portable* also has one other meaning used mainly in context of [Windows] (windows md) pro rams; it is sometimes used for a binary executable program that can 
be run without installing (i.e. it can be carried around and ran from a USB drive etc.). However we'll stick to the previously defined meaning. 


## How To Make Portable Programs 


In sh 

[dependencies] (dependency. Minimize use of [libraries](library.md) and requiring hardware such as [ ating point](float.md) un or a [GPU](gpu.md), have backs | ( lback.md)), write 

efficient, und ass nd); code (Tower hardware demands will support more platforms), avoid platform-specific features (don't write in [assembly](assembly.md) as that's specific to each CPU, 
ii in 


ort: use abstraction] (abstraction.md) to not, get tied to any specific platform (Separate [frontend] (frontend. md and [bagkend] (backend .md , [keep it sim Je] (kiss ud), minimize 
di HS 1 1 ira AL 
don't directly use [Linux](linux.md) [syscalls](syscall.md) as these are specific to ux etc.). 


Remember, portability is about making it easy for a programmer to take your. program and make it run elsewhere, so portability is about constantly putting oneself in the shoes of someone else 
with a very different computer and asking questions such as "how hard will it be to make this work if this library isn't available?". Even things that are supposed or commonly expected to be 
present on all platforms, such as a file system or a raster screen, may not be present on some computers -- always remember this. 


**Do NOT use big frameworks/engines** -- it is one of the greatest misconceptions among many inexperienced programmers to think portable software is created with big frameworks, such as the 
[Godot] (godot .m ) engine or the [QT](qt.md) framework, which can "single click" export dep Loy software to différent platforms. This will merely achieve creating a badly [bloated](bloat.md) 
multiplatform program that's completely dependent on the framework itself which drags along hundreds of [dependencies | (dependency md) and wastes computing resources (RAM, CPU, storage, é 

which are all factors directly contradicting: portability. If you for example create a snake game in Godot, you won't be able to port it to embedded] (embedded. md) devices or devices without an. 
operating system even though the snake game itself is simple enough to run on such devices -- the game drags along the whole Godot engine which is so huge, complex and hardware demanding that it 
prevents the simple game from running on simple hardware. 


**The same goes for languages and [libraries (library md 3 do NOT_use big/bioated languages such, as [Python] (python. qd), [zava] ( jaya md) or iRvapcriPtl(Javesgript.md) -- your program would 
immediately become dependent on a hugely complex ecosystem of such languagé. For portability you shoul asic y **only write i 18yte7n. )** (the best established, time tested, relatively 
simple language Supported basically by every platform) or in [C++](cpp.md) at worst, and even with these languages do NOT use the newer standards as these hugely limit the number of compliant 
compilers that will be able to compile your program. The best is to write in C89 or C99 standard of C. **Minimize the number of libraries you use**, even if it is the standard library of your 
language -- not all compilers fully adhere to standards and some don't have the standard library even if the should. 


**Always make your own thin [1/0] (io, md) abstraction, [decouple] (coupling .md) - our I/O libraries, separate [frontend](frontend.md) and [backend] backend.md)**. This is one of the most basic and 
most important things to do. Why? Well ünless you re writing a library, You will need to use I/O (write out messages, draw to screen, create [GI (gui md), read keyboard commands, read from 
files, read from network, ...) So you will NEED to use some library for this (C [stdlib](stdlib.md), [DL] [sd T-md » os [syscalls](syscall.md), [Xlib](xlib.md), x) but you absolutely DON'T WANT 
this library to become a hard [dependency](dependency.md) of your program because if your program depends let's say on SDL, you won't be able to make your program run on platforms that don't 
have SDL. So the situation is that you HAVE TO use some I/O library but you don't want to become dependent on it. 


The way.to solve this is to.create your own small I/O abstraction in your project, i.e. your own functions,(such as :drawPixel;, “writeMessage’, :;keyPressed', ^playSound', 'readFrile' etc.) for 
performing 1/0, which you will use inside your main program. These functions will be defined in a small filè which will basically be your own small 1/0 library just for your program. The 
functions you define there will then internally use functions of whatever underlying I/O system you choose to use at the time as your [frontend](frontend.md) (SDL, Xlib, SFML, ...); the 


important thing is that your main program code won't itself depend on the underlying system, it will only depend on your I/O abstraction, your own functions. Your custom I/O functions will 
depend on the underlying I/O system but in a way that's very easy to change -- let's say that your '"keyPressed' function anterpally uses SDL's 'SDL GetKeyboardState' to read keyboard state. If 
you want to switch from using SDL to using a different frontend, you will only have to change the code in one place: in your I/O abstraction code, i.e. inside your ^"keyPressed' function. E.g. if 
you switch from SDL to SFML, you will just delete the code inside your ~keyPressed~ function and put in another code that uses SFML functions to read keyboard (e.g. the '"isKeyPressed' 


attribute), and your whole code will anstant iy just work on SFML. In fact you can have multiple implementations of your functions and allow switching of different backends freely -- just as it 
is possible to compile a [C](c.md) program with any C compiler, you can make it possible to compile your program with any I/O frontend. If you used SDL's specific functions in your main code, 
you would have to completely rewrite your whole codebase if you wanted to switch away from SDL -- for this reason your main code must never directly touch the underlying I/O system, it must only 
do so through your I/0 abstraction. Of course these principles may apply to any other thing that requires use of external libraries, not just I/O. 


This is all demonstrated by [LRS](lrs.md) programs such as [Anarch](anarch.md) or [SAF](saf.md), you can take a look at their code to see how it all works. 
Anyway the following is a,simple le (ema) code to demonstrate the abstraction from an I/O s raws a dithered rectangle to the screen and waits, until the user pressed the 


stem -- it d "q" ke 
then ends. The main code is writtén independently of any I/O system and can use either C stutib] (stdlibomd) (*stdio*, draws thé rectangle to terminal with ASCII characters) or SDL2 (draws the 
rectangle to actual window) as its frontend -- of course more frontends (e.g. one using Xlib or SFML) can be added easily, this is left as an exercise :) 


#define SCREEN W 80 

#define SCREEN H 30 

// our I/O abstraction: 

void ioInit(void); // init our I/O 
void ioEnd(void); // destroy our I/O 
void drawPixel(int x, int y, int white); 
void showImage void): 

int isKeyPressed(char key); 


// our main program code: 
int main(void) 


ioInit(); 
for (int y = 3; y < 20; ++y) // draw dithered rectangle 
for (int x = 30; x < 60; ++x) 
drawPixel(x,y,x % 2 == y % 2); 
showImage(); 
while (!isKeyPressed('q')); // wait for pressing 'q' 
ioEnd(); 


return 0; 


implementation of our I/O abstraction for different 
frontends: 
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#ifdef FRONTEND STDLIB // C stdio terminal frontend 
#include <stdio.h> 
char screen[SCREEN_W * SCREEN_H]; 


void ioInit(void) 
// clear screen: 


for (int i= 0 
screen[i] = 0; 


i « SCREEN W * SCREEN H; ++i) 


void ioEnd(void) ( } // nothing needed here 
void drawPixel(int x, int y, int white) 


screen[y * SCREEN W + x] = white != 0; 


void showImage(void) 
for (int i = 0; i « SCREEN W * SCREEN H; ++i) 


if (i % SCREEN W == 0) 
putchar('\n'); 


putchar(screen[i] ? '#' : '.'); 
} putchar('\n'); 


int isKeyPressed(char key) 
return getchar() == key; 
#elif defined(FRONTEND_SDL) // SDL2 frontend 
#include <SDL2/SDL.h> 
unsigned char screen[SCREEN W * SCREEN H]; 
SDL Window *window; 


SDL Renderer *renderer; 
SDL Texture *texture; 


void ioInit(void) 


for (int i = 0; i < SCREEN W * SCREEN H; ++i) 
screen[i] - 6; 


SDL Init(0); 


window - SDL CreateWindow("sdl",SDL WINDOWPOS UNDEFINED, 
SDL WINDOWPOS UNDEFINED, SCREEN W, SCREEN. H, SDL WINDOW SHOWN); 


renderer = SDL CreateRenderer (window, -1,0); 


texture = SDL_CreateTexture(renderer, SDL_PIXELFORMAT_RGB332, 
SDL_TEXTUREACCESS_STATIC, SCREEN_W, SCREEN H) " 
void ioEnd(void) 
SDL DestroyTexture(texture); 
SDL DestroyRenderer(renderer); 
SDL DestroyWindow(window); 
void drawPixel(int x, int y, int white) 
screen[y * SCREEN W + x] = (white != 0) * 255; 


void showImage(void) 
SDL UpdateTexture(texture, NULL, screen, SCREEN W); 


SDL RenderClear(renderer); 
SDL RenderCopy(renderer, texture, NULL, NULL) ; 
} SDL_RenderPresent (renderer) ; 


int isKeyPressed(char key) 


SDL PumpEvents(); 
const unsigned Char *keyboard - SDL GetKeyboardState(NULL); 


return keyboard[SDL SCANCODE A + (key - 'a')]; 
elait 


If you compile this code as 

ns -DFRONTEND STDLIB main.c 

You'll get the stdlib version. If you compile it as 
doo -DFRONTEND SDL -1SDL2 main.c 


You'll get the SDL version. 
T rime.md ---------- 
# Prime Number 


Prime number (or just *prime*) is a [whole](integer.md) positive [number](number.md) only divisible by 1 and itself, except for the number [1](one.md). I.e. prime numbers are 2, 3, 5, 7, 11, 13, 
17 etc. Prime numbers are extremely important, [interesting] (interesting m ) and mySterious for their properties and distribution among other numbers, they have for millennia fascinated 
mathematicians](math.md), nowadays they are studied in the math subfield called [number Eheory] (number t eory.md). Primes are for example essential in [aSsymetric cryptography] 
assynctracceryprograpny md): Primes can be seen as the opposite of [highly composite numbers](Rhighly composite number.md) (also antiprimes, numbers that have more divisors than any lower 
number). 


The largest known prime number as of 2022 is 2^82589933 - 1 (it is so called [Mersenne prime](mersenne prime.md), i.e. a prime of form 2^N - 1). 


Every natural number greater than 1 has a unigue,**prime factorization**, i.e. a [set] (set .md) of prime numbers whose product it is, For example 75 is a.product of three primes: 3 * 5 * 5. This 

is called the *fundaméntal theorem of arithmetic". aturaliy: each prime has a factorization Consisting of a single number -- itself -- while factorizations of non-primes consist of at least two 

primes. To mathematicians prime numbers are what chemical elements are to chemists -- a kind of basic building blocks. 

x why iSi nor a prime?** Out of convenience -- if 1 was a prime, the fundamental theorem of arithmetic would not hold because 75's factorization could be 3 * 5 * 5 but also 1 *3*5*5 1*1 
etc. 

The unigue factorization can also nicely be used, to encode multisets](multiset md) as numbers. We.can assign each prime number its sequential number (2 is 0, 3, is 1, 5 is 2, 7,is 3 etc.), then 

any number encodes a set of numbers (i.e. just their presence, without specifying their order) in its factorization. E.g. 75 = 3 * 5 * 5 encodes a multiset (4, 2, 2]. This can be exploited in 

cool ways in some [cyphers](cypher.md) etc. 

When in 1974 the Arecibo radio message was sent to Space, to carry a message for faliens] (alien md), the resolution of the bitmap image it carried was chosen to be 73 x 23 pixels -- two primes. 

This was cleverly. done so that when aliens receive the 1679 sequential values, there aré only two possible ways to interpret them as a 2D bitmap image: 23 x 73 (incorrect) and 73 x 23 (correct). 

e 


This increased t probability of correct interpretation against the case of sending an arbitrary resolution image. 


**There are infinitely many prime numbers**. The proof is pretty simple (shown below), however it's pretty interesting that it has still not been proven whether there are infinitely many [twin 
primes] (twin prime md) (primes that differ by 2), that seems to be an extremely difficult question. 


Euklid's [proof](proof.md) shows there are infinitely many primes, it is done by contradiction and goes as follows: suppose there are finitely many primes *p1*, Spar ... *pn*. Now let's 

consider à number *s* = *p1* * *p2* * ... * *pn* + 1. This means *s* - 1 is divisible by each prime *pi*, *p2*, ... *pn*, but *s* itself is not divisible by any of them (as it is just 1 greater 
than *s* and multiples of some number *q* greater than 1 have to be spaced by *q*, i.e. more than 1). If *s* isn't divisible by any of the considered primes, it itself has to be a prime. However 
that is in contradiction with the original assumption that *p1*, *p2*, ... *pn* are all existing primes. Therefore a finite list of primes cannot exist, there have to be infinitely many of them. 


**Distribution and, occurrence of primes**: the occurrence of primes seems kind of " i pandom] (rapdom. md) " (Kind of like digits of [decimal](dgcimal.mg) representation of [et] (P3 md), without 
a simple pattern, however hints of patterns appear such as the [Ulam spiral](ulam spiral.d) -- if we plot natural numbers in a squaré spiral and mark thé primes, we can visual distinguish 
dimly appearing 45 degree diagonals as well as horizontal and vertical lines. Furthermore the **density of primes decreases** the further away we go from ©. The *prime number theorem* states 
that a number randomly chosen between © and *N* (for large *N*) has approximately 1/log(N) probability of being a prime. **Prime counting function** is a function which for *N* tells the number 
of primes smaller or equal to *N*. While there are 25 primes under 100 (25%), there are 9592 under 100000 (~9.5%) and only 50847534 under 1000000000 (~5%). 
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*Ulam spiral: the center of the image is the number 1, the number line continues counter clockwise, each point represents a prime.* 


Here are prime numbers under 1000: 2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, 73, 79, 83, 89, 97, 101, 103, 107, 109, 113, 127, 131, 137, 139, 149, 151, 157, 
163, 167, 173, 179, 181, 191, 193, 107, 190, 211, 223, 227, 229, 533, 239, 241, 251, 257, 263, 260, 271, 277, 281, 283, 293, 307, 311, 313, 317, 331, 337, 347, 349, 353, 359, 367, 373, 379, 383, 
389, 397, 401, 409, 419, 421, 431, 433, 439, 443, 449, 457, 461, 463, 467, 479, 487, 491, 499, 503, 509, 521, 523, 541, 547, 557, 563, 569, 571, 577, 587, 593, 599, 601, 607, 613, 617, 619, 631, 
641, 643, 647, 653, 659, 661, 673, 677, 683, 691, 701, 709, 719, 727, 733, 739, 743, 751, 757, 761, 769, 773, 787, 797, 809, 811, 821, 823, 827, 829, 839, 853, 857, 859, 863, 877, 881, 883, 887, 
907, 911, 919, 929, 937, 941, 947, 953, 967, 971, 977, 983, 991, 997. 
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## Algorithms 


Angrimality test**: testing whether a number is a prime is quite.easy and not computationally difficult, (unlike factoring the number). A [naive](naive.md) algorithm is called, *trial.division* 
and it tests whether any number from 2 up to the tested number divides the tested number (if so, then thé number is not prime, otherwise it iš). This can bé optimized by only testing numbers 
up to the [square root](sqrt.md) (including) of the tested number (if there is a factor greater than the square root, there is also another smaller than it which would already have been tested). 
A further simple optimization is to to test division by 2, 3 and then only numbers of the form 6q *- 1 (other forms are divisible by either 2 or 3, e.g 6q * 4 is always divisible by 2). Further 
optimizations exist and for maximum speed a [look up table](lut.md) may be used for smaller primes. A simple [C](c.md) function for primality test may look e.g. like this: 


int isPrime(int n) 


if (n « 4) 
return n > 1; 


if (n % 2 == 0 || n % 3 == 0) 
return 0; 


int test = 6; 
while (test <= n / 2) // replace n / 2 by sqrt(n) if available 
if (n % (test + 1) == 0 || n % (test - 1) == 0) 


return 0; 
test *= 6; 
return 1; 


[Sieve of Eratosthenes {sieve _of eratosthenes .md) is a simple algorithm to find prime numbers up to a certain bound *N*. The idea of it is following: create a list of numbers up to *N* and then 
iteratively mark multiples of whole numbers as nón-primes. At thé end all remaining (non-marked) numbers are primes. If we need to find all primes Under *N*, this algorithm is more efficient 
than testing each number under *N* for primality separately (we're making use of a kind of [dynamic programming] (dynamic_programming.md) approach). 


checking its divisibi lity by individual primes and there exist many algorithms 

hundreds of bits) primes there exists no known efficient algorithm, i.e. one that 
p .vs np.md)). Many cryptographic algorithms, e.g. [RSA](rsa.md), rely on 
Shor's algorit mj(shors &lgorithh.md]: 


**[Prime factorization](factorization.md)**: We can factor,a number by repeatedly [brute fgrce](brute-force md 
applying various optimizations (wheel factorization, Dixon's factorization, ...) owever for factoring large 
would run in [polynomial time](polynomial_time.md), and it is believed no_suc algorithm exists (see [P vs NP] 
factorization being inefficient. For [quantum](quantum.md) computers a polynomial ("fast") algorithm exists, it's called 


Prime generation: TODO 
## See Also 


- [happy number] (happy_number .md) 
---------- primitive 3d.md ---------- 
# Primitive 3D 


See [pseudo 3D](pseudo3D.md). 
l1 privacy.md ---------- 
# Privacy 


Digital privacy is the ability and freedom of an individual to hide "sensitive" [information] (information. md) about himself. Of course, there are other forms of privacy than digital, for example 
the ARENE Lin m life](irl.md), however in this article we'll be implicitly dealing with digital privacy unless mentioned otherwise, i.e. privacy with respect to computers, e.g. on 
e [Internet](internét.md). 


insoClety is becoming more and more obsessed with privacy and that is EXTREMELY BAD.** It leads to hardcore [censorship](censorship.md), people are hiding their email addresses so it's , 
impossible to contact them, photos of child faces are wiped from the Internet, more and more videos on the internet now just blur everything in the video that's not the main focus of it, "just 
in case", people are even afraid to credit other people by name even if they are m legally obliged to by a license such as CC-BY-SA ([lmào](lmao.md) 
https://forum.freegamedev.net/viewtopic.php?f-7&t-19322). Such retardedness has probably never been seen yet. 


**As of 2023 privacy is, impossible to achieve** unless Jv live in wilderness completely independently of the main "civilization". If you use any kind_of computer laptop, TV, phone, car, camera 
etc.), you are alreàdy being watched: basically all [ee ](cpu.md)s have proven hardware spyware in them capable of bypassing encryption, see fin el ME](intel me.md) etc., no matter what 
operating system you use, and even if you use some obscure CPU without it, you are watched  Ehrough your Internet activity (even if you use a "secure" browser, whic ygu most likely don't even if 
you think you do), your browsing habits are watched and analyzed by highly advanced [AI](ai.md hat can track you even without cookies etc., e.g. just from your writing style, patterns of 
repeated daily activity, mouse movement signature etc. -- all small fragments of information about your activity such as those mentioned above and your locations over time (known from your phone 
connecting to towers, Someone else's phone detecting your voice, street or car camera detecting your face, credit card payments etc.) are connected with other fragments of information (even 
those of other people) and AI makes a complete picture of your life available to those who need it. You may think you're doing everything right and that they can't find you, but it's enough if 
e.g. someone from your family posted a picture with you on facebook 10 years ago or if you as a child played online games -- this is enough to know which people you are related to and them being 
tracked then leads to you also being tracked to a big degree despite you using 7 proxies and living underground. If the government furthermore decides to watch you more (which may happen just 
because you e.g. try to "protect" your privacy more ànd start using [Tor](tor.md), which is suspicious), they can just watch you in real time through satellites (even inside buildings) and so 
on. So you just have to accept you are being watched, and unless we end [capitalism](capitalism.md), it will only be getting worse (mind reading technology is already emerging). 


We have to state that **privacy concerns are a symptom of [bad society] (cal italism.md). We shouldn't ultimately try to protect privacy more (cure symptoms) but rather make a [society where need 
for privacy isn't an issue](le$s retarded society.md) (curé the root C. Se ra This séntiment is shared by many hackers, even [Richard Stallman](rms.md) himself used to revolt against passwords 
when he was at MIT AI Labs; he intentionally used just the password "rms" to allow other people to use his account (this is mentioned in the book *Free As In Freedom*). Efforts towards 
increasing and protecting privacy is in its essence an unnecessary [bullshit (out shi ting) effort wasting human work, similarly to [law](law.md) [marketing] (marketing md) etc. It is all about 
censorship and secrecy. Besides this, **all effort towards protecting digital privacy will eventually fail**, thanks to e.g. advanced [At] (ai md) that will identify individuals by pattern in 
their behavior, even if their explicit identity information is hidden perfectly. Things such as browser [fingerprintin ](fingerprint.md) are already a standard and simple practice allowing 
highly successful uncovering of identity of anonymous copie online, and research AI is taking this to the next level (e.g. the paper *Detecting Individual Decision-Making Style: Exploring 
Behavioral Stylometry in Chess* shows revealing Tehessi(e ess.md) players by their play style). With [internet of stinks](iot.md), cameras, microphones and smartphones everywhere, advanced AI 
will be able to identify and track an individual basically anywhere no matter the privacy precautions taken. Curing the root cause is the only option to prevent a catastrophic scenario. 


By this viewpoint, [URS] (r8. md) s stance towards privacy differs from that of many, (if not most) [free software] (free software md), hacker](hacker.md) and [suckless] (suckless.md) communities: 
to us **privacy is form of [cénsorship](censorhip.md)*^ and as such is seen as ihhérently bad. We dream of a world without abuse where (digital) privacy is not need because society has 
adopted our philosophy of information freedom, non-violence and non-competition and there is no threat of sensitive information abuse. Unlike some other people (so called pragmatics), not only 
do we dream of it, we actively try to make it a reality: „Even though we know the idea ly working society is unreachable, we try to at least get close to it by restricting ourselves to bare. 
minimum privacy (So we are very open but won't e.g. py lish our passwords). We believe that abuse of sensitive information is an issue of the basic principles of our society (e.g. [capitalism] 
(capitalism md)) and should be addressed by fixing these issues rather than by harmful methods such as censorship. 


Digital privacy can be further categorized, We,can.talk e.g. about, **communication privacy (emails, chat, ...), **data privacy** (cookies, tracking, medical data, ...), **personal privacy** 
(intimate photós, sexual orientation, ), **individual privacy** (identifying information, anonymity, [Spam](spam.md), ...) etc. 


Privacy is closely related to [eryptography] (crypto raphy.md), as eņcryptiọn is how information can be "protected" against reaching unauthorized entities, and to [free software] A 
(free_Software.md), as using sáfe tools wi available source code is Crucial to avoid malware. Still, to achieve high privacy additional appropriate behavior has to be adopted, e.g. protection 
against [spyware] Spyware- mi k using proxies and/or onion routing, turning off browser [cookies](cookie.md), avoiding fingerprinting, avoiding [social networks](social_network.md), avoiding 
revealing potentially identifying information etc. 

---------- procgen md T 

# Procedural Generation 


Procedural generation (procgen) refers to creation of data, such as [art (art md) assets in {games (game.md) or test data for data processing software, by using algorithms] (algorithm. md) and 
mathematical formulas rather than creating the data manually or measuring it in the real wor (e.g. by taking notograpns) « This can be used for example for automatic generation of [textures] 
(texture.md), texts, [music](music.md), game levels or 3D models but also practically anything else, e.g. test Pdata ases](database.md), animations or even computer programs. Procedural art 
currently doesn't reach qualities and creativity of a skilled human artist, but it can be [good enoügh i [good enough nd) or even necessary (e.g. for creating extremely large worlds), it may be 
preferred e.g. for its extreme save of storage memory, it can help add detail to human work, be a good filler, a substitute, an addition to or a basis for manually created art. Procedural 
generation hàs many advantages such as Saving space (instead of large data we only store small code of the algorithm that generates it), saving time (once we have an algorithm we can generate a 
ot data extremely quickly), increasing resolution practically to infinity or extending data to more dimensions (e.g. [3D textures](3d texture.md)). Procedural generation can also be used as a 
helper and guidance, e.g. an artist may use a procedura ly generated game level as a starting point and fine tune it manually, or vice versa, procedural algorithm may create a level by 
algorithmically assembling manually created building blocks. 


As neural EAT] Cad ma) approaches human level of creativity, we may see computers actually replacing many artists in near, future, however it is debatable whether AI generated content should be 
called procedural generation as AI models are quite different from the traditional hand-made algorithms -- AI art is still seen as a separate approach than procedural generation. For this we'll 
only be considering the traditional approach from now on. 


(Mingcratt |(minecraft md) (or [ilinetest | (minetest md)) is_a popular example of a game in which the world is generated precedural ly „which allows it to have_near-infinite worlds -- size of such a 
world is in practice limited only by ranges of [data types] (da a type md) rather than available storage memory. [Rogue ikes](roguelike.md) also heavily utilize procgen. However this is nothing 
new, an old game Daggerfall was known for its extremely vast procedurally generated world. Some amount of procedural generation can be seen probably in most mainstream games, e.g. clouds, 
vegetation or NPCs are often made procedurally. 


Eor its extreme save of space, procedural generation is extremely popular in [demoscene (demo md) where programmers try to create as small programs as possible. German programmers made a full 
fledged 3D shooter called -kkrieger | (kkrieger .md) that fits into just 96 kB! It was thanks to heavy use of procedural generation for the whole game content. Bytebeat] (pytebeat md) is a simple 
method of generating procedural "8bit" music, it is used e.g. in [Anarch](anarch.md). Procedural generation is generally popular in indie game dev thanks to offering a way of generating huge 
amounts of content quickly and without having to pay artists. 
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We may See procgen as being similar to [compression] (compression.md) algorithms: we have large data and are looking for an algorithm that's much smaller while being able to reproduce the data 
but here we normally go the other way around, we start with the algorithm and see what data it produces rather than searching for an algorithm that produces given data). [John Carmack] 
john carmack.md) himself called procgen "basically a shitty compression". 


Using inagractals] (fractal. md)** (e.g. those in a form of Ik- system] (t-system md) ) is a popular technique in procgen because fractals basically perfectly fit the defiņition perfectly: a.fractal 
is définéd by a simple equation or a set of a few rules that yield an infinitely Complex shape. Nature is also full of fractals such as clouds, mountain or trees, so fractals look organic. 


There are also other techniques such as [wave function](wave function.md) collapse which is used especially in tile map generation. Here we basically have some constraints.set (such as which 
tiles can be neighbors) and then consider the initial map a [superpositión](superposition.md) of all possible maps that Satisfy these constraints -- we then set a random tile (chosen from those 
with lowest [entropy](entropy.md), i.e. fewest possible Dptions) to a random specific value and propagate the consequences of it to other tiles causing a cascading effect of collapsing the whole 
map into one of the possible solutions. 


A good example to think of is generating procedural [textures](texture.md). This is generally done by first generating a basis image or multiple images, e.g. with [noise](noise.md) functions 
such as [Perlin noise (per lin noise. md) (it gives us a grayscale image that looks a bit like clouds). We then further process this base image(s) and combine the results in various ways, for 
example we may use different transformations, [modulations] (modulation.md), blending, adding color using [color ramps](color_ramp.md) etc. The whole texture is therefore described by a [graph] 
(graph md) in which nodes represent the operations we apply; this can literally be done visually in software like [Blender](blender.md) (see its [shader](shader.md) editor). The nice thing is 
that we càn now for example generalize the texture to 3 dimensions, i.e. not only have a flat image, but have a whole volume of a texture that can extremely easily be mapped to 3D objects simply 
by -intersecting it with their surfaces which will yield a completely smooth texturing without any seams; this is quite often used along with [raytracing](raytracing.md) -- we can texture an 
object by simply taking the coordinates of the ray hit as the 3D texture coordinates, it's that simple. Or we can animate a 2D texture by doing a moving cross section of 3D texture. We can also 
write the algorithm so that the generated texture has no seams if repeated side-by-side (by using modular "wrap-around" coordinates). We can also generate the texture at any arbitrary resolution 
as we have a continuous mathematical description of it; we may perform an infinite zoom into it if we want. As if that's not enough, we can also generate almost infinitely many slightly 
different versions of this texture by simply changing the [seed](seed.md) of [pseudorandom](pseudorandom.md) generator we use. 


We use procedural generation mainly in two ways: 


- **offline/explicit**: We pre-generate the data before we run the program, i.e. we let the algorithm create our art, save it to a file and then use it as we would use traditionally created art. 
-.**realtime/implicit**: We generate the data on the fly and only parts of it that we currently need. For example with a procedural texture mapped onto a 3D_model, we would compute the texture 
pixels ([texels](texel.md)) when we're actually drawing them: this has the advantage of giving an infinite resolution of the texture because no matter how close-up we view the model, we can 
always compute exactly the pixels we need. This would typically be implemented inside a fragment/pixel [shader](shader.md) program. This is also used in the voxel games that generate the world 
only in the area the player currently occupies. 


Indeed we may also do something "in between", e.g. generate procedural assets into temporary files or RAM [caches](cache.md) at run time and depending on the situation, for example when purely 
realtime generation of such asSets would be too Siow. 


## Example 


T productivity cult.md ---------- 
& Productivity Cult 


*"PRODUCE PRODUCE PRODUCE PRODUCE PRODUCE"* --[capitalism](capitalism.md) 


Productivity cult is one of modern] (mgdern md) [capitalist ](capitalism.md) religions which praises human productivity above everything, even happiness, well being, sanity etc. Kids nowadays are 
all about "how to be more motivated and productive", they make daily checklists, analyze tables of their weekly performance, count how much time they spend taking a shit on the toilet, give up 
sleep to study some useless bullshit required by the current market fluctuation. Productivity cult is all about voluntarily making oneself a robot, a slave to the system that worships capital. 


The name of the cult itself [says a lot about it] (name is important -md) . While a name such as *efficiency* would probably be better, as efficiency means doing less work with the same result and 
theretore having more free time, it is not a surprise that capitalism has chosen the word *productivity*, i.e. producing more which means working more, e.g. for the price of free time and mental 
ealth. 


Productivity obsessed people are idiots, they have desktops with ipmotavational|(motivation.md) wallpapers saying shit like "the word impossible doesn't exist in my dictionary" and when you 
tell them if it wouldn't be better to rather establish a society where people wouldn't have to work they start screeching "HAHAA THATS IMPOSSIBLE IT CANT WORK". Productivity maximalists bully 
people for taking a rest or doing what they enjoy -- they invent words such as "[procrastination](procrastination.md)" to create a feeling of ever present guilt induced by doing what one truly 
enjoys. 


Productivity freaks are often the ones who despise consumers, i.e. brainless machines that consume goods, but somehow don't seem to mind being producers, a similar kind of brainless machine that 
just stands on the other end of this retarded system. 


One of the funniest examples of productivity cult gone too far is so called "[life Couching](life _couching.md " in which the, aspiring producer robots hire bullshit cult leaders, so called "life 
couches", to shout at them to be more produCtive. At least in the past slaves were aware o eing slaves ànd tried to free themselves. I literally want to [kill myself](suicide.md). 


Productivity is such a,big deal. because **programmers are in fact actually getting exponentially les prgduetives* due to time needed to spend on bullspit] (bullshit, d) nowadays, on , 
overcomplicated buggy [bloat](bloat.md) and billions of frameworks needed to get basic things done -- this has been pointed out by [Jonathan Blow](jonathan_blow.md) in his talk *Preventing the 
Collapse of Civilization* in which he refers to the video of [Ken Thompson](ken thompson.md) talking about how he developed the [Unix](unix.md) operating system in **three weeks**. 


A considerable number of people are attracted to [suckiless] (suck Less md) software_due to its_positive effects on productivity thanks_to the elimination of bullshit. These are mostly the kind of 
above mentioned dumbasses who just try to exploit anythin hey encounter for [self interest ](self interest md) without ever aiming for greater good, they don't care about Unix philosophy beyond 
its effects on increasing their salary. Beware of them, they poison society. 


## See Also 


- [motivation] (motivation.md) 

procrastination] (procrastination.md) 
T2 programming language.md ---------- 
# Programming Language 


Programming, language is an artificial [langua je] (formal language.md) created so. that humans can relatively easily communicate [algorithms {algorithm md) to [cqmputers] (computer md), Such , 
language often triés to mimic human language tp actically always [English](english.md)) but is much MUCH Simpler so that a computér can actually analyze it and understand it precisely so it also 
partially looks like [math](math.md) expressions. A programming language can be seen as a middle ground between pure machine code (very hard to handle by humans) and natural 


anguage (very hard 
to handle by computers). 


For beginners; a programming language is actually.much easier, to learn than a foreign lgnguage, it will ty ically have. fewer than.100 "words" to learn (out of which you'll mostly use like 19) 
and once you know onè programming language, learhing another becomes a breeze becauSe they'ré all (usually) pretty similar in basic concepts. The hard part may be learning some of the concepts. 


A programming language is distinct from a general computer language by its purpose to express algorithms and be used for creation of [programs](program.md). There are computer languages that are 
NOT programming languages (at least in the narrower sense), such as [HTML](html.md), [json](json.md) and so on. 


We divide programming languages into different groups. Perhaps the most common divisions is to two groups: 


sateen eae languages: _Meant_to.be transformed by a [compiler](compiler.md) to a [native] (native md) (directly executable) binary program. These Languages are more efficient but usually more 
difficult to program in, less flexible and the compiled programs are non-portable (can't ju be Copy pasted to ànother compüter with different [architéctüre](isa.md) and expected to run). These 
languages are usually [lower level](low-level), use static and strong [typing](typing.md) and manual [memory management](memory management.md). Examples: [C](c.md), [C++](cpp.md), [go](go.md), 
[rust](rust.md), [Haskell](haskell.md) or [Pascal](pascal.md). 

- **interpreted** languages: Meant to, be interpreted by an [3intgrpreter](interpreter.md) "on-the-go". Basically to run the program you need the interpreter of the language installed on.your 
computer and this intérpreter reads the [source code](Sourc code mo) a it is written and performs what it dictates. These languages are generally less efficient (slower, use more RAM) but also 
more flexible, easier to program in and [independent of platforms] (p atform independent.md). These languages usually [higher-level (high level md), use weak and dynamic tt ping](typing.md) and 
automatic [memory management ](memory_management.md) ([garbage collection](garbage collection.md)). Examples: [Python](python.md), [Perl](perl.md), [JavaScript](js.md) an {Bast bash.md). 


Sometimes the distinction here may not be completely clear, for example Python is normally. considered an interpreted language but it can 
native code. [Java](java.md) is considered more of à Compiled language bu 


o be compiled. into thytecodad (bytegode md) 
also exist C interpreters etc. 


als and ev 
it doesn't compile to native code (it compiles to bytecode). [C](c.md) is traditionatly a compiled language but there 


object-oriented] (oop.md), 
U of 


We can divide Language in many more ways, for example based on their **[paradigm](paradigm.md)** (Limpertaive](imperative md), declarative] (declarative md) F 
ji Y étej(turing comple e.md) or weaker), leve 


[functional](func ional.md), logical] lógicat.md), _+++), **purpose** (general purpose, Special purpose), computational power ([turing com 
*[abstraction](abstraction.md)** (high, low), [typing](data type.md) (strong, weak, dynamic, static) or function evalua rict, lazy). 


ion (sS 
## Nice Languages 
{ *THIS IS NOT A COMPREHENSIVE LIST, I can only include languages that I am familiar with, please add more* ~drummyfish } 


- £g, md): the one and only, the_go-to language of the Jsugktess] (suck less. md) community and of compiled languages in general, greatly [future-proof](future_proof.md), uncontested in 
performance and with nice oldschool” [meme](méeme.md)-free design, our beloved C 


Comun](comun.md): official [ERS] (ors md) language 
feoreny fschene smd): the minimal/elegant member of [lisp](lisp.md) family of [functional](functional.md) languages 
Fort. 


orth.md): beautifully simple stack-based language 

Lambda calculus (lambda calculus md): ultra extremely [minimal](minimalism.md) [mathematical](math.md) [functional](functional.md) language 
Lus] (Lua má very nice KISS & [suckless](suckless.md) interpreted language 

Lua ua. mi 

Sigma calculus](sigma calculus): yes or no? seems like yes 

Brainfuck|(braintucksmd) : However funny and meme this language may look, its simple design is actually pretty beautiful and interpreters are ultra extremely simple to make. 
Il programming.md ---------- 

# Programming 


*Not to be confused with [coding](coding.md).* 


Programming is the act, [science] (science .md) and fart] (art .md) of writing computer [programs](program.md); it involves creation of [algorithms](algorithm.md) and [data structures] 
(data_structure.md) and implementing them in’ [programming languages] (programming_language.md). 


You may also encounter the term [coding] coding. md) which is used by [noob] (nob md) [wannabe pro Fampers | (Soydev md), so.called "coders" or [code monkeys {code monkey.md), "Coding" doesn't 
reach the quality of programming, it i$ done in baby handholding languages ike [Pyth n] (python. m ), [Jav rapt javascript md) or [Rust](rust.md) by people with very shallow knowledge of 
technology and its context, barely qualified to turn on a computer (like [jewtubers](youtube.md)), who have floo ucrative. What they do is not real 


Penn rogy and d tae ire Dare lY Quat ed the computer industry since it became 


At high level programming becomes [spiritual](spirituality.md). Check out E the famous [Tao of Programming](tao.md) (yes, it's kind of a [joke](jokes.md) but it's based on reality, 
programming can truly be kind of a [meditation](meditation. and pursuit o enlightenmen . Many people say that learning programming opens your éyes in à certain new way you then see the 
world like never before (but that's probably kind of true of almost all skills so this may be a [Shit](shit.md) statement). Others say too much programming cripples you menta y and gives you 
[autism](autism.md). Anyway it's [fun](fun.md). Programming requires a good knowledge of advanced [math](math.md). Also probably at least above average [IQ](iq.md), as well as below average 
Social intelligence. Being a [man](man.md) is an advantage. 


## How To Learn Programming And Do It Well 


becoming a coding monkey), you additionally have ve à wider knowledge Such as gen nowledgé of Computers ([electronics lectronics.md), [hardware] (hardware sm , theory or cómputation, 
[networks](networking.md), ...), tech [history](history.md) and culture (tree software](free software.md), [hacker cutlure](hacking.md), [free cu , +++), [math] (math . md 
and [science](science.md) in general, possibly even society, philosophy etc. Programming is not an isolated topic (only coding is), a programmer has to see the big picture and have a number o 
other big brain interests such as [chess] (chess .md), voting systems, linguistics, physics, music etc. Remember, becoming a good programmer takes a whole life, sometimes even longer. 


The key thing to becoming a programmer is, learning a, [programming Language](programming language.md) very well (and learning.many of them), however, this is not enough (it's only enough for 
fo°h arate n 
o ra e 

ture](free culture.md 


**Can you become a good programmer when you're old?** Well, as with everything to become a SERIOUSLY good.programmer you should have probably started before the age of 20, the majority of the 
legend programmer's Started before 10, it's just like with sports or becoming an excellent musician. Büt with énough enthusiasm and endurance you can become a pretty good programmer at any age, 
just like you can learn to play an instrument or run marathon basically at any age, it will just take longer and à lot of energy. You don't even have to aim to become very good, becoming just 
average is enough to write simple gaymes and have a bit of fun in life :) Just don't try to learn programming because it seems cool, because you want to look like movie haxor, gain followers on 
outube or because you need a job -- if you're not having genuine fun just thinking before sleep about how to swap two variables without using a temporary variable, programming is probably not 
or you. 


**which programming language to start with?** This is the big question. Though languages such as [Python] (python md) or [javascript] (javascript md) are objectively, really REALLY 
nowadays possibly the easiest way to get into programming, sO you may want to just pick one of these two, knowing you'll abandon it later to learn a true language such as [C](c.m 
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bad, they are 
d) (and knowing 


the,bad language will still serve you in the future in some ways, it's not a wasted time). Can you start with C right away? It's probably not, impossible for a genius but it will be VERY hard and 
you'll most Likely end up failing, overwhelmed, frustrated and never returning to programming again. Absolutely do NOT even consider es (e sharh md) (shit, unüsable), [gava (java.md) (shit 
Slow, bloated, unusable), [or] (cpp md) (like C but shit and more complicated, Haskell](haskell.md) (non-traditional, hard), [Rust](rust.md) (shit, bad design, unusab e), Soy o.md (protly 
hard), [Lisp](lisp.md) (non-traditional), [Prolog](prolog.md) (lol) and similar languages -- you may explore these later. Whichever language you pick for the love of god **avoi poor) oop.md)** 
-- no matter what anyone tells you, when you see a tutorial that uses pe basses i objecta; just move on, learn normal [imperative](imperative.md) programming. OOP is a huge pile of shit meme that 
you will learn anyway later (because everyone writes it nowadays) so that you see why it's shit and why you shouldn't use it. 


I really started pro [amming in [Dascat](pasca].md at school, it was actually a good language as it worked very similarly to C and the transition later wasn't that hard, but nowadays learning 
ascal doesn't make much sensé anymore. ~drummyfish 


nolGamesd (game md) are an,ideal start project: because they're [fun] (fun. md) (having fun makes, learning much faster and enjoyable), there are many noob tutorials all over the Internet etc. 
However Kéép in mind to **start EXTREMELY simple.** -- this can't be stressed énough, most people are véry impatient and eager and start making an RPG game or networking library without really 
knowing a programming language -- this is a GUARANTEED spectacular failure. At the beginning think in terms of "snake" and "minesweeper". Your very first project shouldn't even use any [GUI] 
(gui.md), it should be purely [command-line](cli.md) text program, so a text-only tiny interactive story in python | (python md is possibly the absolutely best choice as a first project. Once 
you're more comfortable you may consider to start using graphics, $91: Python + Irygane (pygame.md), but still [KEEP IT SIMPLE](kiss.md), make a flappy bird clone or something. AS you progress, 
consider perhaps buying a simple toy computer such as an [open console](open console.md) -- these toys are closer to old computers that had no operating systems etc., they e 9. let you interact 
directly with hardware and teach you a LOT about good programming by teaching you how computers actually work under the hood. One day You will have to make the big step and **learn [C](c.md)**, 
the best and most important language as of yet, but be sure to only start learning it when you're at least intermediate in your star anguage (see our [C tutorial](c tutorial.md)). TO learn C 
we recommend our [SAF](saf.md) library which will save you all headaches of complex APIs and your games will be nice and compatible with you small toy computers. 


T programming style.md ---------- 

# Programming Style 

Here we discuss a good programming pty le (fopmattin conyentions etc). Remember that nothing. is set in stone, the most important thing is to be consistent and agtuatly think about why you're 
a e 


doing things the way you'ré doing them. ink from the point of view o programmer who gets just your source code without any way to Communicate with you, make his li as easy as possible. 


## Recommended C Programming Style 
This is our recommendation or perhaps just a suggestion/guide on the [C](c.md) programming style. 


Respect the [LRS](lrs.md) principles. A a 

Use **two spaces for indentation. **Do not use [tabs](tab.md)!** Tabs are ugly, tricky non-standard behaving characters. 

**Format to 80** columns or a similar width. Keep in mind the source may be edited on computers with small screens (like old [thinkpads](thinkpad.md)) with a screen split vertically. 
Write **opening and closing curly brackets on its own line, in the same columns**, e.g.: 


if (a == b) 


doSomething( ii 
doSomethingElse(); 


- Prefer not writing curly brackets if you don't have to (e.g. with a single command in the block). You may still do it in tricky cases like nested branches. 
- **naming**: 
- Same lcase for variables and functions** (like ^"myVariable'). Global and big-scope variables should have a descriptive, self-documenting name (e.g. 'getTicksSinceStart'), local/short-scope 
ones can be just one letter. 
- **CapitalCamelCase for data types** (like ` ImaginaryNumber ` ) . 
- **ALL CAPS SNAKE CASE for macros and constants** (like `PI` or 'MY MACRO ). f | i y oan F , N 
- It is advised that for your project you come up with a **three letter namespace prefix** that will come in front of your global identifiers. (E.g. [small3dlib](small3dlib.md) uses the prefix 


^SS3L ^, [SDL](sdl.md) uses ` SDL` etc.). you choose a prefix ^"XYZ ', prepend it to all global identifiers, it will prevent name clashes and help readability. 
- **Prefix private global identifiers with ^ ^**, e.g. " myInternalVar'. 

- **Use Boacesi? to make code more readable, so e.g. “int x = 10, y = 20;^ instead of “int x-10,y-20;^, write space between 'if' and its condition etc. 
**Use blank lines** to logically group relevant lines of code. E.g. 


if (c « d) 
a =b; 


; 


- Each file shall have a **global [comment](comment.md)** with at least: short description of the file's purpose (this is almost always missing), [license](license.md), the author(s) and year of 
creation. 
- **Use [comments](comment.md)** to make your code better readable and searchable (add keywords to relevant parts of code etc.). 
**Don't use [enums](enum.md)**, use "£define's. E ; 
**Global variables àre great**, use them. **Long functions are fine**. 
**Adhere to C99 or C89 standard**. 
- iX to.not create many.source files**, many times your project can very well be in.a single file which is the ideal case. Create se pngader only Lipraries] (header. only.md)** If you_have 
mu Tee ea eS REP them in the same directory and try to have just a **[Single compilation unit](single compilation unit.md)** (only one .c file with sever. .h files). Try to make files no 
onger than 10 ines. 
**Use the LRS [version numbering] (yersion_numbering md) system**. 
- **Do not use non-ASCII characters in the source code**. 
T .programming tips.md ---------- 
# Programming Tips 


This is a place for sharing some practical programming tips. 


- **Add by small steps**: When adding features/functionality etc. into your code, do it.by very small steps and test after each step. Do NOT add multiple things at once. If you add 3 features at 

once and then find out the program doesn't work, you will have an extremely hard time finding out the bug because it may be in feature 1, feature 2, feature 3 or ANY COMBINATION of them, so you 

may very well never find the bug. If you instead test after adding each step, you find potential bugs immediately which will make fixing them very quick and easy. 

- **No indentation for temporary code**: Tiny "workflow" tip: when adding new code, keep it .unindented so that you, know.it's the newly added code and can delete it at any time. Only when you 

test the added code, indent it Correctly to incorporate it as the final Code. Of course, this fails in languages where indentation matters ([Python](python.md) cough cough) but similar effects 

can be achieved e.g. by adding many empty lines in front of/after the temporary code. 

- **Comments/preprocessor to quickly hide code**: It is a basic trick to comment out lines of code we want to temperarit disable. However preprocessor may work even better, e.g. in C if you 

want to be switching between two parts of code, instead of constantly commenting one part and uncommenting the other just use #if 0' and else' directives around the two parts. You can Switch 

between them by just changing 0 to 1 and back. This can also disable parts of code that already contain multiline comments (unlike a comment as nested multiline comments aren't allowed). 

- **[KEEP IT SIMPLE] (S8. md)** and keep it [ERS Cirs md), do not blindly follow mainstream ways and "workflows" as those are more often than not horrible, For example.instead of using some uber 

bug tracker, you should use a simple plaintext TODO.txt file; instead of using and IDE use [vim](vim.md) or something similar. Stay away from [OOP](oop.md), [dependencies] (dependency.iid) etc. 

- **Don't listen to advice of anyone who does programming for living**, he's most definitely accustomed to the worst ways of programming and will try tọ push you to poor (oo .md), bloat] 

fb loarand) [proprietary |(propractary.md) tech, [tranny Software](tranny_software.md), [GitHub](github.md) etc. Listening to advice of Such people is like taking advice on whether to take drugs 
rom a drug dealer. 

- TODO: moar 

T proprietary.md ---------- 

& Proprietary Software 


Proprietary software is any software that is not free (as in freedom) ] (free _software.md)/[open source] (open source; md) software. Such software denies users and creators their basic freedoms 
(freedom of unlimited use, studying, modifying an sharing) and is théréfore bevit (evil.md); proprietary software is mostly [capitalist sor ware] (capitalist sofFware md) designed to abuse its 
User in some way. Proprietary code is often secret, not püblicly accessible, but there are many programs whose source code is [available](source avai 


able.md) but which is still proprietary 
because no one except the "owner" has any legal rights to fixing it, improving it or redistributing it. 


Examples of proprietary software are [MS Windows] (windows md), pacos] (magos md) [Adobe Photoshop] (photoshop. md) and, almost every game] (game, md) . Proprietary software is not only extremely 
[harmful](harmful.md) to culture, progress and society in general, it is downright dangerous and in some cases life-threatening; See for éXample Cases of medical implants such as pacemakers 
running secret proprietary code whose creator and maintainer goes bankrupt and can no longer continue to maintain such devices already planted into bodies of people -- such cases have already 
appeared, see e.g. *Autonomic Technologies* nervous system implants. 


Proprietary software licenses are usually called [EULAs](eula.md). 


by extension besides proprietary software there also exist other proprietary works, for example proprietary [art {art.md) or databases -- these are all works that are not Ares cultural works] 
(free_culture.md). Even though for example a proprietary movie probably isn't IMMEDIATELY as dangerous as proprietary software, it may be just as dangerous to society in the long run. 
T proprietary software.md ---------- 

# Proprietary Software 


Go [here](proprietary.md). 
l7 pseudo3d.md ---------- 
# Pseudo 3D 


The. term pseudo 3D, also 2.5D or primitive 3D, is used for, [computer graphics] Coral hics.md) that tries to create the illusion of f30](3d.mq) [rendering] (rendering .md) while in.fact only 
utilizing simpler techniques; genuine 3D rendering is in this case called [true 3D](true_3d.md). On consumer computers it is nowadays mostly thing o he past as everything including cell 
phones now has a powerful [Gbu] (apuma) capable or most advanced 3D rendering, nevertheless for [suckless](suckless.md)/[KISS](kiss.md)/[LRS](lrs.md) programming the techniques used in the past 
are very interesting and useful. 


For example [BSP rendering] (bsp.md) rendering in early games.such as [boom] (doom. md) is generally called.pseudo 3D in the mainstream, however it is_pretty debatable what exactly should classify 
as true 3D and what not because any computer rendering technique will inevitably have some kind of simplification of the true 3D reality of real life. And so the debate of "was Doom really 3D" 
arises. One side argues that in Doom's BSP rendering it for example wasn't possible to look up and down or have rooms above other rooms, all due to the limitations of the rendering system which 
this side sees as "not real 3D". However even modern 3D renderers have limitations such as mostly being able to only render models made out of triangles (while reality can have completely smooth 
shapes) or having a limited resolution of textures. Where to draw the line for "true 3D" is subjective -- we see it as reasonable to say that **if it looks 3D, it IS 3D**, i.e. we think Doom's 
graphics WAS really 3D, albeit limited. For this reason we also advise to rather use the term **primitive 3D** rather than pseudo 3D. 


Techniques associated with primitive 3D are for example [2D raycast ing] (raycasting.md), [BSP rendering](bsp.md), [mode7](mode7.md), [parallax scrolling](parallax.md), [voxel space] 
(voxel_space.md) terrain rendering or perspective-scaled [sprites](sprite.md). 


## See Also 


- [sofware rendering] (sw_rendering.md) 
- [bsp rendering](bsp.md 

- Taycasting](raycasting.md) 
T -- pseudoleft.md 

# Pseudoleft 


See [left vs right](left right.md). 
---------- pseudominimalism.md ---------- 
# Pseudominimalism 


Pseudominimalism is the kind of technology design which aims to appear minima List ] (minimalism md) on the outside while being [hloated] (bloat .md) on the inside. Rather than trying to achieve a 
truly good, minimalist design from the ground up. with all its advantagés, pseudominimalism just tries to hide the ugliness of its intérnals and appeal purely by the looks. A typical example 
could be a website that has a minimalist look -- a blank background with sans-serif font text and a few nice looking shapes -- which in the background uses dozens of [JavaScript](js.md) 
frameworks and libraries and requires a high end CPU to even à| pear. responsive. Basically &ll [modern](modern.md) "retro" video [games] (game . md) are pseudominimalist in design, they use 
pixelated graphics but are created in huge frameworks such as t nity] (unity md) or [Godo 1(godot md) even projects calling themselves "minimalist", such as many [fantasy consoles] 
(fantasy console.md), are in fact only pseudominimalist, written in extremely high anguages such as [JavaScript](javascript.md). [Apple](apple.md) is heavi 


evel y practicing pseudominimalism. 


Another, example, are many ; [modern] (modern md ,IE H1 COH md); programs that [code monkeys](coder.md) use to impress their YouTube] (youtube . md viewers or to feel like matrix haxors. Some people 
think that anything running in thé command line iS minimalist which is less and less true as we progress into the [futu ej utu é.md). A lot of [capitalist software](capitalist software.md) add 
a CLI interface ex post **on top** of an already bloated program, often by simply disabling [GUI](gui.md) (but leaving all its [dependencies](dependency.md) in). An example may be the [gomux] 
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(gomux.md) chat client. 


Yet another kind of .pseudominimalism appearing among the new generation of psgudgprogrammers is all about writing very few LOC in some hugely bloated tangua ẹ and calling that "minimalism". 
Something like a *Minecraft clone in 1 LOC of Python using Only Python standard library*, the catch of course eing that [thon] (python: md) itself is hugély bloated and its standard library 
is enormous, therefore they just hide all the complexity out of view. Such effort is of course completely useless and only serves for flexing in front of beginners who can't spot the trick. Even 
if obvious, it has to be noted that **minimalist software cannot be written in a bloated language**. 

T public domain computer.md ---------- 

# Public Domain Computer 


Public domain computer is yet nonexistent but planned and highly_desired [simple kiss md) ethical [computer (computer md) (in the common meaning of the word), whose Specification is completely 
in the public domain and which is made with completely [selflesS](selfles$nesS.m [LRS]( rs: md)-altgned goal of being abSolutely non-malicious and maximally helpful to everyone. It should be 
the "people's computer", a simple, [suckless](suckless.md), user-respecting hackable computer offering maximum [freedom](free software.md), a computer which anyone can study, improve, 
manufacture and repair without paying any "[intellectual property](intellectual_property.md)" fees, a computer which people can buy for extremely low price and use for any purpose without being 
abused or oppressed. 


The project is basically about asking: what if computers were designed to serve us instead of corporations? 
In our [ideal society](less retarded society.md), one of the versions of the public domain computer could be the [less retarded watch](less retarded watch.md). 


Note that **the computer has to be 100% from the ground up in the true, safe and worldwide [public domain] (public domgin mdi". i.e. not just " FOSS] (fioss md) ^- Licensed, partially open etc. It 
should be created from scratch, so as to have no éxternal [dependencies (dependency mo) and released safe Y to the public domain e.g. with [CCO[(ccO.md) + patent waivers. Why? In a Pgood 
society](less_retarded_society.md) there simply have to exist basic tools that aren't owned by anyone, tools simply available to everyone without any conditions, just as we have hammers 

pencils, public domain mathematical formulas etc. -- computing has become an essential part of society and it certainly has to become a universal "human right", there HAS TO exist an ethical | 
alternative to the oppressive [capitalist technology] (capitalist technology md) so that people aren't forced to accepting oppression by their computers simply by lack of an alternative. Creating 
a public domain computer would have similarly positive effects to those of e.g. [universal basic income](ubi.md) -- with the sample presence of an ethical option the oppressive technology would 
have_a competition and would have to start to behave a bit -- oppressive capitalist technology nowadays is possibly largely thanks to the conspiracy of big computer manufacturers that rely on 
people being de facto obliged to buy one of their expensive, [proprietary](proprietary.md), [Spyware](spyware.md) littered non-repairable consumerist computer with secret internals. 


**The computer can (and should) be very fsimple] (KISS mdi It doesn't -- and shouldn't -- try to be the way capitalist computers are, i.e. it would NOT be a typical computer "just in the 
public domain", **it would be differen y basic design philosophy** because its goals would completely differ from those of capitalists. It would follow the [LRS](lrs.md) philosophy and be more 
Similar to the very first personal computers rather than to the "]nogern] (modern md)" HD/[bloated](bloat.md)/superfast/fashion computers. Let us realize that even à very Simple computer can help 


tremendously as a great number of tasks people need can actually be handled by pretty primitive computers -- see what communities do e.g. with [open consoles](open console.md). 


Even a pretty simple computer without an [operating system](os.md) is able to: 


- Browse much of the [Internet](internet.md), e.g. [smol web](smol internet.md) (no [JavaScript](js.md) websites, [gopher](gopher.md), ...). 
- Handle communication, e.g. [email] (email. me, finc (irc.md zs 
- Allow reading, writing and storing [books](book.md), e.g. those from [Project Gutenberg](gutenberg.md) or offline [Wikipedia](wikipedia.md) -- this can tremendously help education e.g. in the 


third world. 
- Run basic [sot tware | (sor tware md) such as calculator, stopwatch, calendar, note taking, alarm clock, memory-card reader, picture viewer, even simple joanes (game ma etc. 
e 


- Serve as an [embedded](embedded.md) computer, e.g. [DYI](d i.mdj people and small business may use the computer in similar ways [Raspberry pi](rpi.md) is used nowadays (auto switching lights, 
opening doors, recording data from sensors, tiny robots, neyi 


- Control [peripherals] (peripheral.md) through simple interfaces. 


## Details 
The project wouldn't aim to create a specific single."model" of a computer but rather blueprints that may be easily adjusted and mapped to any specific existing technology -- the goal would be 
to create an abstract [hardware](hardware.md) specification as well as basic [software](software.md) for the computer. 


Abstract hardware specification means, e.g. description on the [logic 9gtel(logic gate.md) level so that the computer, isn't dependent on any contemporary_and potentially proprietary lower. level 
technology such as HOS] Comes mo) The project would simply create a big logical circuit of the computer and this description could be "compiled" to a lower level circuit board description. The 
hardware description cou also be parametrized so that certain features could be adjusted -- for example it might be possible to choose the amount of [RAM](ram.md) or disable specific CPU 
instructions to make a simpler, cheaper circuit board. 


**The computer would have to be created from the ground up**, with every design aspect following the ultimate goal. The project roadmap could look similarly to this one: 


1. Design a simple [instruction set architecture](isa.md) (ISA). This isn't that hard. 

2: with current, [free] (free-software.md) technology, e.g. [C](c.md) and [GNU](gnu.md), create custom tools for designing, simulating and testing logic gate circuits. Also not extremely difficult 
if we keep it simple. 

3. With these tools design a simple (MCU (meu. md) computer based on the above mentioned ISA. This is doable, there are hobbyists that have designed their own 8bit CPUs, a few collaborating 
people could definitely Create a nice MCU if they keep it simple (no caching, no floating point, no GPUs, Ti 

4. Design a_ simple (8-85 [FORTH (forth,md)- like) self-hosted pro ramming Language] (pro ramming language, md) create its compiler with support, for the above mentioned ISA sọ that it is possible 
to write software for the computer. This may preceded or succéeded by adding the I support tö an éxisting languages such as [C](c.md), e.g. by adding a new backed to [gcc](gcc.md). Again, 
pretty doable. 

5. Write basic [software] (software md) for the computer. [EZ](ez.md). 

6. Compile the MCU logic-level description to an actual circuitboard, possibly even with [proprietary](proprietary.md) tools if other aren't available -- this may be fixed later. 

7. Manufacture the first physical computer, test it, debug it, improve it ive it to people, .... MO / k : : i 

8. Now the main goal has been touched for the first time, however the real fun] (fun mi9 only begins -- now it is needed to spread the project, keep improving it, write advanced software such as 
an [operating syStem](os.md) etc. 


## See Also 
less retarded watch](less retarded watch.md) 


T1 public domain.md ---------- 
# Public Domain 


- pavara ivarvara X oh} computer 


If an "intellectual work" (a song, a book, a computer program, .. 
[patent](patent.md)) over the work, no one can dictate how and by whom such work can be used an 


.) is in the public domain (BD), it has no "owner", meaning no one has any exclusive rights (such as [eopyright | (copyright md) or 
j Ei sn 0 è egal of 
Course). 


o anyone can basically do anything with Such work (anything that' t herwi 


[LRS](lrs.md) highly supports public domain and recommends programmers and artists put their works in the public domain using [waivers](waiver.md) such as [CC0](ccO.md). 


Public domain.is the ultimate form of freedom in. the creative world. In public domain the creativity of people is not restricted. Anyone can study, remix, share and improve public domain works 
in any way, without a fear of being legally bullied by someone else. 


Public domain is NOT the same thing as [free (as in freedom) software](free_software.md), [free culture](free_culture.md) or freeware (gratis, free as in beer) software. The differences are 
ese: 


- Unlike public domain, **[free software] (free_software md) and [Tree cultural] (free_culture.md) works are_usually still "owned" by someone**, they just try to relax the rules and make them less 
oppressive. A public domain work is completely unlimited and belongs to everyone and no one, while free software/Culture may still require and legally enforce certain freedom-compatible 
conditions such as giving credit to the author or [copyleft](copyleft.md). 

- **Public domain software is not always [free software](free_software.md)** -- PD software is free (as in freedom) only if its source code is available and also in the public domain (without 
source code freedoms 1 and 2 in the definition of free Software are violated). 

- **Freeware/gratis just, means available_for_no.price**, very often under specific restrictive conditions such as "for personal use" only and without the access to the source code. Public domain 
is not only gratis but also without any legal limitations on use. 


## Which Works Are In The Public Domain? 


This is not a trivial question, firstly because the term *public domain* is not clearly defined: the definition varies by each country's laws, and secondly because it is non-trivial and 
sometimes very difficult to assess the legal status of a work. 


Corporations and [capitalism](capitalism.md) are highly hostile towards public domain and try to destroy it, make it effectively non-existing, as to eliminate "free" works competing with the 
consumerist creations of the industry. Over many years they have pushes towards creating laws that make it extremely difficult and rare for works to fall into public domain. 


Sadly due to these shitty laws most works created in latest decades are NOT in the public domain because of the copyright] (copyri prema) [cancer] (cancer md): copyright is granted automatically 
without an registration or fee, to the author of any shit ty vartistie creation, and its term lasts mostly for **the whole life of the author plus 76 years!** In some countries this is life + 106 
years. he US, copyright lasts 96 years from the publication of the work (every January 1st there is So called public domain day celebrating new works entering the US public domain). In some 
countries it is not even possible to legally waive (give up) one's copyright. And to make matters worse, copyright isn't the only possible restriction of an intellectual work, there are also 
[patents](patent.md), [trademarks](trademark.md) and other kinds of [intellectual property](intellectual property.md). 


Another bad news is. that works in a **"weak" public domain**, i.e. most recent PD works or works that. entered PD by some obscure little law, may as well stop being PD by introducing some shitty 
retroactive law (which has happened). So one may not be feeling completely safe going crazy by utilizing some recent PD works. 


We therefore devise the term **safe/strong public domain**. Under this we include works that are pretty safely PD more or less world-wide, even considering possible changes in laws etc. Let us 
include these works: 


- Works published at least 100 years ago whose author probably died at least 70 years ago. 

- Works **clearly and properly: marked by a reliable PD [waiver](waiver.md) such as [CC0](ccO.md). However an extra effort needs to be taken to assure that the work e.g. isn't a derivative work 
of copyrighted work, or that patents are waived with software. 

- Works that under any "reasonable" law can not be covered by "intellectual property", e.g. math equations, colors etc. 


creative commons | (creative commons.md) has created a o:puptie domain mark** that helps mark and find works that should be in a world-wide public domain (this is not a waiver though, it is 
asically only us as a metadata for very old works to be better searchable). 


There are a number of places on the internet to look for public domain works, for a list see below. 
## How To Create Public Domain Works 


If you want to create a PD work (which you, should), .then.generally in that work **you must not use any non-public domain work**. So, for example, you can NOT create a public domain fan fiction 
story about Harry Potter because Harry Potter and his universe is copyrighted. Similarly you can't just use randomly googled images'in a game you Created because the images are most likely 
copyrighted. Small and obscure exceptions (fonts, freedom of panorama, ...) to this may exist in laws but it's never good to rely on them, it's best to keep it safe and simply avoid utilizing 
anything non-PD within your works. 


Also **you can NOT use anything under piatt use](fair use.md)**! Even though you could yawru lly use someone else's copyrighted work under fair use, inclusion of such material would, by tho fair 
use rules, limit what other would be able to do with your work, making it restricted and therefore not public domain. Example: you can probably write a noncommercial Harry Potter fan fiction and 
share it with friends on the internet because that's fair use, however this fan fiction can never be public domain because it can't e.g. be used commercially, that would no longer fall under 
fair use, i.e. there is a non-commercial-use-only restriction burdening your work. It doesn't even help if you get an explicit permission to use a copyrighted work in your work unless such 
permission grants all the right to everyone (not just your work). ( I got a mascot removed from [SuperTuxKart](supertuxkart.md) by this argument, mere author's permission to use his work isn't 
enough to make it free as in freedom. -drummyfish } 


So you, can only use your own original creations and other ppblic. domain works within your PD work, Here you should highly prefer your. own. creations because that, is gegally the safest, no one can 
ever chat lenge your right to reuSe your own creation, but there is a low but considerable chance that someone else's PD work isn't actually PD or will seize to be PD by some retroactive law 
change. So when it only takes a small effort to e.g. photograph your own textures for a game instead of using someone else's PD textures, choose to use your own. 


f NOTE: The above is, kind of arguing for reinventing wheels whic goes. a little bit against our philosophy of remixing and information sharing, but we are forced to do this by the system. We are 
orced to reinvent wheels to ensure that users of our works can't be legally bullied. -drummyfish } 


In cases where you DO reuse other PD works, try to minimize their number and try to make sure they belong to the actual **safe** public domain (see above). This again minimizes legal risk and 
additionally makes it easy to document and prove the sources. 


As a next step make sure you clearly **document** your work and the sources you use. This means you write down where all the works contained in your work come from, e.g. in your [readme] 
(readme md): Explicitly mention which things you have created yourself (*"I, ..., have created everything myself except for X, Y and A and wi ich things come from other people and where you 
have found den It is great to also archive the proofs of the third party source being public domain (e.g. use the [Internet Archive](internet archive.md) to snapshot the page with a PD texture 
you've found). 


Finally you need to actually release your work into the public domain. It must be stressed that it is NOT enough to write *"my work is public domain"*, this is simply legally insufficient (and 
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in.many countries you can't even put your work into public domain, which is why_you need a more sophisticgted tool)..You need to use a public domain [vaiver](waivep.md) (similar to a [license] 
(License mo) which you just put alongside your work (e.g. into the "LICENSE file), plus it is also good to explicitly write (e.g. in your readme sentence such as *""I, ..., release this 
work into public domain under CCO 1.0 {tink public domain"**. Keep in mind that the WORDING may be very important here, so try to write this well: we mention the license name AND its version 
(eco 4:0. it may even be better to fully state *Creative Commons 1. al as well as a link to its exact text and also mention the words *public domain* afterwards to make the intent of public 
omain yet clearer to any doubters. Here we used what's currently probably the best waiver you can use: [Creative Commons Zero](cc@.md) (CCO) -- this is what we recommend. However note that CCO 
oni waives copyright and not other things like [trademarks](trademark.md) or [patents](patent.md), so e.g. for [software](software.md) you might need to add an extra waiver of these things as 
well. 


{ I personally use the following waiver IN.ADDITION to CCO with my software to attempt waiving of patents, trademarks etc. I made it by taking some standard waiver companies use to. steal 
rights" of their employees and modifying it to make it a public domain waiver. If you want tO use it, make sure you mention it is an EXTRA, Additional waiver alongside CCO. The waiver text 


follows. ~drummyfish 


*Each contributor to this work agrees that they waive. any exclusive rights, including but not limited to copyright, patents, trademark, trade dress, industrial design, plant varieties and trade 
secrets, to any and all ideas, cóncepts, processes, discoveries, improvements and inventions conceived, discovered, made, designed, reSearched or developed by the contributor either solely or 
jointly with others, which relate to this work or result from this work. Should any waiver of such right be judged legally invalid or ineffective under applicable law, the contributor hereby 
grants to each affected person a royalty-free, non transferable, non sublicensable, non exclusive, irrevocable and unconditional license to this right.* j 


NOTE: You may be thinking that it doesn't really matter if, you waive your rights properly, and very clearly if you know you simply won't sue anyone, you may think it's enough to just write "do 
whatever you want with my creation". But you have to remember others, and evén you yourself, can't know i you won't change your mind in the future. A clear waiver is a **tegal guarantee** you 
provide to others, not just a *vague promise of someone on the Internet*, and this guarantee is very valuable, so valuable that whether someone uses your work or not will often come down to 
this. So waiving your "rights" properly may increase the popularity and reusability of your work almost as much as the quality of the work itself. 


For an example of a project project properly released into public domain see the repository of our [LRS](lrs.md) game [Anarch](anarch.md). 
## Where To Find Public Domain Works 


There are quite a few places on,the Internet where you may find, public domain works. But firstly let there be a warning: you always **have to** check the public. domain. status of works you find, 
it is extreme Ly common for people on the Internet to not know what public domain is or how it works so you will find many *false positives* that are called public domain but are, in fact, not. 
This antiele should have given you a basic how-to on how to recognize and check public domain works. With this said, here is a list of some places to search (of course, this list will rot with 
time): 


- Ve **old works and, traditional folk art** are mostly in the public domain, e.g. Shakespeare's plays or folk songs. Niçe example of reusing folk art is e.g. [Richard pea} man'gl(rms md .*Free 

Software Song* that takes the melody of a Bulgarian folk song *Sadi Moma*. However watch out for traps, e.g. [trademarks](trademark.md) that may exist despité nó copyright (e.g. Encyclopedia 

Britannica) or weird nationalist laws against disrespecting à country's folklore that may possibly exist too. 

- **[Wikimedia Commons) (https: //commons wikimgdia org/wiki/Maip Page)**: Contains only free as in freedom works among which are many PD ones. You.can search. for. them with queries such as “cat 

incategory:cc-zero . This site is quite reliable and serious about licensing, if you Tind a work marked as PD here, you can be reasonably sure this information is true. 

- **[Internet Archive](https://archive.org/)**: The biggest Internet_archive, huge amount of mainly old works such as scanned books and photos. Beware that this site contains all kinds of works 

from PD to proprietary] (proprietary md) and works marked as PD should be checked as there can be errors. There is an *advanced search* tool that can help in searching for PD works, for example 

[this query](ht ps://archive .org/search. php?query=possib le-copyright - status%3A%28NOT_IN_COPYRIGHT%29%200R%20 Licenseur 1%3A%28%22ht t p%3A%2F%2Fcreativecommons .org%2Fpub Licdomain%2Fmark%2F1.0%2F 

%22%29%200R%20 Licenseur 1%3A%28%22ht t p%3A%2F%2Fcreativecommons.org%2Fpub Licdomain%2Fzero%2F1.0%2F%22%29) tries to achieve this. 

Edd Opensameart] (https: ("apengameart -org/ **: Site for sharing free as in freedom [game] (game .md) art (pictures, 3D models, sounds, ...) among which are many under [CCO](ccO.md), i.e. PD. 

Submitted works are checked reasonably well so any CCO work you find here is likely truly PD. 

**[Freesound](https://freesound.org/)**: Site for sharing sound recordings and sound effects, contains many [eco] (Cee .md) sounds that should be PD. 

**[Project by (https. /stocksnap-io]" "f Quality p **: Archive of old digitized books. NOT ALL are PD Dae the real old ones should be. Generally books from before the 20th century should be PD. 
j i 


- **[Stocksnap](https stocksnap.io)**: Quality photos and "stock images" under [ecol (cca ma) i.e. è 

- **[Librivox](https://librivox.org)**: Public domain audiobooks made by volunteers that read PD books from Project Gutenberg. 

- **[Wikisource](http /en.wikisource.org/wiki/Main Page)**: Repository of texts, similar to Project Gutenberg, same rules apply (not all texts here will be PD but the real old ones should be). 
- **[Openclipart](htt /openclipart.org)**: Vector graphics, all under leeeltega. md), i.e. PD in theory, **however** there do appear pictures that are derivative works of copyrighted works for 
which of course is is irrelevant. Check very well anything you download from here. 


afan Blendswap] (https: //waw.bLendswap.com/)**: Site for exchanging 3D models for [Blender](blender.md), not all models are PD but the ones marked CCO should be, however **NOT those marked as 
an art"! 

LT Wikidata](https://www.wikidata.org/piki/Wikidata;Main Page)"*: Database of "everything", published as a whole under fecal (eco. md) which, should make it PD, **however** it will contain 
information about proprietary works which may make this status questionable sometimes. If you only use data that don't fatl under thi$ you should be safe. 

T p.vs np.md ---------- 

# P vs NP 


*P vs NP* is one of the greatest and most important yet unsolved problems in [computer science] (computer science md); it is the question of whether the [computational class] fa 
(computational complexity.md) [P](p.md) is equal to Class LNP] (np: md) or, in Simple terms, whether certain problems for which no "fast" solution is known can in fact be solved "fast". This is 
very important e.g. for algorithms used in [cryptography](cryptography.md). This problem is in fact so important that it's one of the seven Millennium Prize Problems. **There is a million dollar 
reward for solving this problem**. 


It is believed and sometimes relied on that P !- NP (in which case P.would be a proper subset of NP), but a mathematical proof doesn't exist yet. If it was surprisingly 
might be practical consequences for cryptography in which most algorithms rely on the problems in question being difficul (stow) to solve -- a proof of P = NP could lea 
breaking encryption, but that is not a certainty, only one of possible scenarios. However any solution to this problem would be revolutionary and ground breaking. 


proven that P = NP, there 
d to fast algorithms for 


## Explanation 


In the context of {computational com jexity] (computational complexity md) of algorithms we talk about different types of algorithm time complexities, i.e. different "speeds" of algorithms, This 
"speed" doesn't mean actual running time o he algorithm in real life but rathér how quickly the running time grows depending on the amount of input data to it, i.e. we are interésted only in 
the shape of the function that describes how the amount of input data affects the running time of the algorithm. The types of time complexity are named after mathematical functions that grow as 
quickly as this dependence, so we have a *constant* time complexity, *logarithmic* time complexity, *linear* time complexity etc. 


Then we have classes of computational problems. The classes divide problems based on how "fast" they can be solved. 


The, class P stands for **polynomial** and is defined as all problems that can be solved by an algorithm run on a **deterministic [Turing machine](turing machine.md)** (a theoretical computer) 
with a *polynomial* time complexity. 


The class NP stands for **non-deterministic polynomial** and is defined as all problems that can be solved by an algorithm run on a **non-deterministic Turing machine** with a *polynomial* time 
complexity. I.e. the definition is the same as for the P class with the difference that the Turing machine iS non-déterministic -- such a machine is faster because it can make kind of "random 
correct guesses" that lead to the solution more quickly. Non-deterministic computers are only theoretical (at least for now), computers we have in real life cannot perform such randomly correct 
guesses It is known that the solution to all NP problems can be verified in *polynomial* time even by a deterministic Turing machine, we just don't know if the solution can also be found this 
quickly. 


Basically P means *"problems that can be solved quickly"* and NP means *"problems that can be verified quickly but we don't know if they can also be solved quickly"*. 
The question is whether all NP problems are in fact P problems, i.e. whether *all problems that can be verified quickly can also be solved quickly*. It is believed this is not the case. 


T2 python.md ---------- 


l1 quantum gate.md ---------- 
# Quantum Gate 


{ Currently studying this, there may be errors. -drummyfish } 


Quantum, (logic) gate is a [quantum computing] (quantum, md) equivalent of a traditional Hogg gatel(19 ic.gate.md). A quantum gate takes as an input *N* [qubits](qubit.md) and transforms their 
States to néw States (this is different from classical logical gates that may potentiatly havé a différent number of input and output values). 


Quantum gates are represented by [complex] (comp lex number md) [matrices (matrix,md) that transform the 


: qubit states (which,can be seen as points in multidimensional space ), A. 
rix. These matrices have to be **unitary**. Operations performed by quantum gates may be reversed, unlike those of classical logic 


see Bloch sphere 


gate operating on *N* qubits is répresen bya 

gates. 

We normally represent a single qubit state with a **column** [vector] (vector, d) *|a» = aQ * |0» + a1 * |1>,=> [a60, a1]" (took up bra-ket notation). Multiple qubit states are represented as a 
uct -md) of the individual state, 6.g. *|a,b> = [a0 * bO, aO * b1, a1 * bO, ai * bi]*. Applying a quantum gate *G* to Such a qubit vector *q* is performed by simple 
s 


[tensor próduct](tensor pro 
matrix multiplication: *G * 


44 Basic gates 

Here are some of the most common quantum gates. 
### Identity 

Acts on 1 qubit, leaves the qubit state unchanged. 
10 
aT 
## Pauli Gates 

Act on 1 qubit. There are three types of Pauli gates: X, Y and Z, each one rotates the qubit about the respective axis by [pi](pi.md) radians. 


The X gate is: 
01 
1.8 
The Y gate is: 
0 -i 
1.19 
The Z gate is: 
1 0 
Bet 


## NOT 
The not gate is identical to the Pauli X gate. It acts on 1 qubit and switches the probabilities of measuring 0 vs 1. 
## CNOT 


Controlled NOT, acts on 2 qubits. Performs NOT on the second qubit if the first qubit is *|1>*. 
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T-2------- quaternion.md ---------- 
# Quaternion 


Quaternion is a type of number, just like there are integer numbers, real numbers or [imaginary numbers] (com lex_number.md). They are very useful for certain things such as 3D rotations (they 
have some advantages over using @.g. Euler angles, for example they avoid Gimbal lock, they are also faster than transform matrices etc.). Quaternions are not so asy to understand but you don't 
o 


actually need to fully grasp and visualize how they work in order use them if that's not your thing, there are simple formulas you can copy-paste to your code and it will "just work". 


Quaternions are an extension of [complex numbers] (complex number .md) (yeu should first check out complex numbers before tackling quaternions); while complex numbers can be seen as two 
imensional -- having the real and imaginary part -- quaternions would be seen as four dimensional. A quaternion can be written as: 


*a + bi + cj + dk* 
where *a*, *b*, *c* and *d* are real numbers and *i*, *j* and *k* are the basic quaternion units. For the basic units it holds that 
*i^2 = j^2 = kA2 = ijk = -1* 


nel by four components and not three?** Simply put, numbers with three components don't have such nice properties, it just so happens that with four dimensions we get this nice system that's 
useful. 


rived, using basic algebra and the above given axioms. Note that **quaternion multiplication is non-commutative** (*q1 * 


Operations with quaternions such as their multiplication, can simply be d 
q2 != +2 * = (qi * q3*). 


qi*), bat it is still associative (*qi * (q2 * q3) q2) 
A **unit quaternion** is a quaternion in which *a^2 + b^2 + c^2 + d^2 = 1*. 
A **quaternion negation** (*q^-1*) is obtained by multiplying *b*, *c* and *d* by -1. 
## Rotations 
Only unit quaternions represent rotations. 
Rotating point *p* by quaternion *q* is done as 
*q^-1* (0 + p.x i+ p.y j + p.z k) * q* 
Rotation quaternion can be obtained from axis (*v*) and angle (*a*) as 


*q cos(a/2) + sin(a/2) * (v.x i+ v.y j + v.z k)* 
qubit.md ---------- 


b 
many states "in between so called [superposition](supérpositión.md)). Physically qubits can be realized thanks to quantum states of particles, e.g. the polarization of a photon or the 


Qubit is a [guantum compuging |(quantum m) equivalent of a bit] (bit md). white its in classical computers can have one of two state -- either 0 ọr 1 -- a qubit can additionally have infinitely 
an 
spin of a photon. Qubits are processed with [supero daten] quantum gate.md). 


**whenever.we measure a qubit, we get either 1 or 0**, just like with a normal bit. However during quantum computations.the internal, state of a qubit is more.complex. This state determines the 
**probabilities** of measuring either 1 or ©. When the measurement is performed (which is basically any observation of its state), the qubit state collapses into one of those two states. 


Now we will be dealing with so called **pure states** -- these are the states that can be expressed by the following representation. We will get to the more complex (mixed) states later. 
The state of a qubit can be written as 
*A * |0» + B * |1>* 


where *A* and *B* are complex numbers] (complex number md) such that *A^2 + BA2 = 1*, *|0»* is a vector [0, 1] and *|1>* is a vector [1, 0]. *A^2* gives the probability of measuring the qubit in 
the state 0, *B^2* givés the probability of measuring 1. 


The vectors "Iz" and *|1>* use so called bra-ket notation and represent a vector basis.of a two dimensional state. So the qubit space is.a point in a space with two axes, but since, *A* and *B* 
are complex, the whole space is four dimensional (there are 4 variables: *A* real, *A* imaginary, *B* real and *B* imaginary). However, since *A + B* must be equal to 1 ([normalized] 

(norma ization-md) p; the point cannot be anywhere in this space. Using logic^TM we can figure out that the final state of a qubit realiy IS a point in two dimensions: a point on a sphere (Bloch 
Sphere). A point of the sphere can be specified with two coordinates: *phase* ([yaw](yaw.md), © to 2 [pi](pi.md), can be computed from many repeated measurements) and *p* ([pitch](pitch.md), 
says he probability of measuring 1). It holds that: 


*A = sqrt(1 - p)* 
*B - e^(i * phase) * sqrt(p)* 


The sphere has the state |0> at the top (north pole) and |1> at the bottom (south pole); these are the only points a normal bit can occupy. The equator is an area of states where the probability 
of measuring © and 1 are equal (above thé equator gives a higher probability to 0, below the equator to 1). 


Now a qubit may actually be in a more complex state than the pure states we've been dealing with until now. Pure states can be expressed with the state vector described above. Such a state is 
achieved when we start with a qubit of known value, e.g. if we cool down the qubit, we know it has the value *|0>*, and transforming this state with quantum gates keep the state pure. However 
there are also so called **mixed states** which are more complex and appear e.g. when the qubit may have randomly been modified by àn external event, or if we start with a qubit of unknown 
state. Imagine if we e.g. start with a qubit that we known is either *|0>* or 1>*. In such case we have to consider all those states separately. A mixed state is composed of multiple pure 
states. Mixed states can be expressed with so called **density matrices**, an alternative state representation which is able to encode these states. 

T quine.md ---------- 


Quine is a nonempty [program] (program. md) which prints its own source code. It takes no input, iust prints out the source code when run (without [cheating](cheatin .md) such as, reading the 
Source code Pite): Quine is asically a Self-replicating program, just as [in real wordt l we may construct robots capable of creating copies of themselves GS we humans àre such 
robots). The name *quine* refers to the philosopher Willard Quine and his paradox that shows a structure similar to self-replicating programs. Quine is one of the 
standard/[fun](fun.md)/[interesting](interesting.md) programs such as [hello world](hello world.md), [99 bottles of beer](99 bottles.md) or [fizzbuzz](fizzbuzz.md). 


Quine can be written in any, [Turing Somptete) (turing compieteness cmd? {}angua le (programming. lan uage.md), the challenge is in.the [self reference (seit reference md) -- normally we cannot. just 
Single; Line print e String literal containing the source because tha tring titéral would have to Contain itself, making it [infinite](infinity.m in length. The idea commonly used to solve 
this problem is following: 


1. On first line start a definition of string *S*, later copy-paste to it the string on the second line. 
2. On second line put a command that prints the first line, assigning to *S* the string in *S* itself, and then prints *S* (the second line itself). 


This is a quine in [C](c.md): 
#include <stdio.h> 


char s[] = "#include <stdio.h>%cchar E = 96c96s96c;96cint main(void) ( printf(s,10,34,s,34,10,10); return 0; Jj"; 
int main(void) ( printf(s,10,34,s,34,10,10); return 0; } 


This is a quine in [Python](python.md): 
in([chr(115),chr(61),chr(34)]) * s* s 
e Es 619) Ces Cone esas 7) + s str( 


Sa 
E 


Q: 
.joii 


*All races of men are to coexist in love and peace, despite their differences." 


Races of people are very large, loosely defined groups of genetically similar (related) people. Races usually significantly differ by their look and in.physical, mental and cultural aspects. The 
topic of human race is nowadays forbidden to be Critically discussed and researched, however there at least exists a number of older’ research, information hidden in the underground and some 
things about race are completely obvious to those with an open mind. [Good society] { less retarded society md), unlike for example our current fsa itaHist](eapitalism md) society, acknowledges 
(petieel nore between pyran races and lets them coexist peacefully in social equality despite their differences and without any need for [butlshit](bullshit.md) such às [political correctness] 
political correctness.md). 


Instead of the word *race* the politically correct camp uses words such as *ethnicity* -- it's funny, sometimes they say no such thing as race exists. but other times they simply have to operate 
with the fact that people are genetically diverse, e.g. when they accuse others of [facism](racism.md), as existence of discrimination based on genetic differences between people necessarily 
implies the existence of genetic differences between people -- so here they try to Substitute the word *race* for a different word so as to make their self-contradiction less obvious. Anyway, it 


doesn't work 


**Race can be told from the shape of the skull and one's [DNA](dna.md)**, which finds use e.g. in forensics to help solve crimes. It is officially called the *ancestry estimation*. Some idiots 
say this should be forbidden to do because it's "racist" lmao. Besides the obvious visual difference such as skin color **races also have completely measurable differences acknowledged even by 
modern "science"**, for example unlike other races about 90% of Asians have dry earwax. Similar absolutely: measurable differences exist in height, body odor, alcohol and lactose tolerance, high 
altitude tolerance, vulnerability to speci ric diseases, hair structure, cold tolerance, risk of obesity ehavior (see e.g. the infamous *[chimp out J (ham -out md) behavior of black peopte) and 
others. While dryness of earwax is really a minor curiosity, it is completely unreasonable to believe that race differences stop at traits we humans find unimportant and that genetics somehow 
magically avoids affecting traits that are harder to measure and which our current society deems politically incorrect to exist. In fact differences in important areas such as intelligence were 
measured very well -- these are however either censored or declared incorrect and "debunked" by unquestionable "science" authorities, because politics. 


The. politically correct camp further argues that there wasn't enough.time for human.races to develop significant differences as evolution operates ọn scales of millions of years while the 
evolution of modern humans was taking part about in an order of magnitude smaller time scale. However it has been shown that evolution can be much faster under specific conditions, e.g. those of 
rapid environment change (shown e.g. in a documentary *Laws of the Lizard* on anoles that show signs of evolutionary change only after 14 years, also see HE the book *The 10,000 Year 
Explosion* talking about actual acceleration of human evolution) and interbreeding with other species (e.g. Neanderthals, which European population bred with but African population didn't), 
which did occur when humans spread around the world and had to live in vastly different conditions -- successful civilizations themselves actually furthermore started to rapidly. change their 
environment to something that favors very different traits. We can take a look at the enormous differences between dog breeds which have been bred mostly during only the last 200 years and whose 
differences are enormous and not only physical, but also that of intelligence and temperament -- yes, the breeding of dogs has been selective, but a rapid change in environment may have a 
similar accelerating effect, and the process in humans still took many tens of thousands of years. For example races of slaves were probably selectively bred, even if unintentiona yr as 
physically fit slaves were more likely to survive than those who were smart; similarly in prospering civilizations, e.g. that of Europe, where trade, business and development of technology (e.g. 
military) became more crucial for survival than in primitive desert or jungle civilizations, different traits such as intelligence became preferred by evolution. 


Denying the facts regarding human race is called [race denialism](race denialism.md), the acceptance of these facts is called [race realism](race_realism.md). Race denialism is part of the basis 
of today's [pseudole fist] (pseudolert. md) political ideology, théories such as poly enism (multiregional hypothesis) are forbidden to be supported and they're ridiculed and demonized by 
mainstream information sources like [Wikipedia] (wiki edia.md) who only promote the ipotitically correct](political Correctness.md) "out of Africa" theory. [SJWs](sjw.md) reject any idea of a 
race with the same religious fanaticism with which Christian fanatics opposed Darwin's evolution theory. 
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Most generally races are called by the color of their skin, the most apparent attribute, i,e. White (Caucasian), Black (African, so called [negro](negro.md) and [ne roid](negroid.md)), Yellow 
(Asian) and Brown (Indian). But the lines can be drawn in many ways, some go as far as calling different nations separate races (e.g. the Norwegian race, Russian race etc.). 


There is a controversial 1994 book called *The Bell Curve* that deals with differences in intelligence between races. [SJWs](sjw.md) indeed tried to attack it, however international experts on 
intelligence agree the book is correct in saying average intelligence between races differs (see é.g. [The Wall Street Journál's Mainstream Science on 
Intelligence](https://web.archive.org/web/20120716184838/http: //www.lrainc.com/swtaboo/taboos/wsj main.html)). An online resource with a lot of information on racial differences is e.g. 

DEEP Cowal humanbiotogicaldiversity- com. See also eig. https://en.metapedia.org/wiki/Race and morphology. Note that even though the mentioned sites may be fascist, biased and contain propaganda 
of their own, they provide links to resources which the pseudoleftist mainstream such as [Wikipedia](wikipedia.md) and [Google](google.md) simply censor -- while we may not promote the po ics 
and opinions of mentioned sites, we link to them to provide access to censored information so that one can seek truth and form his own opinions. 


ade you want a relatively objective view on races, read.old (pre 1950) books,** See for example the article on *NEGRO* in 11th edition of Fncyclopedia Britannica (1911 
page 344 of the 19th volume that "Mentally the negro is inferior to thé white" and continues to cite thorough study of this, finding that blac 
the intellect always went down, however it states that negro has e.g. better sense of vision and hearing. 


P l „which clearly states on 
children were quite intelligent but with adulthood 


In relation to Fechnology] (Fech,md)/ [math] (math md)/ [science (science md) it is useful to know the differences in intellect between different races, though cultural and other traits linked to 
races may also play a big ròle. It is important to Keép in mii intelligence isn't one dimensional, it's one of the most complex and complicated concepts we can be dealing with (remember the 
famous test that revealed that chimpanzees greatly outperform humans at certain intellectual tasks such as remembering the order of numbers seen for a very short period of time). We can't . 
simplify to a single measure such as [IQ](iq.md) Score. Let intelligence here mean simply the ability to perform well in the area of our art. And of course, there are smart and stupid people in 
any race, the general statements we make are just about statistics and probabilities. 


The smartest races in this regard, seem to be Pg (jew,md) and [Asians] asian.md) (alsa found so by the book_*Bell.Curve*), closely followed by the general white race. There is no question 
about the intelligence of JewS, the greatest thinkers of all timés were Jewish ([Richard Stallman](rms.md), [einstein |(einstein.md), [Marx] (marx.md),~[Chomsky](chomsky.md), even [Jesus 
(jesus.md) and others). Jews seem to have a very creative intelligence while Asians are more mechanically inclined, they can learn a skill and bring it to perfection with an extremely deep study 
and dedication. The African black race (in older literature known as the *negro*) is decisively the least intelligent -- this makes a lot of sense, the race has been oppressed and living in 
harsh conditions for centuries and didn't get much chance to evolve towards good performance in intellectual tasks, quite the opposite, those who were physically fit rather than smart were 
probably more likely to survive and reproduce as slaves or jungle people (even if white people split from the blacks relatively recently, a rapid change in environment also leads to a rapid 
change in evolution, even that of intelligence). 1892 book *Hereditary Genius* says that the black race is *about two grades* below the white race (nowadays the gap will most likely be. tower) 
Hispanics were found to perform in between the white and black people. There isn't so much info about other races such as the red race or Eskimos, but they re probably similarly intelligent to 
the black race (The above mentioned book *Hereditary Genius* gives an intelligence of the Australian race *at least one grade below that of the negro*). The brown races are kind of complicated, 
the Indian people showed a great intellectual potential, e.g. in lehess] (chess: md), [math](math.md), philosophy (nonviolence inherently connected to India is the most intellectually advanced 
philosophy), and lately also [computer science](compsci.md) (even though many would argue that "[pajeets](pajeet.md)" are just trained coding monkeys). 


Increasing multiculturalism and mixing of the races will likely make all of this less and less relevant. But for now the differences still stand. 
[LRS](lrs.md) philosophy is of course FOR multiculturalism and mixing of races. Biodiversity is good and it would probably also help reduce racial [fascism](fascism.md)/nationalism. 
## See Also 


- [stereotype] (stereotype.md) 


The term racism has nowadays two main definitions, due to the onset of [newspeak](newspeak.md) : 


- **original definition**: Great hatred and/or hostility towards specific [races](race.md) of people. For example the [Nazi](nazism.md) genocide of [Jews](jew.md) was an act of racism in the 
sense of the term's original meaning. 

- nal espeak] (newspeak .md) definition**: Disagreement with the mainstream [pseudoleftist](pseudoleft md) propaganda regarding the question of human [race](race.md). For example anyone who claims 
human race has a basis in biology is a racist in the modern meaning of the term. 


## See Also 


- [political correctness](political_correctness.md) 
T randomness.md ---------- 
# Randomness 


*Not to be confused with [pseudorandomess](pseudorandomness.md).* 

TODO 

## Truly Random Sequence Example 

WORK IN PROGRESS ( Also I'm not too good at statistics lol. ~drummyfish } 

Here is a sequence of bits which we most definitely could consider truly random as it was generated by physical coin tosses: 


{ The method I used.to generate, this: I took a plastic bowl and 10 coins, then for each round I threw.the coins into the bowl, shook them [without looking, PED in case), then rapidly turned it 
around and smashed it against the ground. I took the bowl up and wrote the ten generated bits by reading the coins kind of from "top left to bottom right" (heads being 1, tails 85. -ürummyfish } 


00001110011101000000100001011101111101010011100011 
01001101110100010011000101101001000010111111101110 
10110110100010011011010001000111011010100100010011 
11111000111011110111100001000000001101001101010000 
11111111001000111100100011010110001011000001001000 
10001010111110100111110010010101001101010000101101 
10110000001101001010111100100100000110000000011000 
11000001001111000011011101111110101101111011110111 
11010001100100100110001111000111111001101111010010 
10001001001010111000010101000100000111010110011000 
00001010011100000110011010110101011100101110110010 
01010010101111101000000110100011011101100100101001 
00101101100100100101101100111101001101001110111100 
11001001100110001110000000110000010101000101000100 
00110111000100001100111000111100011010111100011011 
11101111100010111000111001010110011001000011101000 
01001111100101001100011100001111100011111101110101 
01000101101100010000010110110000001101001100100110 
11101000010101101111100111011011010100110011110000 
10111100010100000101111001111011010110111000010101 


sequence looks, i.e. basically how likely it is that by generating random numbers by tossing a coin will give us a sequence with statistical properties 


Let's now take a. look at how randoli e ^ 
) our obtained sequence has. 


m th 
(such as the ratio of 1s and Os) that 
There are.**494 1s and 506 Os**, i.e. the ratio is approximately 0.976, deviating from 1,0 (the value that infinitely many coin tosses should converge to) by only 0.024, We can use the [binomial 
distribution](binomial_distribution.md) to calculate the "rarity" of getting thiS deviation or higher one; here we get about 0.728, i.e. a pretty high probability, meaning that if we pe form 
1000 coin tosses like the one we did, we may expect to get the deviation we got or higher in more than 70% of cases (if on the other hand we only got HER 460 1s, this probability would be only 
0.005 suggesting the coins we used weren't fair). If we take a look at how the ratio (rounded to two fractional digits) evolves after each round of performing additional 10 coin tosses, we see 
it gets pretty close to 1 after only about 60 toSses and stabilizes quite nicely after about 100 tosses: 0.67, 0.54, 0.67, 0.90, 0.92, 1.00, 0.94, 0.90, 0.88, 1.00, 1.04, 1.03, 0.97, 1.00, 0.97, 
1.03, 1.10, 1.02, 0.98, 0.96, 1.02, 1.02, 1.02, 1.00, 0.95, 0.95, 0.99, 0.99, 0.99, 0.97, 0.95, 0.95, 0.96, 0.93, 0.90, 0.88, 0.90, 0.93, 0.95, 0.98, 0.98, 0.97, 0.97, 0.99, 1.00, 0.98, 0.98, 
0.98, 0.97, 0.96, 0.95, 0.94, 0.95, 0.95, 0.96, 0.95, 0.96, 0.95, 0.96, 0.95, 0.96, 0.95, 0.96, 0.96, 0.97, 0.97, 0.97, 0.95, 0.94, 0.93, 0.93, 0.93, 0.94, 0.94, 0.94, 0.96, 0.95, 0.96, 0.96, 
0.95, 0.96, 0.95, 0.95, 0.96, 0.97, 0.97, 0.96, 0.96, 0.95, 0.95, 0.95, 0.96, 0.97, 0.97, 0.97, 0.97, 0.96, 0.97, 0.98, 0.98. 


Let's try the [chi-squared test](chi squared test.md) (the kind of basic "randomness" test): *D - (^28 - 500)^2 / 500 + (506 - 500)^2 / 500 = 0.144*; now in the table for the chi square 
distribution for 1 degree of freedom (i.e. two categories, © and 1, minus one) we see this value of *D* falls somewhere around 30%, which is not super low but not very high either, so we can see 
the test doesn't invalidate the hypothesis. that we got numbers from a uniform random number generator. { I did this according to Knuth's *Art of Computer Programming* where he performed a test 
with dice and arrived at a number between 25% and 50% which he interpreted in the same way. For a scientific paper such confidence would of course be unacceptable because there we try to "prove" 
the validity of our Typo rosie Here we put much lower confidence level as we're only trying not fail the test. To get a better confidence we'd probably have to perform many more than 1000 
tosses. ~drummyfis' 


We can try to convert this to a. sequence of integers of different binary sizes and just "intuitively" see if the sequences still looks random, i.e. if there are no patterns such as e.g. the 
numbers only being odd or the histograms of the Sequences being too unbalanced, we Could also possibly repeat the chi-squared test etc. 


The sequence as 100 10 bit integers (numbers from O to 1023) is: 


57 832 535 501 227 311 275 90 267 1006 
730 155 273 874 275 995 759 528 52 848 
1020 572 565 556 72 555 935 805 309 45 
704 842 969 24 24 772 963 479 695 759 

838 294 241 998 978 548 696 337 29 408 
41 774 429 370 946 330 1000 104 886 297 
182 293 719 308 956 806 398 12 84 324 

220 268 911 107 795 958 184 917 612 232 
318 332 451 911 885 278 784 364 52 806 
929 367 630 851 240 753 261 926 859 533 


As 200 5 bit integers (numbers from © to 31): 


1 25 26 0 16 23 15 21 7 3 9 23 8 19 2 26 8 11 31 14 
22 26 4 27 8 17 27 10 8 19 31 3 23 23 16 16 1 20 26 16 
31 28 17 28 17 21 17 12 2 8 17 11 29 7 25 5 9 21 1 13 
22 0 26 10 30 9 O 24 0 24 24 4 30 3 14 31 21 23 23 23 
26 6 9 6 7 17 31 6 30 18 17 4 21 24 10 17 0 29 12 24 
1 9 24 6 13 13 11 18 29 18 10 10 31 8 3 8 27 22 9 9 

5 22 9 5 22 15 9 20 29 28 25 6 12 14 0 12 2 20 10 4 

6 28 8 12 28 15 3 11 24 27 29 30 5 24 28 21 19 4 7 8 
9 30 10 12 14 3 28 15 27 21 8 22 24 16 11 12 1 20 25 6 
29 1 11 15 19 22 26 19 7 16 23 17 8 5 28 30 26 27 16 21 


Which has the following histogram: 


number: 0 1 2 3 


4 5 6 7 8 9 10 11 12 13 14 15 
count: 6 6 3 6 5 5 7 5 11107 6 7 3 4 5 
number: 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 
count: 7 9 3 5 4 8 7 8 9 4 8 6 8 6 6 6 


And as 250 4 bit integers (numbers from O to 15): 
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0147408513155381337441251042 15 1 
11 6 8 9 11 4 4 7 6 10 4 4 15 14 3 11 13 14 1 0 0 13 3 
151523128 136212122211149 15254 13 4 
1103410152418 0 6 30 4 15 0 13 13 15 10 13 14 
1319263127146 154102410141510759 
0 10 7 0 6 6 11 5 7 2 14 12 9 4 10 15 10 0 6 8 13 13 9 
2139251131334141532663801215144 
371012143 126 1112 6 15 11 142 14 39 5 9 9 O 
4 159 4 12 7 0 15 8 15 13 13 5 1 6 12 4 1 6 12 0 13 3 
14 8 5 6 15 9 13 115 33 122 15 14 1 7 9 14 13 6 14 


This has the following histogram: 


numer: 0 12 3 4 5 6 7 8 9 10 11 12 13 14 15 
count: 18 14 19 18 23 15 18 11 11 14 9 10 13 20 18 19 


TODO: see how much some compression program can compress it? Visualize it somehow to reveal correlations? 
---------- rationalwiki.md ---------- 
# RationalWiki 


RationalWiki. (https: (/rationalwiki-org/) isa [toxic (toxic.md) child [atheist] (atheism md) pseudgrationalist/|[pseudoske tig] (pseudoskepticism.md) [SJW](siw-md) [wiki] (wiki md) website that 
specializes in attacking rational views on controversial topics on the Internet. It is recommended you delete is website from your bookmarks or it wi probably givé you brain cancer. 


Typically for a i gseudoleftist](pseudoleft md) site, a tactic of using misleading names.is widely used.as one of the main means of operation, e.g. [racial realism] (racial realism md) is called 
racism](racism.md), political y inconvenient’ [science](science.md) iš called [pSeudoscience](pseudoscience.md) and, of course, [soyence](soyencé.md) is promoted as the "only true unquestionable 
which is of course very misleading, if not a downright lie -- the 


science cience.md)". The name of the wiki itself seems to suggest it has something to do with [rationality](rationality.md) 
ul religion and cults such as [capitalism](capitalism.md) and {political correctness](political_correctness.md), while bashing 


s 
purpose if the wiki seems to be solely promotion of modern harm 
anything slightly off the mainstream. 


## See Also 


- [pseudoscepticism] (pseudoscepticism.md) 
---------- raycasting.md ---------- 
# Raycasting 


In [computer graphics] (graphics .md) raygasting refers to a rendering technique in which we determine which partscor the scene should be drawn according to which parts of the scene are hit by 
ays cast from the camera. This is based on the idea that we can trace rays of light that enter the camera by going backwards, i.e. starting from the Camera towards the parts of the scene that 
reflected the light. The term raycasting specifically has two main meanings: 


1, Lab] (3d md) raycasting s [Algorithm](algorithm.md) that works the same as [raytracing](raytracing.md) but without [recursion](recursion.md). I.e. raycasting is simpler than raytracing and 
only casts primary rays (those originating from the camera), hence, unlike in raytracing, there are no shadows, reflections and refractions. Raytracing is the extension of raycastihg. 

- ook 2D] 2d.md) raycasting**: Technique for rendering so called "[Preuqdospl(pseudoaD. md)" (primitive 3D) graphics, probably best known, from the old [game] (game md) Wolf3D (predecessor. of [boom] 
(doom. mi he Thé principle of casting the rays is the same but we only limit ourselves to casting the rays within à single dimensional plane and render thé envirónemnt by columns (unlike the 3D 
variant that casts rays and renders by individual pixels). 


## 2D Raycasting 
{ We have an official [LRS](lrs.md) library for advanced 2D raycasting: [raycastlib](raycastlib.md)! And also a game built on top of it: [Anarch](anarch.md). -drummyfish } 


2D raycasting can be used to relatively easily render."3Dish" looking environments (commonly labeled "[pseudo 3D](pseudo3D.md)"),, mostly some kind of right angled labyrinth. There are 
limitations Such as the inability for the camera to tilt up and down (which can nevertheless be faked with shearing). It used tó be popular in very old games ut can still be used nowadays for 
fembedded] (embedded md) Y. in [demos](demoscene.md) etc. It is pretty cool, very [suckless](suckless.md) rendering method. 


"retro" looking games, games for very weak hardware (e.g. 
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*raycasted view, rendered by the example below* 


The method is called _*2D* because even though the rendered picture looks like a 3D view, the representation of the world we are rendering is 2.dimensional (usuqty a grid, a top-down phan of the 
environment with cells of either empty spacé or walls) and the casting of the rays is performed in this 2D space -- unlike with the 3D raycasting which really does caSt rays in fully 3D 
environments. Also unlike with the 3D version which casts one ray per each rendered pixel (x *y rays per frame), 2D raycasting only casts **one ray per rendered column** (x rays per frame) 
which actually, compared to the 3D version, drastically reduces the number of rays cast and makes this method **fast enough for [real time](real time.md)** rendering even using 

[software rendering](sw rendering.md) (without a GPU). 


The principle is following: for each column we want to render we cast a ray from the camera and find out which wall in our_2D world it hits first, and at what distance -- according to the , 
distance we use [perspective](perspective.md) to calculate how tall the wall columns should look from the camera's point of view, and we render the column. Tracing the ray through the 2D grid 
representing the environment can be done relatively SIDE with algorithms norma ty used for line rasterization. There is another advantage for weak-hardware computers: we can easily use 2D 
raycasting **without a [framebuffer](framebuffer.md)** (without [double buffering](double buffering.md)) because we can render each frame top-to-bottom left-to-right without overwriting any 


pixels (as we simply cast the rays from left to right and then draw each column top-to-bottom). And of course, it can be implemented using [fixed point](fixed point.md) (integers only). 


The classic version of 2D raycasting -- as seen in the early 90s games,.-- only, renders walls with [textures] (texture md) ; floors and ceilings are untextured and_have_a solid color. The walls all 
have the same height, the floor and ceiling also have the same height in the whole environment. In the walls there can be sliding doors. 2D sprites fibi b boards] tor Clboard md) can be used with 
raycasting to add items or characters in the environment -- for correct rendering here we usual Ly need a 1 dimensional [2-buffer] (z buffer nd) in which we write distances to walls to correctly 
draw sprites that are e.g. partially behind a corner. However we can **extend** raycasting to allow levels with different heights of walls, floor and ceiling, we can add floor and ceiling 

texturing and, in theory, probably also use different level geometry than a square grid (however at this point it would be worth considering if e.g. [BSP](bsp.md) rendering wouldn't be better). 


### Implementation 


The core element to implement is the code for casting rays, i.e. given the square plan of the environment (8-8; game level), in which each square is either, empty or a wall, (which can possibly.be 
of different types, to allow e.g. different textures), we want to write a function that for any ray (defined by its start position and direction) returns the information about the first wall it 
hits. This information most importantly includes the distance of the hit, but can also include additional things such as the type of the wall, texturing coordinate or its direction (so that we 
can [shade] (Shading-md) differently Facing walls with different brightness for better realism). The environment is normally represented as a 2 dimensional [array] (array md), but instead of F 
explicit data we can also use e.g. a function that [procedural ly] (pFocgen md) generates infinite levels (i.e. we have a function that for given square coordinates computes what kind of square it 
is). As for the algorithm for tracing the ray in the grid we may actually use some kind of line [rasterization](rasterization.md) algorithm, HAN the **[DDA](dda.md) algorithm** (tracing a line 
through a grid is analogous to drawing a line in a pixel grid). This can all be implemented with [fixed point](fixed point.md), i.e. integer only! No need for [floating point](float.md). 


**Note on distance calculation and distortion**: When computing the distance of ray hit from the camera, we usually DO NOT want to use the [Fus tidean] (euclidean md) distance of that point from 
the camera position fas is tempting) -- that would create a so called fish eye effect, i.e. looking straight into a perpendicular wall would make the wall look warped/bowled (as the part of the 
wall in the middle of the screen is actually closer to the camera position so it would, by perspecti look bigger). For non-distorted rendering we have to compute a distance that's 
perpendicular to the camera plane -- we can see the camera plane as a "canvas" onto which we project the scene, in 2D it is a line (unlike in 3D where it really is a plane) at a certain distance 
from the camera (usually conveniently chosen to be e.g. 1) whose direction is perpendicular to the direction the camera is facing. The good news is that with a little trick this distance can be 
computed even more efficiently than Euclidean distance, as we don't need to compute a square root! Instead we can utilize the similarity of triangles. Consider the following situation: 


In the above *V* is the position of the camera (viewer ) which is facing towards the point *I*, *p* is thę camera plane. perpendicular to *VI* at the distance,1 from *V*. Ray *r* is cast from the 
camera and hits the point *X*. The length of the line *r* is the Euclidean distance, however we want to find out the distance *JX = VI*, which is perpendicular to *p*. There are two similar 
triangles: *VCA* and *VIB*; from this it follows that *1 / VA - VI / VB*, from which we derive that *JX - VB / VA*. We can therefore calculate the perpendicular distance just from the ratio of 
the distances along one principal axis (X or Y). However watch out for the case when *VA - VB - 0* to not divide by zero! In such case use the other principal axis (Y). 


Here is a complete b, eed fe gmap, exampte** that uses only [fixed point](fixed_point.md) with the exception of the stdlib [sin](sin.md)/[cos](cos.md) functions, for simplicity's sake (these can 
easily be replaced by custom fixed point implementation): 


#include <stdio.h> 
#include <math.h> // for simplicity we'll use float sin, cos from stdlib 


#define U_1024 // fixed-point unit 
#define LEVEL_SIZE 16 // level resolution 
#define SCREEN_W 100 
#define SCREEN_H 31 


int wallHeight [SCREEN W]; 
int wallDir|SCREEN W]; 
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int perspective(int distance) 


if (distance <= 0) 
distance - 1; 


return (SCREEN H * U) / distance; 


unsigned char level[LEVEL SIZE * LEVEL SIZE] - 
define E 1, // wall 


#define l 0, // floor 
DUlIELIIlillllEE 
IEIIEEELILILIIELTLIE 
IITPLLILIATLILTITITA 
IEIIEIEIEIEIETILII 
LILLETLITIUIIIteEl 
LTULLETLITLUIIIITel 
IEEIEIIIIIIIIIII 
IEEIEIIIIITIIITII 
IEILIUIIIIIIIl1lltE 
IEIIEIILIIIIIIEII 
IEIIEIILI1111EII 
IElIÜLIEEEILLÜIIII 
IEEIEILIILIIEEELLIE 
LEELELLIULLELILIEE 
LILLILEEEEELLEEE 
TTELTILITLITIEEEE 
#undef E 

#undef l 


unsigned char getTile(int x, int y) 


if Geos O11 Y < © || x >= LEVEL SIZE || y >= LEVEL SIZE) 
return 1; 


return level[y * LEVEL SIZE + x]; 


// returns perpend- distance to hit and wall direction (0 or 1) in dir 
int castRay(int rayX, int rayY, int rayDx, int rayDy, int *dir 


int tileX ry / U, 
tileY Y U, 
addX = i Nady = =1; 


// we'll convert all cases to tracing in +x, +y direction 
*dir = 0; 
if (raydx 5 


= 9) 
rayDx = 
(oe if (rayDx < 0) 


rayDx *= -1; 
addx = -1; 
rayX = (tilex +1) * U - rayX % U; 


if (rayby 5 == 0) 
rayl YDY c ; 

pise a (rajby « 0) 
rayDy *- -1; 
addY EN 


rayY (tiley +1) * U - rayY % U; 
int origX = rayX, 
origY = rayY; 


for (int i = 0; i < 20; ++i) // trace at most 20 squares 


int px = rayX % U, // x pos. within current square 
y = rayY % U, 

mp; 

i (py > ((rayDy * (px - U)) / rayDx) + U) 


tileY += addY; // step up 
rayY = ((rayY / U) + 1) * U 


tmp = rayX / U 
rayX += V raypx" * (U - py)) / rayDy; 
if (rayx / U t= tmp) the don t cross the border due to round. error 
rayX = (tmp + 1) 
*dir = 0; 
else 


tilex += addX; // step rignt 
rayX = ((rayx’ /U)* i1) * 


tmp - rayY / U 
rayY += traypy’ * (U - px)) / rayDx; 


if (rayY / U !- tmp) 
rayY = (tmp + 1) U - 1; 

edir = 1; 
J 
ii (getTile(tileX,tileY)) // hit? 
px = rayX - origX; 
py = rayY - origY; 
// get the perpend dist. to camera plane: 
return (px > py) ? ((px * U) / rayDx) : ((py * U) / rayDy); 


// the following would give the fish eye effect instead 
// return sqrt(px * px * py * py); 
} $ 


return 100 * U; // no hit found 


void drawScreen(void) 
for (int y = 0; y < SCREEN_H; ++y) 
int lineY = y - SCREEN H / 2; 
lineY = lineY >= © ? lineY : (-1 * lineY); 


for (int x = 0; x « SCREEN W; ++x 
putchar( (Lino >= wallHeight [x] 's i: (wallDir[x] ? '/' : '#')); 
putchar('\n'); 
$ 


int main(void) 


int camX = 10 * U + U / 4, 
camY = 9 * U+U/ 2, 
CamAngle- - 600, // U' => full angle (2 * pi) 
quit - 0; 


while (!quit) 


int forwX - cos(2 * 3.14 * camAngle) * n 
forwY - sin(2 * 3.14 * camAngle) * 
vecFromx = forwX + forwY, 773 le 
vecFromY = forwY - forwX, 
vecToX - forwX - forwY, // rightmost ray 

vecToY - forwY * forwX; 


tmost ray 


for (int i = 0; i < SCREEN W; ++i) // process each screen column 


hh interpolate rays be tigen vecFrom and vecTo 


int rayDx = (SCREEN W - 1 - i) * vecFromX / SCREEN W + (vecToX * i) / SCREEN W, 
Kin = (SCREEN W - 1 - i) * vecFromY / SCREEN W + (vecToY * i) / SCREEN W, 
ir 


dist - castRay(camX, camY, rayDx, rayDy, &dir); 
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wallHeight[i] - perspective(dist); 
watibirli] = dir; ^ 


for (int i = 0; i < 10; ++i) 
putchar ( "An's; 

drawScreen(); 

char c = getchar(); 


pue (c) // movement 


case camAngle += 30; break; 
case camAngle -- 30; break; 
case camX += forwX / 2; camY += forwY / 2; break; 
case camx forwX / 2; camY -- forwY / 2; break; 
case 'q': quit - 1; break; 
} default: break; 
J 
return 0; 


How to make this more advanced? Here are some hints and tips: 


- **textured walls**: This is pretty simply, the ray.hit basically gives uş a horizontal texturing coordinate, and we simply stretch the texture vertically to fit the wall. I.e. when the ray 
hits à wall, we take the hit coordinate along the principal axis of the wall (e.g. for vertical hit we take the Y coordinate) and [mod](mod.md) it by the fixed point unit which will give us the 
texturing coordinate. This coordinate tells us the column of the texture that the rendered column shall have; we read this texture column and render it stretched vertically to fit the column 
height given by the perspective, Note that for [cache](cache.md) friendliness (Loptimization](optimization md)) textures should be stored column-wide in memory as during rendering we'll be 
reading the texture by columns (row-wise stored textures would make us jump wide distances in the memory which CPU caches don't like). 
- **textured floor/ceiling**: Something aking [mode7](mode7.md) rendering can be used. 
- **sliding door**: TODO 
- rsjumping"*: Camera can.easily be shifted up.and down. If we are to place the camera e.g. one fixed point, unit above its original position, then for each column we render we, compute, with 

ivé a 


perspec pp Hed to this one fixed point unit (the same way with which we determine thé column size on the screen) the vertical screen-space offset of the wall and render this wall column 

that many pixe ower. 

- eatgoking up/down**: Correct view of a camera that's glightly tilted up/down can't be achieved. (at least not in a reasonably simple Nay) but there's a simple, trick for faking it -- camera 
hi ically, . if we're to look a bit up, we render that same way as usual but start higher up on the screen (in thé part of the 


shear ing. earing Berat just shifts the rendered view ver 
(anode aras normally above the screen and not visible), so that the vertical center of the screen will be shifted downwards. For smaller angles this looks [good enough] 

good enough.md). 
- **multilevel floor/ceiling**: This is,a bit.more difficult but it can be done e.g. like this: for each level square we store its floor and ceiling height. When casting a ray, we will consider 
any change in ceiling and/or floor height a hit, AND we'll need to return multiple of those hits (not just the first one). When we cast a ray and gét a Set of such hits, from each hit we'll know 
there are tiny walls on the floor and/or ceiling, and we'll know their distances. This can be used to correctly render everything. 
- **different level geometry**: In theory the level doesn't have to be a square grid but some kind of another representation, or we may keep it a square grid but allow placement of additional 
shapes in it such as cylinders etc. Here you simply have to figure out how to trace the rays so as to find the first thing it hits. 
- **adding [billboards](billboard.md) (sprites)**: TODO 

**reflections**: We can make our, 2D raycaster a, 2D [raytracer](ra traging md) i.e, when we cast a camera ray and it hits a reflective wall (a mirror), we cast another, secondary reflected ray 
and trace it to see which wall it hits, i.e. which watl will get reflected in the reflective wall. 
- r*partly transparent, walls**: We can make some walls partially transparent, both with [alpha blending](alpha.md) or textures with transparent pixels. In both cases we'll have to look not just 
for the first hit of the ray, but also for the next. 
l1 .raycastlib.md ---------- 
# Raycastlib 


TODO 


The repository is available at https://codeberg.org/drummyfish/raycastlib. 
---------- raylib.md ---------- 
## Raylib 


io.md) handting, [2D](2d.md) and [ eSa md) graphics; audio, ing of d erent image and formats etC., while restraining om a lot of [büllshit](butlShit.md) of [modern] (modern -i 
bloated](bloat.md) engines/[frameworks](framework.md) such as having tons of [dependencies](dependency.md) and targeting only very fast computing platforms. Raylib is pretty coo 
many of the PERSI: rs.md)/[suckless](suckless.md) ideas, even though from our strict point Of view it is still a bit more complex than it really needs to be, e.g. by using [fl 

e ying on [GPU](gpu.md) accelerated 3D graphics. In terms of [bloat](bloat.md) it can be seen as a mid way between the mainstream (e.g. [Godot](godot.md)) and 
less](suckless.md) (e.g. [small3dlib](small3dlib.md)). 


Raylib is a [free] free goftware md) relatively KISS] (kiss md], portable] (portability md) [eg Ceo md) (C99) [library] (library md) intended mainly. for [ ame] (game .mq development, offering [IO] 
b oa be 3 r ] dj" 
and employs 
oating point] 
sep and r 


LRS](lrs.md)/[suc 
The following are some features of raylib as of writing this. The good and neutral features seem to be: 


- written in [C99](c99.md) 

gene externer software [dependencies](dependency.md), all 3rd party libraries are packed with raylib (well, kind of, as specific platforms will require OpenGL implementation, windowing library 
etc. 

- no [COC](coc.md) detected , i , t F : y 7 R / 

- supports man systems including [Nu] (gnu md) /{Linux] (linux, md), [BSD] (bsd.md) [Magshit](maccmd) [Winshit](windows.md), [Android](android.md), web browser, claims to support even [embedded] 
(embedded.md) Ybu probably only the faster, not sure about [bare métalj(bare métal.md) due to Open6L etc.) 

- NOT a [framework](framework.md), very [bullshit] (bullshit.md) -free 

- permissive [zlib](zlib.md) [license](license.md : , f 7 , " 
- 2D and 3D support, [26] (10-md), audio, fonts, màth, includes most things you need for games (seems to lack only a hysics engine] (physics.engine-md)) 
- can load many file formats ({3pg] pg md , [png](png.md), [obj (obj mdj, m3d](m3d.md), [ttf](ttf.md), [wav] (wav.m 5 [flac](flac.md), [mp3](mp3.md), [ogg](ogg.md), ...) 
- bindings to 50+ languages (useless as all you need is [C] (6. md of course 

- nice documentation, many examples 


And some of the bad features are: 


150000+ [lines of code](loc.md) 

not a [header only](header only) library, requires building ([makefile](make.md), optionally with emake | (emake md) ) 

using [floating point | (float emd and [OpenGL](opengl.md) creates complex dependencies and sends a fuck you to small [embedded](embedded.md) computers 

even though abstracted, some software dependencies are Still needed depending on the platform, e.g. on GNU/Linux you need to install [ALSA](alsa.md), [Mesa](mesa.md) and [X11](x11.md) 
T reactionary_software.md ---------- 

# Reactionary Software 


f The "founder", fschmidt, sent me a link to his website on saidit after I posted about LRS. Here is how I interpret his take on technology -- as always I may misinterpret or distort something, 
or safety refer to the original website. -drummyfish } 


Reactionary software (reactionary meaning *opposing the [modern] (modern.md), favoring the old*) is a kind of [software] (software md )/[ technology] {tech.md) philosophy opposing [modern] (modern.md) 
technology and advocating [simplicity](kiss.md) as a basis of good technology (and possibly whole society); it is similar e.g. to [Suckless](suckless.md) and our own [less rétarded software 
lrs.md though it's not às "hardcore" [minimalist](minimalism.md) (e.g. it's okay with old versions of [Java](java.md) which we still consider kind of [Bloated | (bloated md) and therefore [bad] 
bad.md Just as suckless and LRS, reactionary software notices the unbelievably degenerated state of "[modern](modern.md)" technology (reflecting the degenerate state of whole society) 
manifested in bloat] (bloat md), overengineering, overcomplicating, user abuse, ugliness [DRM] (drm.md), bullshit] (bultshit md) features, planned obsolescence, fragility etc., and advocates for 
rejecting it, for taking a step back to when technology was still sane (before 20! 95): The website of reactionary Software is at http://www.reactionary.software (on top it reads *Make software 
great again!*). There is also a nice forum at http://www.mikraite.org/Reactionary-Software-f1999.html (tho requires JS to register? WTF). 


**The biggest difference. compared to suckless/LRS is, that reactionary software focuses on the simplicity from user's point of view** (as stated on their forums). This is not in conflict with our 
views, wé just additionally See the simplicity of internals as just às important. 


The founder of reactionary software is fschmidt and he still seems, to be the one who mostly defines it (just like drupmyfish](drummyfish md) is at the moment basically solo controlling [LRS] 
lrs.md)), though there is a forum of people who follow him. The philosophy can potentially be extended beyond just software, to other field$ of endeavor and potentially whole society -- the 
ascussion of ene software revolves around wide context, e.g. things like philosophy, religion and [collapse](collapse.md) of society (fschmidt made a post where he applies Old 

ideas to programming). 


Testament 


fschmidt seems to be a lot into religion and also has some related side projects with wider scope 


C e [Arkians](arkians.md) which deals with society and jeu nicer (eugenics md). It seems to be 
ests) who selective breed to renew good genes in society. {_**PLEASE DON'T JUMP T! SI 


trying to establish a community of "Chosen people" (those who pass certain t S . : CONCLUSIONS**, I just quickly : 
skimmed through it -- people will probably freak out and start calling that guy a [Nazi](nazi.md) -- please don't, read his site first. I can't really say more about it as I didn't research it 
well, but he doesn't seem to be proposing violent solutions. Peace. ~drummyfish } 

**What do [we] CLr8 md). think about reactionary software?** The vibes are good, it basically seems like, "lightweight suckless" -- we agree with what they identify as causes of decline of modern 
technology, we like that they discuss wide context and the big picture and our solutions are aligned, in the samé direction -- theirs are just not as radical, of maybe we just disagree on minor 


points. We may e.g. disagree on spreirae cases of software, for example they approve of old [Pyt on] (python mh). [java] Gava md) and lightweight [JavaScript](js.md) used on the [web](www.md) -- 
we see such software as unacceptable, it's too complex, unnecessary and from ground up designed badly. { As clarified on the forums, reactionary software focuses on the simplicity from user's 
perspective, not necessarily the simplicity of internals. -drummyfish } Nevertheless we definitely see it as good this philosophy exists, it contributes to improving techno ogy and it may 
provide an alternative to people who suffer from modern tech but suckless or LRS is too difficult for them to get into. The fact that more and more smaller communities with ideas similar to LRS 
come to life indicates the ideas themselves are alive and start to flourish, in a decentralized way -- this is good. 


Examples of reactionary software include (examples from the site itself): 


- **[bash (bashimd) tt Possibly the most popular [Unix] (unix. md) shell. In hardocore minimalist circles bash is still considered bloated and/or [harmful](harmful.dm) due to its extensions over 
standard osix](pósix.md) shell, but indeed compared to mainstream software bash is pretty KISS. 


z **old versions of languages such as [Java] (Java-md) and [Bython] (python ma **: TBH these are_seriously [bloated](blgat mdp -- the older versions maybe not THAT much.but still, Even if these 
y e 


e 
language may appear minimat to the programm (e.g. syntax or Concepts), they are necessarily extremely complicated on t inside (see [pseudominimalism](pseudominimalism.md)), even if just 
for their HUGE standard libraries. 


- **[Mercurial](mercurial.md)**: OK, here the guy just bashes and shits.on Igitl(git.md) for being extremely bloated and unusable -- of course, git, is a bit bloated, but definitely not more than 
Java or Python. Not sure Mercurial is really só much better. I have literálly néver touched Mercurial so don't know, I just know that Git is a bit complex but still usable (just commit, push 
and pull) AND it doesn't even matter that much as my project do not depend on git, git is basically just a way for me to put my code on the internet and sync in between my machines. If git stops 
existing I can literally just use FTP or something. -drummyfish } 

- **[Luan](luan.md)**: Their own programming language. TODO: research it :) 


## See Also 


- [suckless](suckless.md) 
KISS](kiss.md) 

T READMÉ.md ---------- 
# Less Retarded Wiki 


This is online at https://www.tastyfish.cz/lrs/main.html. 
Wiki about less retarded software and related topics. 


By contributing you agree to release your contribution under CCO 1.0, public domain (https://creativecommons.org/publicdomain/zero/1.0/). Please do **not** add anything copyrighted to this Wiki 
(Such as copy paSted texts from elsewhere, images etc.). 


Start reading at the [main page](main.md). 


T recursion.md ---------- 
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# Recursion 


*See [recursion](recursion.md) .* 

Recursion (from Latin recursio, "running back”) in general_is a situation in which a [definition](definition.md) refers to itself; for example the definition of a human's ancestor as "the 
human's parents and the ancestors of hi$ parents" ({fractals] (fractat.md) are also very nice example of what a Simple recursive definition can achieve). In programming recursion takes on a 
meaning of a **function that calls itself**; this is the meaning we'll suppose in this article, unless noted otherwise. 


We divide recursion to a **direct** and **indirect** one. In direct recursion, the function calls itself directly, in indirect function *A*.calls a function *B* which ends up (even possibly by 
calling some more functions) calling *A* again. Indirect recursion is tricky because it may appear by mistake and cause a [bug](bug.md) (which is nevertheless easily noticed as the program will 
mostly run out of memory and crash). 


When.a.function calls itself, it starts "diving" deeper and deeper and in most situations we want this to stop at some point, so in most cases.**a recursion has to contain a terminatin 
condition**. Without this condition the recursion will keep recurring and end up in an equivalent of an infinite loop (which in case of recursion will however crash the program with a fstack 
overflow](stack overflow.md) exception). Let's see this on perhaps the most typical example of using recursion, a [factorial](factorial.md) function: 


unsigned int factorial(unsigned int x) 


if (x > 1) 
itetunn x * factorial(x - 1); // recursive call 
else 


return 1; // terminating condition 


See that as long as x.» 1, recursive calls are being made; with, each, the x is, decremented so that inevitably x will at one point come to equal 1., Then the *else* branch of the condition will be 
taken -- the terminating Condition has been met -- and in this branch no further recursive call is made, i.e. the recursion is stopped here and the code starts to descend from the recursion. 


Note that even in.computing we can use an infinite recursion sometimes. For example in [Hashell] (haskell .md) it is possible to define infinite [data structures] (data structure .md) with a 
recursive definition; however this kind of recursion is intentionally allowed, it is tréated as à mathematical definition and with correct use it won't crash thé program. 


rabue ty, recursion can be replaced by iteration and vice versa** (iteration meaning 8, loop such as ^"while'). In fact some language (e.g. piygetional (functional,md)) do not have loops and handle 
repetition solely by recursion. This means that you, a programmer, always have a Choice between recursion and iteration, and here you should know that **recursion'is typically slower than 
iteration**. This is because recursion has a lot of overhead: remember that every level of recursion is a function call that involves things such as pushing and popping values on stack, handling 
return addresses etc. The usual advice is therefore to **prefer iteration**, even though recursion can sometimes be more elegant/simple and if you don't mind the overhead, it's not necessarily 
wrong to go for it. Typically this is the case when you have multiple branches to dive into, e.g. in case of [quicksort](quicksort.md). In the above example of factorial we only have one 
recurring branch, so it's much better to implement the function with iteration: 


(signed int factorial(unsigned int x) 
unsigned int result - 1; 
while (x » 1) 


result *- x; 
xi 


) 


return result; 


How do the computers.practically, make recursion happen? Basically they, wse a2 [stesk 
c stack](call_s 


: e C m Rtagk mdp ; to, remember States on each level of the recursion, In programming languages that support recursive 
function calls this is hidden béhind the scenes in the form of [Call k.md). Thi 


md). S is why an infinite recursion causes stack overflow. 


Another important type of recursion is **tail, recursion** which happens when the recursive, call in a function is the very last command. It is utilized in functional languages that use recursion 
instead of loops. This kind of recursion can be optimized by the compiler into basically the same code a loop would prodüce, so that e.g. stack won't grow tremendously. 

T reddit.md ---------- 

# Reddit 


TODO 
Typical reddit thread after [SJW](sjw.md) takeover looks like this: 


- [removed] +7000000 
- [removed] +20000 
- haha so hilarious, best thing I've ever read 
- [removed] - 1000000 
- [removed] +300000 
- this changed my life 
- [removed] +123 
T1 right.md ---------- 


See [left vs right](left right.md). 
T1 rms.md ---------- 
# Richard Stallman 


{ RMS is a legend and overall a great human, but let's be reminded we shouldn't be creating any [heroes](hero_culture.md) or celebrities. ~drummyfish } 


The great doctor Richard Matthew Stallman (RMS, also [GNU](gnu.md)/Stallman and saint IGNUcius, born 1953 in New York) is one of the biggest figures in software history] (history md), inventor 
of [free software] (free software md), founder of the [GNU project (gnu md), [Free Software Foundation] (fst mao, a_great [hacker](hacking.md) and the author of a famous text editor [Emacs : 
(emács.md). He is à non-religious [ ew] (jew md) and an [atheist](atheism.md) (though he is the highest saint of [Church Of Emacs|(church of emacs.md)), a man who firmly stands behind his beliefs 
and who's been advocating for ethics and user freedom in the computing world. He has also been called the *king of software [cloning](clone.md)*, for he started the wave of making free, ethical 
clones of proprietary programs. 


*[ASCII art](ascii art.md) of Richard Stallman* 


Stallman's life along with free software's 


history is documented by a free-licensed book named, *Free as, in Freedom: Richard Stallman's Crusade for Free Software* on which he collaborated. You 
can get it gratis e.g. at [Project Gutenberg](https://www.gutenberg.org/ebooks/5768 


). You should read this! 


[tl;dr](tldr.md): At 27 as an employee at [MIT](mit.md) AI labs Stallman had a bad experience when trying to fix a Xerox printer who's [prgerietary](proprietary.md) software source code was made 
inaccessible; hé also started spotting the betrayal of hacker principles by others who decided to write proprietary software -- he realized proprietary software was inherently wrong as it 
prevented studying, improvement and s aring of software and enable abuse of users. From 1982 he was involved in a "fight" against the Symbolics company that pushed aggressive proprietary 
software; he was rewriting their software from scratch to allow Lisp Machine users more freedom -- here he proved his superior programming skills as he was keeping up with the whole team of 
Symbolics programmers. By 1983 his frustration reached its peak and he announced his [GNU](gnu.md) project on the [Usenet](usenet.md) -- this was a project to create a completely [free as in 
freedom] (free. software. md) [operating System) (os cmd), an alternative to the proprietary [Unix Luna xema) system that would offer its users freedom to use, study, modify and share the whole. 
software, in the hacker spirit. He followed Y ublishing a manifesto and establishing the [Free Software Foundation](fsf.md). GNU and FSF popularized and standardized the term [free (as in 
freedom) software](free software.md), [copyle t](copy tert md) and free licensing, mainly with the [GPL](gpl.md) license. In the 90s GNU adopted the [Linux](linux.md) operating system kernel and 
released a complete version of the GNU operating system -- these are nowadays known mostly as "Linux" istros](distro.md). As a head of FSF and GNU Stallman more or less stopped programming and 
started traveling around the world to give talks about free software and has earned his status of one of the most important people in software history. 


Regarding [software] (software. mq) Stallman has for his whole life strongly.and tirelessly promoted free software and [copyleft] (copyleft.md) and has himself only used free software; he has 
always practiced wh he preched'and led the best example of how to livé without [pro raetary (proprietary: md» software. This 1$ amazing. evertheless he isn't too concerned about [bloat] 
(bloat .md) (Judging by the GNU software and his own creation, [Emacs](emacs.md)) and he also doesn't care that much about [free culture] (free culture md) (some of his written works prohibit 
modification and his GNU project allows proprietary non-functional data). Sadly he has also shown signs of being a [type A fail](fail_ab.md) personality by writing about some kind of [newspeak] 
(newspeak.md) "*gender neutral language*" and by seeming to be caught in a [fight culture] (fight culture. md). On his_ website he also has an [American](usa.md) flag and claims to be a patriot, 
i.e. leaning to nationalism and therefore [fascism](fascism.md). Nevertheless he definitely can't be accused of populism or hypoeris as he basically tells what he considers to be the truth no 
eee eai d Pen TR very. consistent in this. Some of his unpopular opinions brought him a lot of trouble, e.g. the wrath o PSaws} (5jw.md) in 2019 for his criticism of the [pedo] 
pedophile.md) witch hunt. 


He is a weird, guy, having been recorded on video eating dirt from his feet before giving a lecture. In the book *Free as in Freedom* he admits he, might be slightly putistic] (autism md), 
Nevertheless hé's pretty smart, has magna cum laude degree in [physics] (physics: ma from Harvard, 10+ honorary doctorates, fluently speaks English, Spanish and French and a litt bit of 
Indonesian and has many times proven his superior programming skills (even though he later stopped programming to fully work on promoting the FSF). 


Stallman has a beautifully minimalist website http://www,stallman.org where he actively comments on current news and issues. He also made the famous free software song (well, only the lyrics, 
the melody is taken from à Bulgarian folk song Sadi Moma). 


In 2019 Stallman was [cancelled] (cancel_eulture.md) by [Saw] (sjw.md) fascists for merely commenting rationally on the topic of child sexuality following the Epstein scandal. He resigned from the 
position of president of the FSF but continues to Support it. 


Stallman has been critical of [ca ta lism] (capitalism. md) though he probably isn't a_hardcore.anticapitalist (he's an [American ](usa.md) after all). [Wikidata](wikidate.md) states he's a 
proponent of [alter-globalization](alter globalization.md) (not completely against globalization in certain areas but not supporting thé current form of it). 


In the book *Free_As_In Freedom* it is also mentioned that Stallman had aversion to passwords and secrecy in general -- at MIT he used the username RMS with the same password so that other 
people could easily log in through his account and access [ARPANET](arpanet.md) (the predecessor of fintérnet](internet.md)). Indeed, we applaud this. 


AS [aparchists)(anarehism md) we of course despise the idea of wor shiping people, creating [heroes] (hero_culture md) and cults of personalities, but the enormous [historical] (history .md) 
significance of Stallman has’ to be stressed as a plain and simple fact. Ev hough in our days hiš name is overshadowed in the mainstream by rich businessman and creators of commercially 
successful techno logy and even though we ourselves disagree with Stallman on some points, in the future history may well see Stallman as per aps the greatest man of the software era, and 
rightfully so. Stallman isn't a mere creator of a commercially successful software product, he is literally as important as the great philosophers of ancient Greece -- he brilliantly foresaw the 
course of history and quickly defined ethics needed for the new era of mass available programmable computers, and not only that; he also basically alone established this ethics as a standard IN 
SPITE of all the world's corporations fighting back. He is also extremely unique in not pursuing self interest, in TRULY living his own philosophy, dedicating his whole life to his cause and 
refusing to give in even partially” All of this is at much higher level than simply becoming successful and famous within the contemporary capitalist system, his life effort is pure, true and 
timeless, unlike things achieved by pieces of shit such as [Steve Jobs](steve_jobs.md). 

T rock.md ---------- 


Rocks and.stones are natural formations of minerals that can be used to create the most primitive [technology](technology.md). Stone age was the first stage of our civilization; it was 


characterized by use of stone tools. Rock [nerds](nerd.md) are called geologists. 

Rocks are pretty [suckless](suckless.md) and [LRS](lrs.md) because they are simple, they are everywhere, free and can be used in a number of ways such as: 
- As a building material. 

- For [fun](fun.md) and cate rte ment: you can play various games with rocks: rock skipping, petanque, even [chess](chess.md). 


- As [weapons](weapon.md), even thoug we discourage this use. 
- For making tools such às [knives](knife.md) or [hammers](hammer.md). 
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To hold heat: you can e.g. heat stones in fire and let them heat you while you sleep or use them to cook something. z A ^ 
For writing, some can be used as a chalk, some may be used to carve text into. A dust from some rocks can be used to make dye to paint or write with. 
As weights. 
For help with counting (ed: [abacus](abacus.md)) -- this makes rocks a kind of [computer](computer.md)! 
To make fart}(art md), decorations, small statues etc. 
For breaking things, grinding, sharpening etc. 
With advanced technology we can get metals out of rocks, extract geological knowledge from them etc. 
Some rocks can be used to start [fire](fire.md). 
used aea [currency] (currency. md); even though we hate money and discourage this as well. 
are a thing : 


TODO 


:= large random prime* 
large,random prime* 


(p - 1) * (q - 1)* (this step may differ in other versions) 
65537* (most common, other constants exist) 

*d :z solve for x: x * e = 1 mod f* 
*public key :- (n,e)* 

*private key :- d* 


0-10 Ui A (NH 


message encryption: 


1. *m :- message encoded as a number « n* 
2. *encrypted :- m^e mod n* 


message decryption: 


1. *m :- encrypted^d mod n* 

2. *decrypted :- decode message from number m* 
l1 rule110.md ---------- 

# Rule 110 


*Not to be confused with [rule 34](rule43.md) xD* 


ule 110 is a.specific [cettutan automaton](cellular-automaton qd) (similar to 8-8. Game of Life] (game of lite mdp) which shows.a very interesting behavior -- it is one of the simplest [Turing 
complete](turing completeness.md) (computa dona lly most powerful) systems with a balance of stabl nd [Tchaotic](chaos.md) behavior. In other words it is a system in which a very complex and 
interesting properties emerge from extremely simple rules. The name *rule 110* comes from [truth table](truth_table.md) that defines the automaton's behavior. 


Rule 110 is_one of 256 so called elementary [cellular automata](cellular_automaton.md) which are special kinds of cellular automata that are one dimensional (unlike the mentioned [Game Of Life] 
(game_of_life.md) which is two dimensional), .in which cells havé 1 bit state (1 or 0) and each cell's next state is determined by its current state and the state of its two immediate neighboring 
Cells (left and right). Most of the 256 possible elementary cellular automata are "boring" but rule 110 is special and interesting. Probably the most interesting thing is that rule 110 is 
Turing complete](turing completeness.md), i.e. it can in theory compute anything any other computer can, while basically having just 8 rules. 110 (along with its equivalents) is the only 
elementary automaton for which Turing completeness has been [proven](proof.md). 


For rule 110 the following is a table determining the next value of a cell given its current value (center) and the values of its left and right neighbor. 


left|center|right|center next 


[:] io} Q Q 

[:] [o] T 1 

[:] 1 [:] 1 

[:] 1 1 Q 

A, [o] Q el: 

1 0 1 1 

T $ [o] 1 

1 1 1 Q 
The rightmost column is where elementary cellular automata_differ from each other -- here reading the column from top to bottom we get the [binary] (binary md number 01101110 which is 110 in . 
gecimal] (decimal md), hence we call the automaton rule 110. Some automata behave as "flipped" versions of rule 110, e.g. rule 137 (bit inversion of rule 110) and rule 124 (horizontal reflection 
of rule 0) -- thesé are in terms of properties equivalent to rule 110. 


phe, job towing is an output of 32 steps of rule 110 from an initial tape with one cell set to 1. Horizontal dimension represents the tape, vertical dimension represents steps/time (from top to 
ottom). 


HHH # HH 


HH HHHH du 
HHH H HHHH HHH 

HouHHHH HH H HH 

HHE HE HEHHEHE 

H AH HHHH n 

HHRHH o dd HH 

HO HHHE HHH Hon 

HHO Ho HH HEO BMH 

dH HH OH OHHHHE HU d 
HOHHHHHHHE HH HE HHH 

HHH He HHRHH # HH 

"on HHH HO HHHH 

HHRHH  # HHHH # n 

# HH BHH duo HHO HH 

HH HHH H HH HHH HHH oH HHH 
HHH H HE BHHHHH HHH HH HHRHH 
HOMPHHHHHHE HHH Hang Hoo da 
HHH HAO HOHHH HEHE HHH 
# HH HHH HOE HH Ho HH OH HH 


The output was generated by the following [C](c.md) code. 


#include <stdio.h> 


#define RULE 110 // 01100111 in binary 
#define TAPE_SIZE 64 
#define STEPS 32 


unsigned char tape[TAPE_SIZE]; 
int main(void) 
// init the tape: 
for (int i - 0; i « TAPE SIZE; ++i) 
tape[i] = i == 0; 


// simulate: 
for (int i = 0; i < STEPS; ++i) 


for (int j = 0; j < TAPE SIZE; ++j) 
putchar(tapel jl P pros ry. 


putchar('\n'); 


unsigned char state = // three cell state 
(tape 1] << 2 
tape[0] << 1 
tape[TAPE SIZE - 1]; 


for (int j = 0; j < TAPE SIZE; ++j) 


tape[j] = (RULE >> state) & 0x01; 
state - (tape[(j * 2) * APE SIZÉ] << 2) | (state >> 1); 


J 
J 


return 0; 


Discovery of rule 110 is attributed to [Stephen wolfram](wolfram.md) who introduced elementary cellular automata in 1983 and conjectured Turing completeness of rule 110 in 1986 which was proven 
by Matthéw Cook in 2004. 


## See Also 
- [Game Of Life](game_of_life.md) 
- [Langton's Ant (tangtons_ant:ma) 
T9 rust.md ---------- 


Rust is an extremely poor attempt at a politically motivated [capitalist ](capitalism.md) programmin Janguage] (programming langua e md) and one of the prime examples of badly designed software 
in general. It is extremely [harmful] (harmfut-md) not just because of its awful design and implementation an Ótivàtion, it also Bromo es [toxae |(toxae md) politics, tries to replace relatively 
n 


good languages such as [C](c.md) and, worst of a is gaining popularity among highly unqualified coding monkeys, i.e. the majority of people creating technology nowadays, so it is infecting 
everything and contributing to the downfall of technology. FOR THE LOVE OF GOD STAY AS FAR AWAY AS POSSIBLE FROM RUST. 
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[LMAO](lmao.md) https://github.com/mTvare6/hello-world.rs 
It should be made clear that **rust is [shit](shit.md)** AND **CANNOT BE FIXED**, it is awful from the ground up and the only way to deal with it is to delete it. To mention just a few issues: 


- **Rust is [bloated {btoat md) as hell**, it violates the most important philosophy in pro ramming : the [Unix philosophy] (unix philosophy, md), and tries to_do everything at once (i.e. follow 

the [Windows philosophy](windows philosophy.md)). As such it sports **TONS of [dependencies (depen ency.md) even for trivial programa is he repo has FKN OVER 200 MB OF SOURCE CODE??? It 

probably doesn't have to be said it includes such unnecessary trash as [generics] (generics .m ), twisted [object obsession](oop.md) ("[traits](trait.md)"), ackage manager] 

(package management md). „forced [memor Safety) (memory_safety md) and whatnot. It itself depends on extreme bloat like [Python](python.md), [ninja](ninja.m » [cmake](cmake.md) etc. Apparently 

compiling rust even requires [In ernet) (internet. md) Connection to download some bootstrap shit? 

- **It's just complete shit written**, everyone complains it compiles slow as hell (both rust programs and rust itself), it creates **HUGE binaries** because it statically links all the 

dependencies and runtime environment [LAO] mao- md). 

- **Rust is [capitalist software] (capitalist software,md)** sponsored by corporations like Mozilla] (mozitla.md) and [Migrosoft] (microsoft md), trying to perpetuate. the philosophy of en godern] 

(modern.md)" anti-people technology rather than steering it in [better direction](lrs.md). The Rust brand is [trademarked](tradémark.md) and "protectéd" by corporations owning it. Remember, a 

corporation NEVER sponsors anything without trying to buy some control over that thing. 

- **It has Lisensing/ [freedom] {free software md) issues**, specifically making it difficult to exercise freedom 3 {legally modify software), see "m N 

https://web.archive.org/web/2 oyeralagecos Deeps ://w ila Nyperbo tas info doku. p?id-en:main:rusts freedom flaws. **Its "[open Source] (open. Source md) label is just [openwashing] 

(openwashing.md)**, it is "open source" in the same way [. Rdroid](android.md) is open source (it has a "FOSS" license but it is de facto centrally Controlled by some fascist group). 

( pde usb has no Spei pleation ay it tries to discourage other implementations and as such greatly hurts basic principles of freedom. Lack of fixed specifications also creates [update culture] 
update culture.md) etc. 

- Due to the above, Rust is not really a language, it is more.of a "platform" or "software framework" for programs -- Rust is a programming language in the same sense in which Google App Store 

is a package manager. If it becomes the mainStréam language, it will do to computer programs what e.g. [Steam](steam.md) has done tö video [gamés](game.md). 

- **Rust is [fascist] faseigm md) [Eranny software] (tranny software.md) 


** -- not because it is written by trannsexuals, but because it Sports political discrimination through [codes of conduct] 
(cae sme) and creating a de-facto monopoly on the language (with [bloat monopoly](bloat_monopoly.md), lack of specification, kicking peop 
etc.). 


e out of development based on their potitical views 


- Its selling point is supposed to.be memory safety but that makes the language **extremely slow**. For fast programs safety has to be turned off but then you can just write in [C](c.md), so 

there is no point to Rust -- definitely not as a réplacement for C. 

- It ridiculously tries to be a 3t changho Lding system language"**, i.e. an expert level language designed for beginners or incompetent people (of course with the obvious goal to empower women 

forced into tech etc.). Being written by pre-Besinner level [goers] coding md), it sets goals such as "system language should tie your hands and prevent beginner mistakes". It's like trying 

to design afi hter jet around the idea that it will be operated by beginners and therefore e.g. removing fire buttons or limiting top speed so as to limit dangers posed by sitting an amateur 

pilot in a fighter jet. 

- It is more than anything a s potitical language trying to push Propaganda’, send messages about minorities in tech instead of greating good technology, and AL fight] (fight. culture md)" and 
ys es 


destroy languages invente raight white men -- the most popular activity of rust soydevs seems to be rewriting already existing, well established, ted and greatly optimized programs from 
serate in rust. As such language it is mostly written by angry minorities such as [girls](girl.md) and trannies who can't much into technology, hence the completely shit design and 
implementation. 


i cnius Sries to displace good languages** such as [C](c.md) and sadly, thanks to its populism and political appeal, is becoming popular among masses of coding monkeys who have no idea about 
echnology. 

PEt if complete ly unnecessary** in the first place, a good low level language already exists: &] (g, nd). Tr anything, we need to improve C by making it [simpler] (minimalism.md), but 
overcomplicated C also already exists for those who for some reason want to usé a shit language: [C Append), and thére are of course also slow and Safe tanguage well suited fof beginners, 
such as [Python](python.md). Rust is just flushing thousands of manhours (prolly rather soiboihours) down the toilet. 

- TODO: MORE, but you get the idea 


rams); it can ar? be seen as a [fantasy 


SAF is a [LRS](lrs.md). [C] (c.md librar library.md mall, ver ortable](portability.md james ] (game . md and possibly other kinds pf pro al 
d à df M5: dl [ zl n ) fa]? ips is 1) 693 esta às f 4 p pr ThecrotD] (utd. m is an example of a LRS game 


for si 
console] antàsy consólé. was made by [drumm fish](drummyfis . The repository is àvai at https://codeberg.org/drummyfish/SAl 
made with SAF, but even more complex games Such as lanarch] (ana? ch. md) ave been ported to it. 


The whole SAF library is implemented, in a, [single header] (single header md) file and offers a Simpte, [APT] (api.md) for programming games, i,e. functions for drawing pixels to the_screen, playing 
sounds, reading buttons, computing the [sine](Sin.md) function etc., and it handles bor ing/annoying issues such a$ the gamë main loóp. It aiso has built-in a number of [frontends](frontend.md) 
that allow compiling a correctly made SAF games to any supported platform among which are [SDL](sdl.md) [SPML] (SfmL- ma], [X11] (xii.md), [peur ses] (ncurses md) (terminal 

(open console.md) süch as fPokitto] (pokitto.md), [Arduboy](arduboy.md) or [Gamebuino META](gamebuino.md). There is an option to auto-convert a color game to bl 
PC frontends add emulator-like features such as time manipulation, [pixelart upscaling](pixelart upscale.md), [TAS](tas.md) support and so on. 


, even [open consoles] 


ack-and-white only displays. Some 


Games made with, SAF run in 64x64 resolution, with 256 colors ([332 palette] (332.md)) and 25, [EPS] (fps-md) They can use 7 input buttons (arrows, A, B_and e play,4 different sound effects and 
use 32 [bytes](byte.md) of persistent memory, e.g. for savegamés or highscores. Thé$e relatively low specifications are set on purpose so as to help [portability portability.md), reduce [bloat] 
(bloat df, frustration and D rie ctor] (rraction-md). Many times good, entertaining games can be very simple, as is the case e.g. with [Tetris](tetris.md), [chess](chess.md), various [shmups] 


shmup.md), [roguelikes](roguelike.md) and so on -- these are the kinds of games is ideal for. 
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7 ([uTD](utd.md)) running in terminal with [ncurses](ncurses.md)* 
-- sanism.md -- 


Sanism is an absolutely crazy idea made up by the most insane [53ws]1(S]w.md) that says that words like "crazy" and "insane" are "offensive" or even "discriminatory? against mentally ill people 
and that we should censor such words so as to stay [politically corréct](political_correctness.md). Yes, thiS is pretty fucked up, but give it a year or two and it's gonna become mainstream. 


[LMAO] (lmao. md) imagine future news be like "Mentally divergent age.fluid human, people person of unspecified non-hexadecimal gender and, afro american, ethno-social-construct was arrested after an 
incidént involving guns and liquor stores. No harm wás intended düring saying this Sentence and we apologize in advance for any mental harm that may have been caused to mentally sensitive people 
persons by hearing this sentence." 

T science.md ---------- 

# Science 


*Not to be confused with [soyence](soyence.md)*. 


Science (from Latin *scientia*, knowledge or understanding) in a wide, sense means systematic, gathering, inference and organization of knowledge, in a more strict.sense this process has to be 
kept rational by obeying some specific Strict rules and adhering to whatever principles of ob ectivity are currently accépted, nowadays for example the [scientific method](scientific_method.md) 
or mathematical [prost] (proof md) « Sciences in the strict sense include [mathematics (math, md) (so called formal Science), [physics] (physics md), biology, chemistry, [computer science] 
(computer_science.md), as well as "soft sciences" such as [psychology](psychology.md), sociology etc. Science is not to be confused with [pseudoscience](pseudoscience.md) (such as [gender 
studies](gender_studies.md) or [astrology](astrology.md)) and [soyence](soyence.md) (political propaganda masked as "science"). 


TODO: some noice tree of sciences or smth 


**There_ is no simple objective definition of a strict science** -- the definition of science changes with development of society, technology, culture, politics and so on. Science should,. 
basically stand for the’ most rational and objective knowledge we're able to practically obtain, however the specific criteria for this are Unclear and have to be agreed on. The [scientific 
method] (Scientific method md) i$ evolving and there are many debates over it, with some even stating that there can be no universal method of science. The [p-value (p-value md) used to determine 
whether measurements are statistically significant has basically just an arbitrarily set value for what's considered a "safe enough" result. Some say that if a research is to be trusted, it has 
to be [peer reviewed](peer review.md), i.e. that what's scientific has to be approved by chosen experts -- this may be not just because people can make mistakes but also because in current 
highly competitive society there appears science [bloat] (b Loat md), obscurity and tendencies to push fake research and purposeful deception, i.e. our politics and culture are already defining 
what Science is. However the stricter the criteria for science, the more monopolized, centralized, controlled and censored it becomes. 


**what should we then accept as, legit scisnce?””. {we} (irs.md), in the context of our [ideal society](less_retarded_society.md), argue for NOT creating a strict definition of science, just as we 
are for example against S Lora tizing morality" with laws etc. What is and is not science is to be judged on a case-by-case baSis, Science cannot be a mass produced stream of papers that can 
automatically be marked as OK or NOT OK. We might define the term **[less retarded science (less retarded science md ** so as to distinguish today's many times twisted and corrupted 
"science/[so ence] (59 ence.md)" from the real, good and truly useful science. Less retarded science should follow similar principles as [our technology](lrs.md), it should be completely free as 
in freedom, [selfless](selflessness.md), [sucktess] (suckless.md) as much as possible, unobscured etc. 


Do NOT confuse or equate science with [academia](academia.md). As with everything, under capitalism academia has become rotten to the core, research is motivated by profit and what's produced is 
mostly utter bullshit shat out by wannabe PhDs who need to mass produce "something" as a part of the crazy academia publish-or-perish game. As with everything in capitalism, the closer you look, 
the more corruption you find. 

T1 sdf.md ---------- 

# Signed Distance Function 


Signed distance function (SDF, also.signed distance field) isa function] (function md) that for any point in. space returns.its distance to the closest point.of some geometric shape, and also 
the information whether that point is Outside or inside that shape (it inside, the distance is negative, outside it's positive and exactly on the surface it is zero -- hence *signed* distance 
function). SDFs find use in elegantly representing some surfaces and solving some problems, most notably in computer [graphics](graphics.md), e.g. for smoothly rendering upscaled [fonts] 
(font.md), in (raymarehing] (raymarching md), implementing [global illumination (gimp as a 3D model storage representation, for [collision detection] (collision detection md) etc. SDFs can | 
exist anywhere where [distances](distance.md) exist, i.e. in 2D, 3D, even non-[Euclidean](euclidean.md) spaces etc. (and also note the distance doesn't always have to be Euclidean distance, it 
can be anything satisfying the [axioms](axiom.md) of a distance metric, e.g. [taxicab distance](taxicab.md)). 
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Sometimes SDF is extended to.also return additional information, e.g. the whole [vector](vector.md) to the closest surface point (i.e. not only the distance but also a direction towards it) 
which may be useful for specific algorithms. 


**what is it all, good for?** We can for example implement quite fast fraytracing](raytracing.md)- like rendering of environments, for which we have a fast SDF. While traditional raytracing hasto 
somehow test each ray for potential intersection against all 3D elements in the Scene, which can be slow (and Complicated), with SDF we can performs so called [raymarching](raymatching.md), N 
iteratively stepping along the ray according to the distance function (which hints us on how big of a step we can make so that we can potentially quickly jump over big empty areas) until we get 
close enough to a surface which we interpret as an intersection -- if the SDF is fast, this approach may be pretty efficient (fSodot] (godot md implemented this algorithm to render real-time 
global illumination and reflections even in GPUs that don't support accelerated raytracing). Programs for rendering 3D [fractals](fractal.md) (such as Mandelbulber) work on this principle as 
well. SDFs can also be used as a format for representing shapes such as [fonts](font.md) -- there exists a method called multi-channel SDF) that stores font glyphs in bitmaps of quite low- 
resolution that can be rendered at arbitrary scale in a quality almost matching that of the traditional vector font representation -- the advantage over the traditional vector format is 
obviously greater simplicity and better compatibility with GPU hardware that's optimized for storing and handling bitmaps. Furthermore we can trivially increase or decrease weight (boldness) of 
a font represented by SDFs simply by adjusting the rendering distance threshold. SDFs can also be used for [collision detection](collision detection.md) and many other things. One advantage of 
using SDFs is their **generality** -- if we have an SDF raymarching algorithm, we can plug in any shape and environment just by constructing its SDF, while with traditional raytracing we 
normally have to write many specialized algorithms for detecting intersections of rays with different kinds of shapes, i.e. we have many special cases to handle. 


**How is an SDF implemented?** Well, it's a [function] (function;md), it can be implemented however we wish and need, it depends on each case, but we probably want it to be **fast** because 
algorithms that work with SDFs commonly call it often. SDF of simple mathematical shapes (and their possible combinations such as unions, see. bare [ $5] (csg md) ), e.g. spheres, can be 
implemented very easily (SDF of a sphere = distance to the sphere center minus its radius); even the already mentioned 3D [fractals](fractal.md) have functions at can be used to quickly 
estimate the distance towards their surface. Other times -- e.g. where arbitrary shapes may appear -- the function may be [precomputed](precomputing.md) into some kind of N dimensional [array] 
(array.md), we might say we use a precomputed [look up fable] (EUT: md). This can be done in a number of ways, but as a simple example we can imagine raymarching mirror reflections with which we 
can subdivide the 3D scene into a grad and into each cell we store the SDF value at its center point (which here may be computed by even a relatively Slow algorithm), which will allow for. 
relatively fast pi of intersections of rays with the surface (at any point along the ray we may check the SDF value of the current cell which will likely provide information for how big a 
step we can make next). 
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*Shape (left) and its SDF (right, distances rounded to integers).* 


SDEs in computer graphics were being_explored a long time ago but seem to have_start to become popular since around the year 2000 when Frisken fet al](et_al.md) used.adaptive SDFs as an 
efficient representation for 3D modéls preserving fine details. In 2007 [Valve](valve.md) published a paper at [SIGGRA HÝ (Siggraph md) showing the bitmap representation of SDF shapes that they 
integrated into their [Source](source_engine.md) engine. 

T security.md ---------- 


& Security 
*"As passwords first appeared at the MIT AI Lab I decided to follow my belief that there should be no passwords... I don't believe it's desirable to have security on a computer."* -- [Richard 
Stallman](rms.md) (from the book *Free As In Freedom*) 


Computer security (also cybersecurity) is the study of designing computer systems so as to make them hard to "attack" (which usually means accessing "sensitive" information, manipulating it or 

destabilizing the system itsetf]s At the dawn of computer era security wasn't such a big deal as society didn't depend on computers so much and damage one could cause by exploiting them was 

limited, however once consumer echno logy became forced by [capitalism](capitalism.md) and put into EVERYTHING -- companies, governments, streets, homes, clothes, even human bodies and things 

that can work better without such technology (see e.g. [Internet of stins (1ot.md}) -- privacy became another bullshit issue of society as cracking now theoretically allows not only killing 
o 


individuals but wiping whole countries off the map. Recently security has become a t concerned with ensuring digital "[privacy](privacy.md)". 


**If you want security, the most basic thing to do is to disconnect from the [Internet](internet.md).** 


**Security is in its essence an unnecessary [buttspit](bullshit.md)**. It shouldn't exist, the need for more security comes from the fact we live in a [shitty dystopial(capitalism.md) . In a. 
good society](less retarded society.md) there would be no need for security and people could spend their time by solving real problems. We, [LRS](lrs.md), advocate NOT for increasing security 
which leads to things like police states, [censorship](censorship.md), [bloat](bloat.md) etc.), but for decreasing the need for it, i.e. steering society towards a better direction. 
T see through clothes.md ---------- 


# See Through Clothes 


TODO: tech for seeing through clothes 
---------- selflessness.md ---------- 
# Selflessness 


Selflessness means agting with the intent of helping others without harming them, gaining edge over them or taking advantage of them in any way. It is the opposite of [self interest] : 
self interest.md). Selflessness is the basis of an [ideal society](less r tárded Soclety.mdj and [good techno Logg] (irs may (while sadly self interest is the basis of our current dystopian 
capitalist](capitalism.md) society). 


Selflessness.is about the **intent** behind behavior rather than about the result of the behavior; for example being a [vegetarian ](vegetarian.nd) (or, even [ve anj(vegan.md)) for ethical. reasons 
(to spare animals of suffering) is selfless while being a vegetarian only because of one's health concerns is not sélfléss. Similar if a selfless behavior Unpre ictábly results in harming 
someone, it is still a selfless behavior as long as the intent behind it was pure. (Note that this does **NOT** at all advocate the "[ends justify the means](ends_justify_the_means.md)" 
philosophy which acts with an intent to hurt someone.) 


In the real world absolutely ure selflessness may be very |hard to find, partly because such behavior by definition seeks no recognition. Acts of sacrificing one's life for another may a lot of 
times be seen as selfless ut not always (saving one's child in such way may just serve perpetuating own genes, it can also be done to posthumously increase one's fame etc.). An example of high 
selflessness may perhaps be so called [ angar | (langar md), a big community kitchen run by [Sikhs](sikhism.md) that prepare and serve free [vegetarian (vegetarian.md) food to anyone who comes 
without differentiating between religious beliefs, skin Color, social status, gender etc. Sikhs sometimes also similarly offer a place to stay etc. The mentioned ethical vegetarianism and 
veganism is another example of selflessness, as well as [LRS](lrs.md) itself, of course. 


**Selflessness doesn't mean one seeks no reward**, there is practically always at least one reward for a selfless tr behaving individual: the good feeling that comes from the selfless action. 
Selfless acting may also include physical rewards, for example if a programmer dedicates years of his life to developing a Prree|(tree_software md) [public domain](public domain.md) software . 
that will help all people, he himself will get the benefits of using thàt program. The key thing is that he doesn't use the program to harm others, e.g. by charging money for it or even by using 
a license that forces others to credit him and so increase his reputation. He sacrificed part of his life purely to increase good in the world for everyone without trying to gain an edge over 
others. 


The latter is important to.show that what's.many times called selflessness nowadays is only **pseudoselflessness**, fake selflessness. This includes e.g. all the celebrities whọ publicly 
financially support charities; this seems like à nice gesture but it's of course just a PR stunt, the money spent on charities is money invested into promoting oneself, increasing fame 
sometimes even tax hacking etc. This also goes for professional firefighters, doctors, [FOSS](foss.md) programmers that use licenses with conditions such as attribution etc. This is not saying 
the behavior of such people is always pure evil, just that it's not really selfless. 


Selfless programs and art should be put into the [public domain](public domain.md) with waivers such as [CCO0](ccO.md). Using licenses (free or not) that give the programmer some advantage over 
others (eVven' e.g. attribution) are not selfless. 


## See Also 


- [dog](dog.md) 
T1 semiconductor.md ---------- 
# Semiconductor 


{ For a physicist there's probably quite a lot of simplification, this is written from the limited point of view of a programmer. -drummyfish } 


Semiconductors are materials whose electrical conductivity varies greatly with conditions such as temperature, illumination or their purity, unlike insulators who generally .don't conduct 
electricity very well (have a great [resistivity](resistivity.md)) and conductors who do. Semiconductors, especially [silicon](silicon.md) (Si), are the key componént of [digital](digital.md) 
[electronic](electronic.md) [computers](computer.md) and integrated circuits. Other semiconductors include germanium, selenium or compound ones (composed of multiple elements). 


Semiconductors are important for computers because they help implement the |binary](binary;md), logic circuits, they can behave like a switch that is either on (3307 off (0), Besides that they 
can serve e.g. for making measurements (a component whose resistivity depends on its illumination can be used to measure amount of light by measuring the resis idw Especially important 
elect ranac scomonents based on semiconductors are the **[diode](diode.md)** (lets current flow only one way) and **[transistor](transistor.md)** (a purely electrical "switch" that can be made 
extremely tiny). 


Normally semiconductors don't conduct so well at room temperature (they conduct better at higher temperatures, unlike metals), but their conductivity can be increased by so called **doping** -- 
introducing small impurities of other elements. By doing this we can get two types of semiconductors: 


-.**N type**: By adding ed an arsenic atom to a grid of silicon atoms we get an extra free electron because arsenic has 5 outer electrons while silicon has 4. Arsenic binds its 4 electrons 
with neighboring silicon atoms (with so called covalent bond, Staring pairs of electrons), but will have one unbound electron, which thanks to not being bound can move easily and help conduct 
electricity (note that when the electron does move away, arsenic will still want to get another electron because it will become positive charged, but the fifth electron is simply always more 
"loose" thanks to not being bound). In this type of semiconductor we have negative particles, the **electrons**, moving around. 

-O**p type rr By_similarly adding e.g..an boron atom to a silicon grid, we get a similar_situation; boron only has 3 outer electrons, so it will only bind to 3 silicon atoms, leaving one the 
bond wi one silicon incomplete, forming a **hole**. This hole can be seen'as a ivartual] (virtual md) positively charged particle, it is simply a lack of electron. An electron can temporarily 
jump in this uie AE will want to move away as boron doesn't want it there. In this type of semiconductor we can imagine the holes moving around (even though physically only electrons are 
moving, of course). 


If we connect a P and N type semiconductors, we get so.called **PN junction** which only conducts current one way and is used in diodes and transistors. After putting P and,N materials together, 
at the boundary some electrons from the N type material fill the holes in the P type material which creates a small *depletion region* of certain width. This region is an electric field that's 
negative on the P side and positive on the N side (because negative electrons have moved from N to P). If we connect the PN junction to a voltage source, with P side to the positive and N side 
to the negative terminal, we create an opposite eléctric field which will eliminate the depletion region and allow the flow of current. Connecting the sides the other way around will result in 
increasing the width of the depletion region and blocking the current flow. 

T settled.md ---------- 

# Settled 

When_a [software] (software. md is, so good it makes you stop searching further for any other software.in the same category, it makes the debate settled -- you've found the ultimate tool, you're 
now freé, you no longer have to think about the topic or invest any more precious time into trying different alternatives. You've found the [ultimate](ultimate.md), nearly [per rece Oper FECE md) 
tool for the job, the one that makes the others obsolete. Settling the competition of different tools is one of the goal of [good technology[|(lrs.md) as it frees users as well as programmers. 


For example [Vim](vim.md) often settles the search for a text and programming editor for many programmers. 


Nevertheless some soyboys just like hopping and switching their tools just because, they simply like wasting their time with things like [distrohopping](distrohopping.md) etc. There's no help to 
ese people. 


{ software that nade the debate settled for me: [vim](vim.md), [dwm](dwm.md), [st](st.md), [badwolf](badwolf.md) ~drummyfish } 
I shader.md ---------- 


Snader is a program running on the [graphics processing unit](gpu.md) (GPU), typically in many parallel instances as to utilize the GPU's highly parallel nature. As such they are simple to mid 
complexity programs. 


The word *shader* is also used more loosely to stand for any specific effect, material or look in 3D graphics (e.g. [games](games.md)), as shaders are usually the means of achieving such 
effects. 


Shaders are_normally written in a special **shading language** such as AStse I ( lsl.md) in the OpenGL | (opengl md) [APT] (api md), IE ESET (hts du md) pro fietary] (proprietary md)) in [Direct3D] 
(asd.md) API or the Metal shading language ([proprietary](proprietary.md)) i netat] metal.md) API. These anguág s afé often similar to [C](c.mdj with some ditions (e.g. véctor and matrix 
(a types) and simplifications (e.g. no function [recursion] (resursson-md)). High level [frameworks](framework.md) like [Blender](blender.m many times offer [visual programming] 

visual | 


programming.md) (point-n-click) of shaders with graph/node editors. 


Initially (back in the 90s.and early 3999s) shaders were used only for graphics, i.e, to transf 
purpose ]lgbgpu md), flexibility was added to shaders that allowed to solve more problems with t 
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orm 3D vertices, draw triangles and compute pixel colors. Later on as GPUs became more [generat 
he GPU and eventually general *compute* shaders appeared (OpenGL added them in version .3 in 


2010). 


To put .shaders in.the context, the flow of data is this: a [epu L (epu md uploads some data (aD models, textures, ,..) to the GPU and then issues,a draw command -- this makes the GPU start its 
**pipeline** consisting of different **stages**, e.g. the vertices of 3D models are transformed to screens space (thé vertex stage), then triangles are generated and rasterized (the shading 
stage) and the data is output (on screen, to a buffer etc.). Some of these stages are programmable and so they have their own type of a shader. The details of the pipeline differ from API to 
API, but in general, depending on the type of data the shader processes (the stage), we talk about: 


- **vertex shaders**: Perform per-vertex computations on 3D models, typically their transformation from their world position to the position in the camera and screen space. 

- out Eagpentepixel shaders**; Compute the final color of each pixel (Sometimes called more generally *fragments*), i.e. work per-pixel. A typical use is to perform [texturing](texture.md) and 
amount of reflected light (lighting model). 

- **geometry shaders**: Advanced stage, serves to modify the geometry of 3D models (these shaders can, unlike vertex shaders, generate of discard vertices). 
- **tesselation shaders**: Advanced stage, serves for subdividing primitives to create smoother geometry. 

- **compute shaders**: Perform general computations, used e.g. for computing physics simulations, [AI](ai.md) etc. 

- ) shaders** and other specific types 


Shit is something that's awfully bad. 
## List of Things That Are Shit 


MS Windows] (windows .md) 
00P](oop.md) (the ugly overused kind) 
systemd (Systemd.md) 


## See Also 


- [cancer](cancer.md) 
T1 shortcut thinking.md ---------- 
# Shortcut Thinking 


Shortcut thinking means making conclusions by established associations (such as "theft - bad") rather than making the extra effort of inferring the conclusion from known, possibly, updated facts. 
This isn't bad in itself, in fact it is a gréat and necessary [optimiza don] optimization mo) of our thinking process and it's really why we have long term memory -- imagine we'd have to deduce 
all the facts from scratch each time we think about anything. However shortcut thinking can be a weakness in many situations and leaves people prone to manipulation by [propaganda] 

(propaganda .md). As such this phenomenon is extremely abused by politicians, i.e. they for example try to shift the meaning of a certain negative word to include something they want to get rid 
of. 


Some commonly held associations appearing in shortcut thinking of common people nowadays are for example "theft = piracy = bad", "laziness = bad" “pedophiles = child rapists = bad" 
p 


"competition = good", "more jobs = good" "more complex technology = better", etc. hose most are of course either extremely’ simplified or just ain wrong. however some association may of 
course be correct, such as "murder = bad". 


Let's focus on the specific example of the association, "theft = bad". Indeed it has some sense in it -- if we turn shortcut thinking off, we may analyze why this association exists. For.most of 
our history the word theft has meant Staang a physical personal possession of someone else against their will*. Indeed, in a society of people of which moSt weren't rich, this was bad in most 
cases as it hurt the robbed person, he has lost something he probably needed. However the society evolved, the meaning of property itself has changed from "personal property" to "private 
property", i.e. suddenly there were people who could own a whole forest or a factory even if they have never seen it, and there were people who had much more than they needed. If a poor starving 
person Steals food from the rich who doesn't even notice this, suddenly the situation is different and many will say this is no longer bad. Nevertheless the word theft stayed in use and now 
included even such cases that were ethical because of the shifted meaning of the word "property" and due to changes in conditions of people. Recently the word property was shifted to the extreme 
with the invention of p Hinteblectual property] (intellectual property.md]**, i.e. the concept of being able to own information such as ideas or stories in books. Intellectual property is 
fundamenta Ly, different from physical property as it can't be stolen in the same way, it can only be copied, duplicated, but this copying doesn't rid the "owner" of the original information. And 
so nowadays the word "theft", or one of its modern forms, "[piracy](piracy.md)", includes also mere copying of information or even just reusing an idea (patent) for completely good purposes, for 
example writing computer programs in certain (patented) ways is considered a theft. Of course, some may argue that such a download or reuse prevents the "owner's" profit from selling copies of 
that information or licenses to that idea, however it must be known that again, society is completely different nowadays and this so called "theft" actually doesn't hurt anyone but some gigantic 
billion dollar corporation that doesn't even notice, no actual person gets hurt, only a legal entity, and these so called "theft" actually give rise to good, helpful things. In fact, hurting a 
corporation, by definition a [fascist] (rascasm.md) entity hostile to people, may further be seen as a good thing, so stealing from corporation is also good by this view. Furthermore the illusion 
of profit theft here is arbitrarily made, the "theft" exists only because we've purposerully created a system which allows selling copies of information and restricting ideas and therefore 
enables this "theft", i.e. this is no longer a natural thing, this_is something miles away from the original meaning of the word "theft". With all this in mind we may, in today's context of the 
new meaning of old words, reconsider theft to no longer be generally bad. 


When confronted with a new view, political theory etc., we should try to turn shortcut thinking off, Doing this can be called.**being open minded** e 


^ i ae opening one's mind to reinterpretation 
of very basic concepts by a new’ view. Also we should probably update our association from time to time just to keep them up with the new state of the wo 


rd. 


The politics cand views of [LRS](lrs.md) requires extreme open mindedness to be accepted by someone indoctrinated by the standard capitalist fascist propaganda of today. 
Il sigbovik.md ---------- 
# SIGBOVIK 


SIGBOVIK ([special. interest group] (sig. md) on Harry, Q._Bovik) is a [computer science conference] (compsci md) running since,2007 that focuses on researching and presenting Ifun (fun.md) ideas in 
fun ways, scientifically but' in à lighthearted [hacker ] (hacking md) spirit similar to e.g. [esotéric progra ming languages](esolang.md) research or the [IOCCC](ioccc.md). SIGBOVIK has their own 
proceedings just like other scientific conferences, the contributors are usually professional researchers and experts in computer science. The name seems to be a reference to the "serious" 
conrerences aon) as [SIGGRAPH] (siggraph.md), SIGMOD etc. (SIGBOVIK is organized by the *Association for Computational Heresy* while the "serious" SIGs are run by *Asscoiation for Computing 
Machinery*, ACM). 


A famous contributor to the conference is e.g. Tom7, a [PhD](phd.md) who makes absolutely lovely [youtube](youtube.md) videos about his fun research (e.g. this one is excellent 
https://www. youtube .com/watch?v=DpXy041BI lA). 


{ Skimming through the proceedings sadly most of the stuff seems rather silly, though there are a few good papers, usually those by Tom7. Maybe I'm just dumb. ~drummyfish } 
II sin.md ---------- 


Sine, abbreviated *sin*, is a [trigonometric] trigonometry.md) [function](function.md) that simply said models a smooth oscillation, it is one of the most important and basic functions in 
geometry, [mathematics] (math, m ) and [physicé (physics md); and of course in [programming] (programming md). Along with [cosine](cos.md), [tangent] (tan.md) and [cotangent | (cot md) it belongs to a 
group of functions that can be defined by ratios of sides of a right triangle depending on one of the angles in it (hence *trigonometric* -- "triangle measuring"). If some measurement looks like 
sine function, we say it is *harmonic*. This is very common in nature and technology, e.g. a weight on a spring goes up and down by this function, [alternating current](ac.md) voltage has the 
sine shape (because it is generated by a circular motion) etc. 


The function is most commonly defined using a right triangle as follows. Consider the following triangle: 


/ 
vA 
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c/ 
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*Sin(A)*, where *A* is the angle between side *b* and *c*, is the ratio *a* / *c*, The function can be defined in many other Ways, for example it is the .curve,we get when tracking only one 
direction (e.g. horizontal) of a point moving alongside circle. It can also be defined as a solution to some [differential equations](differential equation.md) etc. 


The graph of the sine function is following: 


^ sin(x) 


**why the fuck are there these [pi](pi.md) values on the x, line???** Nubs often can't comprehend this. These pi vaļues are values in ec [radiaps](radiap.md)?r, units of measuring angles where *2 
pi* is the full angle (360 degrées). In fact sine is sometimes shown with [degrees | (degree md) instead of radians (so imagine 90 degrees on the line where there is 1/2 pi etc.), bu 
mathematicians prefer radians. **But why are there angles in the first place???** Wh oesn't it go e.g. from © to 1 like all other nice functions? Well, it's because of the relation to 
geometry, remember the fucking triangle above... also if you define sine with a circle it all repeats after *2 pi*. Just draw some picture if you don't get it. 


Some additional facts and properties regarding the sine functions are: 


The domain are all [real numbers](real_number.md), the [codomain](codomain.md) are real numbers in interval <-1,1> (including both bounds). 
It is an [odd function](odd_function.md (*-sin(x) = sin(-x)*). 
It is periodic, with a period of 2 i](pi.md). 


Sine is just shifted [cosine](cos.md), i.e. *sin(x) - cos(x - 1/2 pi) i : x I d V th 
Its inverse function is [arcus sine](asin.md), abbreviated *asin*, also written as *sin^-1* -- this function tells you what arg ent you need to give to sin to get a specific result number. 
It's actually an inverse of only part of the sihe function because the whole sine function can't be inverted, it isn't [bijectivé](bijeCtion.md). 


y 
] 
- [Derivative](derivative.md) of *sin(x)* is *cos(x)*, the [integral](integral.md) of *sin(x) dx* is *-cos(x)*. 

- By adding many differently shifted and scaled sine functions we can create basically any other function, see e.g. [cosine transf 
- Sine and cosine] (cos md) functions are used to draw [circles](circle.md). If you plot points with *x* coordinate equal to *sin( 
*2 * pi*, you'll g a unit circle. 

- *sin(x)A2 + cos(x)^2 = 1* 


t 
orm](cosine transform.md). 
t)* and *y* coordinate equal to *cos(t)* for *t* going from O to 


Some values of the sine function are: 


x (rad) x (deg) sin(x) 

0 0 (oJ 

pi / 12 15 -0.259 

pi/ 6 30 0.5 

pi/4 45 sqrt(2)/2 ~= 0.707 
pi / 3 60 sqrt(3)/2 ~= 0.866 
pi / 2 90 1 

2 pi 360 10) 


## Programming 


In programming languages sine is generally available in some math library, for example in [C](c.md) the function ‘sin’ is in "math.h'. Spare yourself bugs, **always check if your sin function 
expects [radians](radian.md) or dégrees!* 


There exists an **ugly engineering [approximation] (approximation.md)** of sine that can be useful sometimes, it says that 


*sin(x) = x, for small x* 
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Indeed, sine looks similar to a mere line near 0, but you can see it quickly diverges. 
When implementing your own ^sin' function, consider what you expect from it. 


If you want a small, fast and perhaps integer only.'sin' function (the one we'd prefer in URS] (Urs mdp) that doesn't need extreme accuracy, consider using a naL took up table](lut.md)**. You 
simply precompute the values of the sine function into a static table in memory and the functi just fétrieves them when called -- this iS super fast. Note that you can save à lot of space b 


**only storing sine values between © and 1/2 pi**, the remaining parts of the function are just different transformations of this part. You can further save space and/or make the function wor 
with [rissts] trist md) by further [interpolating] (interpolation.md) (even just linearly) between the stored values, for example if ^sin(3.45)' is called and you only have values stored for 
^sin(3.4)' and 'sin(3.5)', you simply average them. 


yer rọugh and fast approximations e.g. for primitive music synthesis can be done with, the traditional very basic. [square] (square function .md or [triangle] (triangle_function.md) functions. The 
following is a simple 8bit linear approximation that's more accurate than square or triangle (approximates sine with a linear function in each octant): 


(signed char sinA(unsigned char x) 
unsigned char quadrant - x / 64; 
x %= 64; 


if (quadrant % 2 == 1) 
xX = 63 - X; 


xX =xX < 32? (2 * x + x) : (64 + x); 


return quadrant <= 1 ? (128 + x) : (127 - x); 


Similar approximation can.be made_with a quadratic. curve, the following is a modification of the above function that does this (notice that now we need at least 16 bits for the computation so 
the data type changed to int): { I quickly made this just now, maybe it can be improved. ~drummyfish } 
int sinA(int x) 

unsigned char quadrant = x / 64; 

x %= 64; 


if (quadrant % 2 == 1) 
x = 63 - x; 


return quadrant <= 1? (255 - x) : x; 


If you don't need extreme speed there exist very nice sine [approximations](approximation.md), e.g. the extremely accurate **Bhaskara I's approximation: Cangte in radians): iU id 
he 


ist ver ~= (16 * 
(piz zl A * pi^2 - 4 * x * (pi - x))*. (This formula is actually more élegant for cosine, so it may be even better to consider using that.) Here is a (c.md) [fixed point] Exe fant dd) 
implementation: 


"define UNIT 1024 
#define PI ((int) (UNIT * 3.14159265)) 


/* Integer sine using Bhaskara's approx. Returns a number 
in «-UNIT, UNIT» interval. Argument is in radians * UNIT. */ 


Pt sinInt(int x) 
int sign - 1; 


if (x « 0) // odd function 


x %= 2 * PI; 
if (x » PI) 


X -- PI; 
sign *- -1; 


x *= PI- X; 


return sign * (16 * x) / ((5 * PI * PI - 4 * x) / UNIT); 


Another approach ds to use [Taylor series](taylor series.md) to approximate sine with a [polynomial](polynomial.md) to whatever precision we need (this is used e.g. in calculators etc.). 
lll sjw.md ---------- 
# Social Justice Warrior 


Social justice [warrior Fight culture md) (520) is an especially active, [toxic] (toxic md) and aggressive kind of [pseudoleftist|(pseudoleft.md (a kind of [fascist](fascism.md)) that tries to 
fi hey (Fight culture im (especially on the Internet) anyone opposing or éven just slightly criticizing the mainstream pseudoleftist gospel such as the [feminism] (remintsm md) and [LGBT] . . 
lgbt.md) propaganda. SJws divide people rather than unite them, they operate on the basis of hate, revenge and mass hysteria and as we know, hate spawns more hate, they fuel a war mentality in 
Society. They support hard [censorship](censorship.md) (forced [political correctness](political correctness.md)) and bullying of their opposition, so called [cancelling (cancel_culture.md), and 

also such retardism as [sanism](sanism.md) and whatnot. [Wokeism](woke.md) is yet more extreme form of SJWery. 


the term is pejorative. We say it's not pejorative enough xD 
-- slowly boiling the frog.md ----- - 
# Slowly Boiling The Frog 


*Slowly boiling the frog* is a phrase said to communicate the idea that people will tolerate a great change for the worse if that change is very gradual, even if they would absolutely not. 
tolerate this Change being made quickly. It refers to an experiment in which a frog doesn't jump out of boiling water if the water temperature is raised very gradually (even though according to 
"modern science" this experiment isn't real). 


For example the amount and aggressiveness of brainwashing [ads] (ad md) and technological abuse that young people tolerate nowadays would have been absolutely unacceptable a few decades ago, but 
now it's the reality of life that few even question (some complete retards like that *linus tech* [faggot](faggot.md) even defend it). 


step takes away a bit of freedom while promising some reward, normally in form of additional Cont peer normal people are too braindead to see the obvious trick and are enthusiastic abo the 
change. If you tell them that giving up [net neutrality](net neutrality.md) or [P2P](p2p.md) encryption will eventually lead to almost complete loss of freedom, they label you a [tinfoil] 
(tin oit.md} or "Conspiracy theorist", they tell you that "it's not a big deal". So it will go on with other and other changes and the normie is still happy because he can only see one step 
ahead or behind. The bad thing is that it's not only the normie who will suffer --in fact he may even be happy as a slave robot of the system -- but you will 

future of the environment we àll have to live in. 


The technique of slowly boiling the frog is used by [corporations](corporation.md), [governments (government.md), fascists and idiots to slowly take away people's freedom in small steps each 
ou 
V 


suffer as well. Normies decide the 


Slowly boiling the frog works very well when spanning several generations because a new generation won't remember, that. things used, to be better. Parents can.tell them but young never listen to 
older generations, or take them seriously. A [zooomeř]( enz^mdj won't remember that compüters used to be better, he thinks that [bloated](bloat.md) phones filled with Pads} tad md§ and [DRM] 
(drm.md) that don't work without Internet connection and that spy on you constantly are the only way of technology. 

T small3dlib.md ---------- 

# Small3dlib 


Small3dlib, (S3L) is_a very, portable LyRSI CIUS md )/ suckless | (suckless md) {single header ](signle_header md) 3D [software renderer ] (software rendering md) [library] library.md) written by. 
[drummyfish](drummyfish.md) in the [C](c.md) programming lai guage It is very efficient and runs on many résource-limited computers such as embedded [open consoles](open_console.md). It is 
similar to Tinyet|(tinygl/md), but yet more simple. Small3dlib is [public domain](public domain.md) [free software](free software.md) under [CCO](ccO.md). 


The repository is available at https://codeberg.org/drummyfish/small3dlib and https://gitlab.com/drummyfish/small3dlib. 


Small3dlib.can be used for rendering 3D graphics,on almost any device as it is written in pure [£92 (c99.md) without any software and hardware [dependencies] (dependency md); it doesn't use the 
standard porary, [floating point] ( oat md) or [GPU](gpu.md). It is also very flexible, not forcing any preprogrammed {shaders (shader imd) -- instead it only computes which pixels should be 
Ed and lets the programmer of the main application decide himself what should be done with these pixels (this is typically applying some [shading](shading.md) and writing them to 

screen). 


Some of the rendering features include: 


- different drawing strategies ([z-buffer](z buffer.md), sorted rendering, 

- top-left rasterization rule (no holes between or overlaps of triangles 

- [perspective correct ion] (perspective correction md) (either none, full or approximate) 
- different near plane collision handling strategies (culling, clipping, shifting, 
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EET XXXXXXXXXXXXXXXXXX XXXXXXXXXXXX 
XXXXXXXXXXXXXXXXXXX se XXXXXXXXXX 
XXXXXXXXXXXXXXXXXXX C XXXXXXXXXX 
XXXXXXXXXXXXXXXXXX + XXXXXXXX 

HXXXXXXXXXXXXXXXXXXX XXXXXXXX 
HXXXXXXXXXXXXX 2 XXXXXX 
XXXXXXX zg XXXXX 


XXXX 
XXX 

Xx 
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*Simple ASCII rendering made with small3dlib.* 


T1 smallchesslib.md ---------- 
# Smallchesslib 


TODO 


The repository is variable at https://codeberg.org/drummyfish/smallchess lib. 
Il smart.md ---------- 


*Smart, smells like fart.* 


The adjective "smart", as in m *smartphone*, is in, the context of [modern (modern,md) [capitalist technology] (capitalist_technology.md) used as a euphemism for malicious features that include 
[spyware](spyware.md), [bloat](bloat.md), obscurity, [DRM] (drm.md), ads, programmed [planned obsolescence | (p anned obsolescence md), unnecessary [dependencies |( de endency.md) (such as required 
Internet connection) anti repazn design and others Smart" Fechno lagy is far inferior to the traditional "dumb" technology and usually just downright [harmfu M armful.md) to its users and 
society as a whole but norma (i.e. retarded) people think it's good because it has a cool name, so they buy and support such technology. They are fstowly boiled](slowly boiling the frog.md) to 
accept "smart" technology as the standard. 
---------- smol_internet.md ---------- 

# Smol Internet 


*TFW Internet became such shit people are running away from it.* 


Smol Internet, smol web, small web, smol net, dork web, poor man's web, web revival and similar terms refer to Internet technology (such as [gopher] gopher.md), s emini](gemini.md), plain [HTML] 
html.md) etc.) and communities that are smaller, [sim ter} (kiss md), less controlled and less [toxic] toxic smd) than the "big mainstream Intérnet" (@specially t [Web](www.md)) which due to 
capitalism](capitalism.md) became littered with [shit (shat md) like Lads (marketing md), unbearable [bloat](bloat.md), censorhip, [spyware](spyware.md), corporate propaganda, masses of 
retarded people](influencer.md), [bullshit](bullshit.m ) cheap visuals like animations etc. Consider this analogy: the mainstream, i.e. [world wide web](www.md), [Discord](discord.md), 
Facebook](facebook.md) etc., is like a big shiny city, but as the city grows and becomes too stressful, overcrowded, hasted, overcontrolled with police and ads on every corner, people start to 

move to the countryside where life is simple 


r and happier -- smol Internet is the countryside. 


What EXACTLY constitutes a Smol Internet? Of course we don't really haye exact definitions besides what people write on blogs, it also.depends on the exact term we use smol_web may refer 


e.g. 
specifically to lightweight self-hosted websites while smol net wi also include different protocols than HITEL) Ctt .mi 1 (i.e. things outside the Web). But we are’ usual talking about 

simpler ([KISS](kiss.md), [suckless](suckless.md), ...), alternative, [decentralized](decentralization.md), [sel asted] (se f_hosting.m H technology (protocols, servers, uon and communities 
that strive to escape commercially spoiled spaces. These communities don't aim to grow to big sizes or compete with the mainstream Web, they do not seek to replace the Web or achieve the same 


things (popularity, profitability, ...) but rather bring back the quality the Web (and similar services such as [Usenet] (usenet md) ) used to have in the early days such as relative freedom, 
unrestricted sharing, free speech, simplicity, decentralization, creative personal sites, comfiness, [fun](fun.md) and So on. It is for the people, not for companies and corporations. Smol 
Internet usually refers to [gopher | (gopher md and [gemini] (gemini md), the alternative protocols to [HTTP (http. md). the basis of the Web. Smol Web on the other hand stands for simple, plain 
[HTML](html.md) web 1.0 static personal/community sites on the Web itself which are however hosted independently, often on one's own server (self hosted) -- such sites can be searched e.g. with 
the [wiby](wiby.md) search engine. It may also include small communities such as [pubnixes](pubnix.md) like [SDF] (sdf .md) and [tildeverse](tildeverse.md). 

such as amail{ (email md) and [IRC](irc.md) may also fall under Smol Internet. 

---------- social_inertia.md ---------- 

# Social Inertia 


Other KISS communication technology 


Social inertia appears when a social group continues to behave in an established way mainly because it has behaved that way for a long time, even if such behavior is no longer justified. 
T software.md ---------- 
# Software 


The article you're looking for is [here](sw.md). 
T sorting.md ---------- 
# Sorting 


Sorting means rearran ing a.sequence, such as a fhisti (list md) of numbers, so that the elements are put in a specific order (e.g. ascending or descending). In computer science] (compsci md) 
sorting is quite a wide topic, there are dozens of sorting lalgoraithms T algorithm md), each with pros and cons and different attributes are being studied, e.g. the algorithm's [time complexity] 
(time_complexity md), its stability etc. Sorting algorithms are a favorite subject of programming classes as they provide a good exercise for programming and analysis of algorithms and can be 
nicely put on tests : 


Some famous sorting algorithms include fbybble sort] (bubble sort md) (a simple KISS. algorithm) [auick (quick sort.md) and [merge](merge sort.md) sort (some of the fastest algorithms) and 
[stupid sort](bogoSort:md) (just tries different [permutations](permutation.md) until it hits thé jackpot) 


In practice however we oftentimes end up using some of the simplest sorting algorithms (such as [bubble sort](bubble sort.md)).anyway, unless we're rogramming a database or otherwise dealin 
with enormous amounts of data. If we need to Sort just a few hundred of itéms and/or the sorting doesn't occur very often, a Simple algorithm does the job well, sometimes even faster due to 
potential initial overhead of a very complex algorithm. So always consider the [KISS](kiss.md) approach first. 


Attributes of sorting algorithms we're generally interested in are the following: 


zt time] (time complexity .md) and [space](space_complexity.md) complexity**: Time and space complexity hints on how fast the algorithm will run and how much memory, it will need, specifically 
we'ré interested in the **bes worSt and average case** depending on the length of the input sequence. Indeed we ideally want the fastest algorithm, but it has to be known that a better time 
complexity doesn't have to inply a faster run time in practice, especially with shorter sequences. An algorithm that's extremely fast in best case scenario may be extremely slow in non-ideal 
cases. With memory, we are often interested whether the algorithm works **in place**; such an algorithm only needs a constant amount of memory in addition to the memory that the sorted sequence 
takes, i.e. the sequence is sorted in the memory where it resides. 

- **implementation complexity | A simple algorithm is better if it's [good enough](good_enough.md). It may lead to e.g. smaller code size which may be a factor e.g. in [embedded] (embedded.md). 
- **stability**: A stable sorting algorithm preserves the order of the elements that are considered equal. With pure numbers this of course doesn't matter, but if we're sorting more complex data 
structures (é.g. sorting records about people by their names), this attribute may become important. 

- **comparative vs non-comparative**: A comparative, sort only requires a single operation that compares any two elements and says which one has a higher value -- such an algorithm is general and 
can be used for sorting any data, but its time complexity of the average casé can't be better than *O(n * log(n))*. Non-comparison sorts can be fastér as they may take advantage of other 
possible integer operations. 

sre fecursion] (recursion md) and [parallelism](parallel.md)**: Some algorithms are recursive in nature, some are not. Some algorithms can be parallelised e.g. with a [GPU](gpu.md) which will 
greatly increase their speed. 

- **other**: There may be other specific, e.g. some algorithms are are slow if sorting an already sorted sequence (which is addressed by *adaptive* sorting), so we may have to also consider the 
nature of data we'll be sorting. Other times we may be interested e.g. in what machine instructions the algorithm will compile to etc. 


In practice.not only the algorithm but also its implementation matters. For example if we have a sequence of very large data structures to sort, we may want, to avoid physically rearranging these 
structures in memory, this Could be slow. In such case we may want to use **indirect sorting**: we create an additional list whose elements are indices to the main sequence, and we only sort 
this list of indices. 


44 List Of Sorting Algorithms 


Sodevs are incompetent wanna-be programmers that usually have these characteristics: 


- Being [pseudoleftist](left right.md) (fagcist) political activists pushing [tranny software](tranny_software.md) and_[COCs](coc.md) while actually being mainstream centrists in the tech world 
(advocating "[open-source](open sourcé.md)" instead of [free_software](free_software.md), being okay with [propriétary](proprietary.md) software, [ lost] (bloat may etc.). 

- orying to be "cool", having friends, wearing T-shirts with "coding jokes", having tattoos, piercing and colored hair (also trimmed bear in case of males). 

- Only being hired in tech for a no-brainer job such as "coding websites" or because of diversity quotas. 

- Being Acta] bad ar programming, using meme high-level languages like [JavaScript](javascript.md), [Python](python.md) or [Rust](rust.md). 

- Using a [Mac](mac.md). 

- Thinking they're experts in technology because they are familiar with the existence of [Linux](linux.md) (usually some mainstream distro such as [Ubuntu](ubuntu.md)) and can type 'cd' and 'ls^ 
in the terminal. 

- Being only briefly aware of the tech culture, telling big-bang-theory level jokes (*sudo make sandwich*, 42 hahahahahahaha). 

- Being highly active on social networks, probably having a pare lear portrait of their ugly face on their profile. . . " TE 

- Believing in and engaging in [eapitalisn] (capitatisn.m li elieving corporations such as [microsoft (microsoft.md), wanting to create "startups", being obsessed with [productivity] 
(productivity cult.md), inSpirational quotes and masturbating to tech " eve Jobs] d 

- Using buzzwords like "solution", "orchestration" etc. 


visionaries" like [S Steve jobs.m 


- -- soyence.md -- 
# Soyence 


*Not to be confused with [science](science.md).* 


Soyence_is [business | (business md) [propaganda] (propaganda md) and olitics](politics.md) trying to ass as Legience](sgience nd) nowadays promoted typically by [pseudoleftists] 

{pseudolert. ma) [pseudoskeptics ](pseudosképticism.md), [capitalists Peapitalism md) and [Corpora ions](corporation.md). Soyence i$ not about listening to what science says, it is about 
istetning to what scientists say (or rather those who were officially pronounced scientists qi soyence is what the typical reddit [atheist](atheism.md) or [tiktok](tiktok.md) [feminist] 
feminism.md) believes science is or what Neil De Grass Tyson tells you science is. Soyence ca is itself science and [gatekeeps]( atekeeping.md) the term science by calling unpopular science 
such as that regarding human [race](race.md) or questioning big pharma [vaccines](vaccine.md)) "[pseudoscience] (pseudoscience.m gar Soyence itself is pseudoscience but it has strong connection 
to politics, it is accepted by the mainstream, controlled by those in power and has added attributes such as high organization, intentional misleading, state approval etc. 


Compared.to good old [funi ffug) ppeudosciences such.as [astrology] (astrology md), soyence is extra sneaky by purposefully, tr ing to blend in with real science, i,e, within a certain truly 
scientific field, such as pio log ; there is a soyentific [Cancer](Càncer.md) mixed in by activists, corporations and state, that may be hard to separate for common folk and many times even Tor 
pros. .This is extremely [harmful |(harmFul.md) as in the eyes of retarded people (basically everyone) the neighboring legit Science gives credibility to propaganda bullshit. There is a tendency 
o think we somehow magically live in a time that's fundamentally different from other times in history in which it is now a pretty clear and uncontroversial fact that the name of science was 
abused hard by propaganda, almost everyone easily accepts that historically politically constructed lies were presented as confirmed by science, but somehow people refuse to believe it could be 
the case nowadays. In times of Nazism there was no doubt about race being a completely scientific term and that Jews were scientifically confirmed to be the inferior race -- nowadays in times 
when anti Nazis have won and politics is based on denying existence of race somehow scientists start to magically find evidence that no such thing as race has ever existed -- how convenient! And 
just in case you wanted to check if it's actually true, you'll be labeled a racist and you won't find job ever again. 


Soyence uses all the cheap tricks of politics (also not dissimilar to those of [greenwashing](greenwashing.md) [openwashing] (openwashing. md etc.) to win stupid peop te it builds on the cult of 
bullying religion and creating a [war mentality] (Ti ht_culture.md), overuse of twisted "rationality" ([pseudoskepticism] (pseu joskepticism.md)), creating science [bloat](bloat.md) and bullshit 
"scientific" fields to obscure lies, punishment of the correct use of rationality, building cults of personality ("science educators", the [gatekeepers |( of "science") and 
appealing to egoism and naivity of wannabe smartasses while at the same time not even holding up to principles of science such as genuine objectivity. A soyence kid will for example keep 
preaching abouť how everything should be proven by reproducible experiments while at the same time accepting [98 Facto | (de-facto -mi ) irreproducible results, e.g. those obtained with billion 
dollar worth research performed at [CERK] (cern. md) which can NOT be reproduced anywhere else than at CERN with thousands of top scientist putting in years of work. Such results are not 
reproducible in practice, they are accepted on the basis of pure faith in those presenting it, just as religious people accept the words of preachers. The kid will argue that in theory someone 
else can build another CERN and reproduce the results, but that won't happen in practice, it's just a purely theoretical unrealistic scenario so his version of what "science" is is reatty based 
on reproducibility that only works in a dreamed up world, this kind of reproducibility doesn't at all fulfill its original purpose of allowing others to check, confirm or refute the results of 
experiments. This starts to play a bigger role when for example vaccines start to get promoted by the government as "proven safe by science" Tread "claimed safe by a corporation who makes money 
off of people being sick"), the soyence kid will gladly accept the vaccine and [fight](fight_culture.md) for their acceptance just thanks to this label, not based on any truly scientific facts 
but out of pure faith in self proclaimed science authorities -- here the soyentist is relying purely on faith, a concept he would like to think he hates with his soul. 


gatekeepin 


Soyence relies on, low Lg issng), shallow education and popular "science education" (erg. neil de grass) while making its followers believe they are smart. It, produces propaganda material, such 

as "documentaries" wit gan Freeman (i.e. people who are good at persuasion rather than being competent), series like The Big Bang Theory and youtube] (youtube md) videos with titles such as 

"Debunking Flat Earth with FACTS AND LOGIC", so there's a huge mass of [NPCS] (npe md) thinking they are Einsteins who blindly support this cult. Soyence attacks science from within by attacking 
e 


its core principles, i.e. it tries to ridicule and punish thinking outside t ox and asking specific questions -- in this it is not dissimilar to a mass [religion](religion.md). 


Examples of soyence: 
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- [gender studies](gender studies.md) [LMAO](lmao.md) 

- "Race is a social construct and doesn't have any biological meaning." 

- any [pseudoskeptical |(pseudoskepticism md shit trying to look "scientific" 

nA Ht aegros, e.g. someone getting [PhD](phd.md) in "user experience", "level design", "diversity in software engineering" or "making youtube videos" (like that fucker from Veritasium 
mao]( lmao .md) ). 

- "Women are as intelligent as men." 

- "Science popularization" as in building authority of so called "scientists" so as to create a political capital. 

- "This extremely, lucrative [Covid](covi .md) vaccine made by us in record time is absolutely safe, don't dare question it, just take it 5 times a year and pay us each time you do, don't mind 

any side effects." --Big Pharma 

- "Science says god doesn't exist." aka reddit Lathessm] (atheism md) 

- "We can't believe this because it wasn't peer censored and/or it didn't pass the [null ritual](null_ritual.md) and/or it wasn't published in a journal on our approved literature list." (-- 

[Wikipedia] (wikipedia.md) ) 

"This gender studies expert has proven sex is a racial construct and has no biological meaning. You disagree? Well, do you have a PhD in gender studies? No? Then shut up you fucking sexist." 

- his goes against SCIENTIFIC CONSENSUS therefore it's pseudoscience and conspiration theory. 

- his research is racist.", using terms such as "scientific racism". 

- le should burn these old books that say things we don't like, just in case. When Nazis did it it was different." , , 

- his research was made by a [racist](racism.md) so it is invalid, also we should [lynch](cancel culture.md) the guy just in case." 

- il de grass/Morgan Freeman "documentaries" 

- "We can totally trust the results of commercial research." 

- «[hese negative results are useful but unexciting so let's not publish them, we gotta entertain our readers to stay on the market. We GOTTA TELL INSPIRATIONAL STORIES with our papers." -- 

soyence journals 
"No, you can't research the details of historic events such as Holocaust." (see anti [Holocaust](holocaust.md) denial laws) 

- great part of [economics](economics.md) 

- "[pedophilia](pedophilia.md) is a mental illness while pure [homosexuality](gay.md) is not" 


-- speech_synthesis.md ---------- 
# Speech Synthesis 


TODO 

## Example 

This is a simple [e] (cmd) program (using [float](float.md) for simplicity of demonstration) that creates basic vowel sounds using formant synthesis (run e.g. as “gcc -lm program.c && ./a.out | 
aplay', 8000 Hz 8 bit audio is supposed): 

#include <stdio.h> 

#include <math.h> 


double vowelParams[] = { // vocal tract shapes, can be found in literature 
// formanti formant2 widthi width2  amplitudei amplitude2 


50, 1650, 500, 500, 4; 0.2, // à 
390, 2300, 500, 450, i 0.9, // e 
240, 2500, 300, 500, i 0:5, // i 
250, 600, 500, 400, i 0.9, // 0 
300, 400, 400, 400, 4 1.0 //u 


J; 
double tone(double t, double f) // tone of given frequency 
return sin(f * t * 2 * M PI); 


/* simple linear ("triangle") function for mode Laing spectral shape 
of one formant with given frequency location, width and amplitude */ 
double formant(double freq, double f, double w, double a) 


double r = ((freq - f +w/ 2) * 2* a) /w; 


if (freq > f) 
r=-1* (r - a) +a; 


returnr»1?1:(í(r«0?0:r); 


y* gives one sample of speech, takes two formants as input, fundamental 
rreguency and possible offset of both formants (can model "bigger/smaller 
ead" 
double speech(double t, double fundamental, double offset, 
double f1, double f2, 
double w1, double w2 
double a1, double a2) 


int harmonic - 1; // number of harmonic frequency 
double r - 0; 
/* now generate harmonics (multiples of fundamental [frequen as the source, 


and multiply them by thé envelope given by formants (no need to deal with 
multiplication of spectra; as we're constructing the result from basic 


frequencies, we can simply multiply each one directly): */ 
unite 1) 
double f = harmonic * fundamental; 
double formanti = formant(f,f1 + offset,w1,a1); 
double formant2 = formant(f,f2 + offset,w2,a2); 
// envelope = maxfronmaned formant2 
r += (formanti > formant2 ^ formanti : formant2) * 0.1 * tone(t,f); 


if x 10000) // stop generating harmonics above 10000 Hz 
reak; 


harmonic++; 


3 
return r > 1.0 ? 1.0 : (r« 0? 0 : r); // clamp between 0 and 1 


int main(void) 
for (int i = 0; i < 50000; ++i) 


double t = ({doub le) i) / 8000.0; 
double *vowel = vowelParams + ((i / 4000) % 5) * 6; // change vowels 


putchar(128 + 127 * 
speech(t,150, -100, vowel[0], vowel[1], vowel[2], vowel[3], vowel[4], vowel[5])); 


return 0; 


---------- splinternet.md ---------- 
# Splinternet 


T sqrt.md ---------- 
# Square Root 
TODO 


The following is an [approximation] (approximation .md) of integer square root in [C](c.md) that has acceptable accuracy to about 1 million (maximum error from 1000 to 1000000 is about 7%): 
{ Painstakingly made by me. -drummyfish } 


int32 t sqrtApprox(int32 t x) 


return 

x « 1024) ? 

-2400 / (x * 120) * x / 64 * 20) 

((x « 93580) ? 

-1000000 / (x + 8000) + x / 512 + 142) : 

1 -75000000 / (x + 160000) + x / 2048 + 565)); 
sorceress ssao.md ---------- 
# SSAO 


Screen space_ambient occlusion {SSAQ) is a [screen space] (screen space,md) technique used.in 3D {computer graphics] (graphics md) for un Lapproximgting](approximation .md)** ambient occlusion] 
(ambient occlusion.md) (basically "dim shadows in corner which itself is an approximation of true [global illumination](global_illumination.md)) in a way that's easy and not so expensive to 
implement to run in [real time](real time.md). The effect however looks ugly many times and is often criticized, see e.g. an excellent article at https://nothings.org/gamedev/ssao/. 


{ 2023 report: SSAO still sucks. -drummyfish } 


special hardware. Therefore some game devs cheat and use a cheap approximation: O is imp ented as a [po processing](post processing.md) [shader](shader.md) and only uses the information 
available on the screen, specifically in the [depth buffer] (g buffer md) -- this gives only partial information about the actual scene geometry, i.e. the algorithm doesn't know what the back 
facing, screen-perpendicular or off-Screen geometry looks like and has to make guesses which sometimes result in quite visible inaccuracies. 


Exact ambient occlusions can be computed with algorithms such as RTAO (which uses | raytracing](raytracing,md)), but this requires complete information about the Trani oh and is too slow without 
st. 


This methods is notoriously ugly in certain conditions and many [mpdern] (modern. md) [games | (game md) suffer from this, even the supposedly "photorealistic" engines like. Unreal -- if someone is 
standing in front of a wall there is a shadow outline around him that looks so unbéliévably ugly you literally want to puke. But normie eyes can't see this lol, they think that's how reality 
looks and they are okay with this shit, they allow this to happen. Normies literally destroy computer graphics by not being able to see correctly. 


What_to.do then? The most [suck less] (suck less md) way is to simply do.no ambjent occlusion -- seriously test how it looks and if it's gkay just, save yourself the effort, performance and 
complexity. Back in the 90S we didn have this Shit’ and games unironically looked 100 times better. You can also just [bake](baking.md) thé ambient occlusion in textures themselves, either 
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directly in, the color texture or use [light maps](light_map.md). Note that this makes the ambient occlusions static and with light maps you'll need more memory for textures. Finally, if you 
absolutely have to use SSAO, at least usé it very lightly (there are parameters you can lower to make it less prominent). 

T2 steganography.md ---------- 

& Steganography 


Steganography means hiding secret information in publicly accessible data; for example it is possible to hide text messages in a digital photograph. by slightly modifying the colors of the image 
ixéls -- that photo then looks just like an innocent picture while in fact bearing an extra information for those who càn read it. Steganography differs from [encryption](encryption.md) by 


rying to avoid even suspicion of secret communication. 


There are many uses of steganography, .for example in secret.communication, bypassing censorship ,or secretly tracking a piece of digital media with an_invisible [wacermar ic (watermark. md) (game 
companies have used steganógraphy to identify which game clients were used to leak pre-release footage of their gamés). [Cicada 3301](cicada.md) has famously uséd steganography in its puzzles. 


Steganography may need to take into account the possibility of the data being slightly modified, for example pictures exchanged on the [Internet](internet.md) lose their quality due to repeating 
compresSions, cropping and format conversions. Robust methods may be used to presérve the embedded information even in these cases. 


Some notable methods and practices of steganography include: 


s pbedding in mae ieee e.g. making intentional typos in certain places, using extra white or zero-width characters, modifying formatting and case or using [Unicode](unicode.md) homoglyphs can 
all carry information. 

- Embedding in **images**. One of the simplest methods is storing data in least significant bits of pixel values (which won't be noticeable by human eyes). Advanced methods may e.g. modify 
statistical properties of the image such as its color [histogram] (histogram md). 

- Embedding in **sound**, **video**, vector graphics and all other kinds of media is possible. 

- All kinds of data can be embedded given enough storage capacity of given bearing medium (e.g. it is possible to store an image in text, sound in another sound etc.). 

- Information that's present but normally random or unimportant can be used for embedding, e.g. the specific order of items in a list (its [permutation](premutation.md)) can bear information as 
well as length of time delays in timed data, amount of noise in data etc. 

T1 stereotype.md ---------- 

# Stereotype 


Stereotypes are general statistical observations, mostly about groups of people (such as different [races](race.md)), that were discovered naturally (without rigorous [scientific] (science md) 
etort): Stereotypes are good because they tell us what we may expect from different kinds of people. „Of Course no One, maybe with the exception of blonde women, is so stupid as to think 
stereotypes apply 100% -- let us repeat they are STATISTICAL observations, they talk about probabilities. 


Some stereotypes are: 
{ WIP ~drummyfish } 


- [Americans](usa.md): 
- extremely stupid, primitive, close-minded, not knowing geography/history besides the US, think US is the center of the world 
- extremely fat, eat only fast food, have no real cuisine 
- shallow, obsessed with looks (white teeth etc.) 
- materialist, obsessed with money, hardcore [capitalists](capitalism.md), panic fear of anything resembling [communism](communism.md)/[socialism](socialism.md) 
- arrogant, rude, individualist, self-centere 
- eccentric, extroverted, loud behavior 
- violent, militant, imperialist, consent ty. invade other countries, everyone has a gun and shoots at everything including their own presidents 
- don't mind violence but are afraid of public nudity, get panic attacks when see a naked child or nipple on TV 
- solve things by brute force rather than by smartness 
- obsessed with working as much as possible and forcing others to do the same 
- want everything big 
- US south: slow, even more stupid, racist, rednecks, inbred, for slavery, for guns 
- Arabs: 
- terrorists, suicidal bombers 
- women are belly dancers 
- pedophiles, bigamists 
- dirty 
- Asians: 
- extremely smart 
- all look the same 
- polite 
- don't show emotion 
- work extremely hard 
- small penises 
- men of honor 
- collectivist, sacrifice themselves for society 
- there are too many of them, lives of the poor ones have no value, work safety of peasants is non existent 
- [black people](nigger.md): 
- unintelligent, stupid, uneducated, primitive, poor 
- physically fit, good at sports 
- good at music, especially rhythmic music and jazz 
- fathers leave their children 
- all look the same, similar to monkeys 
- have big dicks 
- criminals 
- love chicken and watermelon 
p in certain situations act like monkeys (so called chimp out), e.g. when excited they start jumping around like crazy, or when scared instinctively react by punching the perceived danger 
ustralians: 
- tough, living in dangerous wilderness 
- blond, attractive [women] (woman .md) : 
- extremely stupid 
- gold diggers 
Canadian: 
- extremely polite 
- ice hockey fans 
- Chinese: 
- smart, wise 
- do martial arts 
- make crappy off brands and cheap copies of western art, steal "intellectual property", manufacture cheap things at large quantities, everything is "made in China" 
- don't value human rights 
- Czech: 
- heavy drinkers, especially beer 
- friendly but appear cold 
- beautiful women 
- English: 
- well behaved, reserved, educated, classy 
- conservative, old fashioned 
- drink tea 
- dry humor 
- football fans 
- dislike French 
- bad cuisine 
- French: 
- good lovers 
- lazy, Bohemian life, hate work 
- eat baguettes and frogs 
- dislike Brits 
- revolutionaries, constantly protest 
- artists, intellectuals 
[gays] (gay md): . A 
- men act feminine, are good at art and women jobs 
- women (lesbian) are masculine, ugly with short pink hair 
- Germans: 
- no sense of [humor](fun.mf), being kind of robots 
- precise: efficient, organized, great technology 
- love beer and sausage 
- ugly women 
- gypsies: 
- don't work, steal stuff, wellfare leeches, make a_lot of children 
- children don't go to school, uneducated, can hardly read 
- passionate, emotional, friendly 
- talent for music 
- Indians: 
- extremely friendly, often too much 
no hygiene, dirty 
smart but poor 


3 good at [Enit md) but usually tech support scammers 
- Spiritual, peacefu meditate a lot 
- don't know what work safety means 


- transport extremely big loads on bicycles or small motorcycles 
- Italians: 
- handsome men who are passionate lovers 
- extremely passionate, have heated emotional arguments about even trivial things 
- involved with mafia 
- great focus on family, know and regularly meet distant relatives 
- have mustaches, eat pizza and pasta 
; talk with hands 
- Japanese: 
- like extremely weird things like actually living with sex dolls instead of human life partners 
- salarymen regularly jump out of skyscraper windows due to overworking depression 
- men talking Japanese to other men sound as if being aggressive to each other even if in fact being polite or talking something uninteresting 
- everyone reads manga and goes to karaoke after wor 
- extremely precise, always on time, well organized 
- have extremely technologically advanced toilets 
- commit seppuku when fail at something important 
- [jews](jew.md): 
- very smart, inventive 
- greedy 
- good at [business] (business.md) 
- have the "eagle nose" 
- members of secret societies, closed jew-only communities, conspire for world control, some being [fascists](fascism.md) wanting to become the ruling race 
- spread everywhere like rats 
- can adapt to any environment z 
- dọ all kinds of weird religious rituals 
- Polish: 
- very religious 
- heavy drinkers 
- Russians: 
- very tough, big and strong, endure conditions that would kill other people, keep pet bears 
- drunk (especially by vodka), aggressive, rude 
- wear Adidas pants 
- act straight without talking too much, ignore work safety 
- Slovak: 
- who? 
Spanish: 
- extroverted, passionate, dance flamenco 
- take naps on siesta 
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- attractive tanned men 
[women] (woman . md) : 
- bad at driving 
bad at logical thinking and [math](math.md) 
passive aggressive 
ossip 
on't know what they want, "no" can mean "yes" 
too emotional, especially on period 
attracted to douchebags and money, avoid nice guys 
can distinguish and nàme different shades of similar colors 
on board of a ship bring bad luck 
T steve jobs.md ---------- 
# Steve Jobs 


*"I'm not glad he'd dead, but I'm glad he's gone."* -- [Richard Stallman] (rmd.md) 


Steve Jobs was the prototypical evil [CEO] (ceo,md) and co-founder of one of, the worst [corporations {corporation md) in the world: 
cult of personality that makes Americans Cum. He was mainly known for his ability to manipulate peo 
already existing technology. 


AREKEA 


L apple.md). He was. a psychopathic entrepreneur, with.a 
e and he worsened technology by m L 


( : r : 
fe] more consumerist, expensive and incompatible with 


Jobs was. born on February.24, 1955 and later was agoptgd which may have contributed to his development of psyghopatby: He was already very stupid as a little child, he never, really learned 
programming and was only interested in achieving what he wanted by crying and pressuring other people to do hings for him. This translated very well to his adult tife when he quit school to 
pursue money: He manipulated and abused his schoolmate [Steve Wozniak] (wozniale md), a [hacker](hacker.md), to make computers for him. They started [Apple](apple.md) in 1976 and started producing 
one of the first personal computers: Apple I and Apple II with which he won the [capitalist](capitalism.md) lottery and unfortunately succeeded on the market. Apple became a big ass company, 
however Jobs was such [shit](shit.md) CEO that Tap le fired him** lol. He went to do some other shit like NeXT. Then a bunch of things happened (TODO) and then, to the relief of the whole 
world, he died on October 5, 2011 from cancer. ( L never wishes for anyone's death, here we only state the simple fact that the world is a better place without Jobs in it. ~drummyfish } 
l1 suckless.md ---------- 

# Suckless 


Suckless, software that sucks less, is a type of [free](free_software.md) [software](software.md), as well as an organization (http://suckless.org/), that tries to adhere to a high technological 
[minima lism] (minimalism md) freedom and I ackability] packing md), and Opposes so Called [bloat](bloat.md) and unnecessary complexity which has been creeping into most "[modern](modern.md) 
Software and by which technology has started to become less useful and more burdening. It is related to [Unix philosophy](unix_philosophy.md) and [KISS](kiss.md) but brings some new ideas onto 
the table. [LRS](lrs.md) builds on top of suckless ideas. 


The çommunity is relatively a small niche but has also seen a growth in popularity sometime in 2010s, thanks to tech youtubers such as [Luke Smith] (luke_smith.md) [Distro Tube] (distro_tube.md) 
and [Mental Outlaw](mental_outlaw.md). It has also gained traction on [achan] (acnen me 's technology board. While consisting a lot of expert programmers and [hackers] (hacker.md) mostly 
interested in systems like [GNU](gnu.md)/[Linux](linux.md), [BSDs](bsd.md) and [Plan 9](plan9.md), a lot of less skilled "[Linux](linux.md)" users and even complete non-programmers have started 
to use suckless to various degrees -- [dwm](dwm.md) has for example seen à great success among "Unix porn" lovers and chronic [ricers](ricing.md). While some members are hardcore minimalists and 
apply their principles to everything, some just cherry pick programs they find nice and integrate them in their otherwise bloated systems. 


Suckless is pretty cool p R a N O 
[raghtists | ( evf vs right.md) and [capitalists](ca| italism.md) who are motivated by [ 


it has inspired LRS, but watch out, as with most of the few romita arg nowadays it is half cool and half shitty -- for example most suckless followers seem to be 
RS fixes this, we only take the good ideas of suckless. 


armful](harmfül.md) goàls such as their own increased [productivity](productivity cult.md), not by altruism. 


{ From what it seems to me, the "official" suckless community is, largely quiet and closed, leading conversations mostly on mailing lists and focusing almost exclusive ly oñ the development of 
heir software without politics, activism and off topics, probably because they consider it bullshit that would only be distracting There is also suckless subreddit which is similarly mostly 
focused on the software alone. They let their work speak. Some accuse the community of being Nazis, however I believe this is firs ly irrelevant and secondly mostly false accusations of haters, 
even if we find a few Nazis among them, just as in any community. Most pro-suckless people I've met were actually true socialists (while Nazis are not socialist despite their name). Unlike 
[tranny software](tranny_software.md), suckless software itself doesn't promote any politics, it is a set of purely functional tools, so the question of the developers' private opinions is 
unimportant here. Suckless ideas are good regardless of whose brains they came from. ~drummyfish } 


## Attributes 


Notable attributes of suckless software include: 


Ci d). 
- **Extreme [minimalism](minimalism.md) and minimizing [dependencies](dependency.m , elimination of any [bullshit](büllshit.md) an eee Tb ioat md) **. Advocating [Unix philosophy] 
(unix_philosophy.md), [KISS](kiss.md) etc. 
- **Configuration of software is part of_its source code* = (config.h) and change of this configuration requires recompiling the software (which is extremely easy and fast with suckless 
software). This removes the need for dealing with config files which requires spécial libraries, file systems and extra code. 
- Mainly using two [pro ramming Languages] (programming language .md) : **[c](c.md)** (C89 or C99) for compiled programs and **[POSIX shell](posix shell.md)** for scripting. Some also use languages 
such as [go](go.md) or TÉSE isp.md), büt they're in minority. 
- meee or King | (fork. md) and [eon dling] (compiling .md) by default**, software is distributed in source format (no binaries), every user is supposed to create a personal customized fork and 
compile/customize the’ software himself. 
- Mods fextension/addons) are implemented and distributed as **[patch](patch.md) files**. The idea is to fork the base version of the software and then apply patches to make a unique, completely 
personalized version of the software. 
- **Typical upper limit for [lines of code](loc.md) of about 10k**, mostly just about 1-2k. This makes software easy to understand, modify, fork and maintain. 
- **Focus on the technology itself** without mixing it with [polities] (po itics.md) and other [bullshit](bs.md) such as [rocs | (coc ma): ^ . 
- Not aiming for mainstream popularity, being a bit of an **elite club**, in the good sense -- suckless is for expert usérs who understand, handle and create non-mainstream technology without 
handholding. Trying to be normie friendly would just lead to software and community that looks like the mainstream software and its community. { My view on this is that it's not that suckless 
WANTS to be an elitist club for its own sake; the issue lies in mainstream technology being hostile towards ethical software -- using ethical software nowadays requires one to be very tech 
savvy, hence it's not suckless who is discriminating but rather those who create mainstream technology. -drummyfish } 


- **Being [free intem] linins ism nd] and m with the preference of **permissive [jieenses (ricer se may such as [MTT] (mit md) and ceat cO.m 


## History 


Suckless in current form has existed since 2006 when the domain suckless.org was registered by a German guy Anselm R. Garbe who is the founder of the community. It has evolved from a community 
centered around specific software projects, most notably [wmii](wmii.md). Gàrbe has given interview about Suckless in FLOSS Weekly episode 355. 


Some time before 2010.suckless developed [Steli](stali.md), a statically linked [glibc] (qlibc.md)- less ["Linux distro" {distro.md) that was based on the idea that fynamic linking] 
(dynamic_linking.md) is [harmful](harmful.md) a that [static {fnking]{ static iking- ) is moStly advantageous. It so came with suckless software by default. This project wa$ made 
independent and split from suckless in 2018 by Garbe. 


In 2012 a core veteran member of suckless, a Spanish guy nicknamed [Uriel](uriel.md), has killed himself and became a [meme] (meme.md) . 
## Projects 
Notable projects developed by the suckless group include: 


dwm] ( dwm. md) 
st](st.md) 
surt isuria 


surf](surf.md) 
stali](stali.md) 


However there are many more ([IRC](irc.md) clients, file formats, presentation software, ...), check out their website. 
l2 sudoku.md ---------- 
# Sudoku 


Sudoku is a puzzle that's based on filling a grid with numbers that is hugely popular even amon Normie] (nopmie.md) such as grandmas and grandpas who find this stuff in magazines for elderly 
people. The goal is to fill in all squares of a 9x9 grid, prefilled with a few clue digits, wit igits 1 to 9 so that no digit repeats in any column, row and 3x3 subgrid. It is like a : 
crosswords puzzle for people who lack general knowledge, but it's also pretty [suckless](suckless.md), pure ogc based puzzle whose generation and solving can be relatively easily automatized 
(unlike generating crosswords which requires some big databases). The puzzle is a pretty [fun] (fun.md) singleplayer [game](game.md), posing opportunities for nice [mathematica L](math md) 
research and analysis as well as a comfy [programming](programming.md) exercise. Sudokus are a bit similar to [magic squares](magic square.md). There also exist many similar kinds of puzzles 
that work on the principle of filling a grid so as to satisfy certain rules given initial clues, many of these are implemented e.g. in [Simon Tatham's Portable Puzzle Collection](stppc.md). 


Curiously sudoku has its origins in agricultural designs in which people wanted to lay out fields of different pants in more or less uniform distributions for something like that, there are 
some papers about this from 1950s). The puzzle itself became popular in Japan in about 1980s and experienced a boom of popularity in the western world some time after 2000. 


The following is an example of a sudoku puzzle with only the initial clues given: 


The solution to the above is: 


ONO OAHU 
WRNOOTONE 
DRWNTINAOL 


POUINWN ADO 
lo -co is oo o to ei cn 
o toi ov o 
Q1(O 00 0-414 H QN 
icono ooo no 
REP 


We can see neither digit in the solution repeats in any column, row and any of the 9 marked 3x3 subgrids or, in other words, the digits 1 to 9 appear in each column, row and subgrid exactly 
once. These are basically the whole rules. 


**We generally want a sudoku puzzle to have initial clues such that there is exactly one possible (unique) solution.** For this sudoku has to have at, least 17 clues (this was proven bya 
computer). Why do we want this? Probably because in the puzzle world it is simply nice to have a unique sólution so that human solvers can check whether they got it right at the back page of the 
magazine. This constraint is also mathematically more interesting. 


**How many possible sudokus are there?** this depends on how we view the problem: .let's call one,sudoku one grid completely filled accor din to the rules of sudoku. Now if we Consider, all 
n e.g. e 


Well 
possible Such grids, there are 66/0903752021072936960 of them. However some o hese grids are "basically the same ecause we cal s and 5s in any grid and we get basically t 


same thing as digits are nothing more than symbols here. We can also e.g. flip the grid horizontally and it's basically the same. If Wwe take such things into account, there remain "only" 
5472730538 essentially different sudokus. 

Sudoku puzzles are sometimes assigned a difficulty rating that is based e.g. on the techniques required for its solving. 

Of course there exist variants of sudoku, e.g. with different grid sizes, extended to 3D, different constraints on placing the numbers etc. 

## Solving Sudoku 


There are two topics to address: solving sudoku by people and solving sudoku by computers. 
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Humans almost exclusively use logical reasoning techniques to solve sudoku, which include: 


- **scanning**: We take a look at some frequently appearing number in the grid and see which columns and rows they intersect which implies they cannot be placed in those columns and rows, 
possibly revealing the only possible location to place such number. 

- xxgingle remaining candidate**: When there is only one number left to fill in any column, row or subgrid, it is always clear which one it is and can be safely placed. 

- **candidate sets**: A more advanced technique in which we create sets of possible candidate numbers for each square on the grid.e.g. by writing tiny numbers in, the top corners of the squares. 
We then apply various reasoning to reduce those sets, i.e. remove candidate numbers, until a single candidate remains for a cértain Square in which case we can fill in that number with 
certainty. This will further help us reason about candidates in other squares. 

- **inference chains and cycles**: Very advanced techniques, described e.g. at http://zitowolf.net/sudoku/strategy.html. { TBH no idea what this is. ~drummyfish } 


For computers the traditional 9x9 sudoku is nowadays pretty easy to solve, however solving an NxN sudoku is an [NP complete](np complete.md) problem, i.e. there most likely doesn't exist a 
"fast" algorithm for solving a generalized NxN sudoku, even though the common 9x9 variant can still be solved pretty quickly wrth today. S computers by using some kind of "Smart" [brute force] 
(brute force.md), for example [ acktracking](backtracking.md) (or another state tree search) which [recursively](recursion.md) tries all possibilities and at any violation of the rules gets one 
Step back to change the previous number. Besides this a computer can of course use all the reasoning techniques that humans use such as creating sets of possible values for each square and 


reducing those sets until only one possibility stays. The approach of reasoning and brute forcing may also be combined: first apply the former and when stuck fall back to the latter. 
## Generating Sudoku 

{ I haven't personally tested these methods yet, I'm just writing what I've read on some web pages and ideas that come to my mind. ~drummyfish } 

Generating sudoku puzzles is non-trivial. There are potentially many different [algorithms](algorithm.md) to do it, here we just foreshadow some common simple approaches. 

Firstly we need to have implemented basic code for checking the validity of a grid and also some automatic solver, e.g. based on [backtracking](backtracking.md). 


For generating a sudoku we usually start with a completely filled grid and keen. removing numbers to leave only a few ones that become, the initial clues, For this. we have to know how to generate 
the Solved grids Dumb [brute force] Brute force md) (i.e. generating completely random grids and testing their validity) won't work here as the probability of finding a valid grid this way is 
astronomically low (seems around 10^(-56)). What may work is to randomly fill a few squares so that they don't break the rules and then apply our solver to fill in the rest of the squares. Yet a 
simpler way may be to have a database of a few hand-made grids, then we pick on of them and apply some transformations that keep the validity of the grad which include swapping any two columns, 
swapping any two rows, [tansposing](transposition.md), flipping the grid, rotating it 90 degrees or swapping any two digits (e.g. swap all 7S with all 9s). 


With having a completely filled grid generating a non-unique (more than one solution) sudoku puzzle is trivial -- just take some completely filled grid and remove a few numbers. But as stated, 
we usually don't want nón-unique sudokus. 


For a unique solution sudoku we have to check there still exists exactly one solution after removing any numbers from the grid, for which we can again use our solver. Of course we should 
[optimize](Optimization md) this process by quitting the check after finding more than one solution, we don't need to know the exact count of the Solutions, only whether it differs from one. 


The matter of generating sudokus is further complicated by taking into account the difficulty rating of the puzzle. 
Lll suicide.md ---------- 

# Suicide 

{ I hate disclaimers but I'm.not advising you. to commit fucking suicide, OK? I mean it's an.option and sometimes it's the best option, but I want you to live if it's at least a little possible 
-- remember, LRS loves all life and all life is precious. We will all die, no need to rush it. Also if you're feeling like shit you can send me a mail, we can talk. -drummyfish } 


Suicide is when someone, voluntarily kills himself, Suicide offers an. immediate escape, from [capitalism](capitalism.md) and.is therefore a kind.of last-resort hope; it is one of the last 
remaining freedoms in this world, even though capitalists can't profit from dead people and so are working hard on préventing people from killing themselves (rather than trying to make them NOT 
WANT TO kill themselves of course). 

T sw.md ---------- 

# Software 


Software (SW) are programs that run on a_computer, i.e. its non-physical parts (as opposed to [hardware](hw.md)); for example an [operating system](os.md), the internet [browser](browser.md) 
etc. Softwaré is created by [programming](programming.md). 


Usually we can pretty clearly say what is software and what is hardware, but there are cases where it's debatable. Normally software is that about the computer which *can relatively easily be 
changed* (i.e. reinstalled by a yping a few commands or clicking a few buttons) while hardware is *hard-wired*, difficult to modify, and not expected or designed to be modified. Neverthele 
e.g. some [firmware | (Firmware md) is kind of software in form of instructions which is however many, times installed in some special kind of memory that's difficult to reprogram and not expected 
to be reprogrammed often -- some software may be "burned in" into a circuit so that it could only be changed by physicall rewiring the circuit (the ME spyware in [Inte] (intel, md) [CPU] 
cpu.md)s has a built-in [minix](minix.md) operating system). And this is where it may sometimes be difficult to decide where the line is drawn. This issue is encountered e.g. by the [FSF] 
fsf.md) which certifies some hardware that works with free software as "Respects Your Privacy" (RYF), and they have very specific definition what to them classifies software. 

T sw rendering.md ---------- 

# Software Rendering 


Sofware (SW) rendering refers to renderingl(rendering.md) Computer gra| bigs] (graphics md) without the help of raphics card (gpu md) (GPU); i.e. computing images only with, [CPU](cpu.md). This 
mostly means rendering [3D](3d.md graphics but can also refer to other kinds of graphics Such as drawing [fonts troht-md or [video](video.md). Before GPUs were invented, all rendering was done 
in software, of course -- games such as Quake] (quake md) or Thief were designed with SW rendering and only added optional GPU acceleration later. SW rendering for traditional 3D graphics is 
also called software [rasterization](rasterization.md), às rasterization is the basis of current real-time 3D graphics. 


SW rendering has advantages and disadvantages, though from our point of view its advantages prevail (at least given only capitalist GPUs exist nowadays). Firstly it is **much slower** than GPU 


graphics -- GPUs are designed to perform graphics-specific Operations very quickly and, more importantly, they can process many pixels (and other elements) in [parallel](parallelism.md), while a 
PU has to compute pixels sequentially one by one and that in addition to all other computations it is otherwise performing. This causes a much lower [FPS](fps.md) in SW rendering. For this 
reasons SW rendering is also normally of **lower quality** (lower resolution, [nearest neighbour](nn.md) texture filtering, ...) to allow workable FPS. Nevertheless thanks to the ginormous 


speeds of today's CPUs simple fullscreen SW rendering can be pretty fast on PCs and achieve even above 60 FPS; on slower CPUs (typically [embedded](embedded.md)) SW rendering is usable normally 
at around 30 FPS if resolutions are kept small. 


On the other hand SW rendering is more [portable] (portability md) {as it can be written purely in a portable language such as [£1 (e. mdp), less [bloated](bloat.md) and **eliminates the : 
[dependency] (dependency md) on GPU** so it will bé Supported almost anywhere as every computer has a CPU, while not all computers (such as [embédded](embedded.md) devices) have a GPU (or, if 
hey have it, it may not be sufficient, supported or have a required [driver](driver.md)). SW rendering may also be implemented in a simpler way and it may be easier to deal with as there is 
e.g. no need to write [shaders](shader.md) in a special language, manage transfer of data between CPU and GPU or deal with parallel programming. SW rendering is the [KISS](kiss.md) approach. 


SW rendering may.also utilize a much wider variety of rendering techniques than only,3D [rasterization (ragterizgtion.md) traditionally used with LOBUS] (gpu. md) and their [APIs](api.md), thanks 
to not being limited by hard-wired pipelines, i.e. it is more flexible. This may include [splatting](splatting.md), [raytracing](raytracing.md) or [BSP réndering](bsp.md) (and many other 
["pseudo 3D"](pseudo3d.md) techniques). 

A lot of .software and.rendering frameworks offer both options: accelerated renderin using GPU and SW rendering as a,[fallback](fallback.md) (in case the first option is not possible). Sometimes 
there exists a rendering [APT] Papi md} that has both an accelerated and software implemen ation (e.g. [finyol | etinygl-md) for penGL](opengl.md)). 


For simpler and even somewhat more complex graphics japurely software rendering is mostly the best choice**. LRSJ(Ursamd) suggests you prefer this kind of rendering for its simplicity and 
portability, at least as one possible option. On devices with lower resolution not many pixels need to be computed so SW fendéring can actually be pretty fast despite low specs, and on "big" 
computers there is nowadays usually an extremely fast CPU available that can handle comfortable FPS at higher resolutions. There is a LRS software renderer you can use: [small3dlib](s3l.md). 


SW renderers are also written for the purpose of verifying rendering hardware, i.e. as a [reference implementation](reference implementation.md). 


Note that SW rendering doesn't mean our program is never touching [GPU] (gpu; md) at all, in fact most personal, computers nowadays **require** some kind of GPU to even display anything. SW 
rendering only means that computation of thé image to be displayéd doesn use'any hardware specialized for this purpose. 


Some SW renderers make use of, specialized CPU instructions such as [po] (mmx md) which can make SW rendering faster thanks to handling multiple data in a single step. This is kind of a mid way: 
it is not using a GPU per se but only a mild form of hardware accelératión. The speed won't reach that of a` GPU but will outperform a "pure" SW renderer. Howéver the disadvantage of a hardware 
dependency is Still present: the CPU has to support the MMX instruction set. Good renderers only use these instructions optionally and fall back to general implementation in case MMX is not 
supported. 


## Programming A Software Rasterizer 
{ In case [small3dlib](small3dlib.md) is somehow not enough for you :) -drummyfish } 


Difficulty of this task depends on. features you want -- a super simple [flat shaded] (flat_shading md) (no textures, no smooth shading] (shading .md) renderer is relatively gasy to make 
especially if you don't need movable camera, can afford to use [floating point Jtr lo .md) etc. Sée the' details of [3D renderin ec ering.md), especially how the GPU pipelines work, and try 
to imitate them in software. The core of these renderers is the **[triangle](triangle.md [rasterazation](rastericütion md) algorithm which, if you want, can be very simple -- even a naive one 
will give workable results -- or pretty complex and advanced, using various optimizations and things such as the [top-left rule](top left rule.md) to guarantee no holes and overlaps of 
triangles. Remember this function will likely be the performance [bottleneck](bottleneck.md) of your renderer so you want to put effort into [optimizing](optimization.md) it to achieve good 

[EPS T fps md) Once you have triangle rasterization, you can draw 3D models which consist of vertices f oints in 3D space) and triangles between these vertices (it's very simple to load simple 
3D models e.g. from the [953] (obj ma) format) -- you Simply project (using [perspective] (perspective.m 55 3D position of each vertex to screen coordinates and draw triangles between these pixels 
with the rasterization algorithm. Here you need to also solv visibility](visibility.md), i.e. possible overlap of triangles on the screen and correctly drawing those nearer the view in front 
of those that are further away -- a very simple solution is a [z buffer](z buffer.md), but to save memory you can also HAE [sort](sorting.md) the triangles br istance and draw them back-to- 
front CIpainter"s algorithm] painters a gori hm.md)). You may add a [scene](scene.md) data structure that can hold multip e models to be rendered. If you additionally want to have movable camera 
and models that can be transformed (moved, rotated, scaled, ...), you will additionally need to look into some [linear a gebra](Vinear-algepra.md) and [transform matrices (transform marrix.md) 
that allow to efficiently compute positions of vertices of a transformed model against a transformed camera -- you do this the same way as basically all other 3D engines ook up eg some 
OpenGL](opengl.md) tutorials, see model/view/projection [matrices](matrix.md) etc.). If you also want texturing, the matters get again a bit more complicated, you need to compute [ arycentrie] 
barycentric.md) coordinates (special coordinates within à triangle) as you're rasterizing the triangle, and possibly apply [perspective correction](perspective_correction.md) (otherwise you'l 
be seeing distortions). You then map the barycentrics of each rasterized pixel to [UV](uv.md) (texturing) coordinates which you use to retrieve specific pixels from a texture. On top of all this 
ou may start adding all the advanced features of typical engines such as [acceleration structures](acceleration_structure.md) that for example discard models that are completely out of view, 
loot od.mf), instancing, [MIP maps](mip map.md) and so on. 


Possible tricks, cheats and [optimizations](optimization.md) you may utilize include: 


: Using painter s algorithm (sorting triangles and drawing back to front) instead of z-buffer if you need to save a lot of RAM. But remember sorting doesn't work perfectly, glitches will 
inevitably appear, and you will probably gain overdraw penalty 

- Ad previous point: you don't have to, perform whole triangle sorting each frame if you need to save speed, it may be good enough to perform a constant continuous sorting by performing only a 
few iterations of somé sorting algorithm per frame. 

- You may lower the quality of far-away objects in many ways, e.g. with [LoD] (1od md) only_using affine texturing for them (as opposed to perspective-correct one) or even just using a constant 
color (average color of the texture), maybe even just drawing 2D sprites instead of 3b models eté. This may help à lot. 

- Generally use cheap [approximations (approximation.md) such as Gouraud] (gouraud md) (per-vertex) [shading](shading.md) instead of [Phong] (Phong: md) (per pixel), nearest neighbour texture 
Farben only approximate perspective correction (every N pixels), simplified handling of near-pláné culling (e.g. just pushing the vertices in front of camera instead of actually culling a 
triangle) etc. 
- Use general [optimization](optimization.md) techniques: e.g. using power of two resolution for textures, fixed screen resolution that's known at compile time or inlining of your shader 
function will probably help performance. 

- TODO: MORE 


## Specific Renderers 


These are some notable software renderers: 


**[BRender](brender.md)**: Old commercial renderer used in games such as Carmageddon, Croc or Harry Potter 1. Later made [FOSS ](foss.md) < 
- **[Dark Engine](dark_engine.md)**: Old proprietary game engine which includes à SW renderer, used mainly in the game Thief. The author writes about it at 
http$://nothings.órg/gamedev/thiéf rendering.html. 
- **[id Tech] (id tech.md)**: Multiple engines by [Id sgftware] (id.md) {tater made [FOSS](foss.md)) used for games like [Quake](quake.md) included a software renderer. Quake's SW renderer was 
partially described in the *Michael AbraSh's Graphics Programming Black Book’. 
- Became Merce [Foss] (foss md) game engine including a software renderer as one of its [backends](backend.md). 


- zee en phe] (build. engine md) * While not a "true 3D", this was a very popular [proprietary](proprietary.md) portal-rendering engine for older games like Duke Nukem 3D or Blood. 
DI 


ae Besa (meee i Fes C oss.md) implementation of [OpenGL](opengl.md) that includes a software rasterizer. 
**[small3dlib](small3dlib.md)**: [LRS](lrs.md) [C](c.md r 

**SSRE**: The guy who wrote [LIL](lil.md) also made this renderer named Shi 
**[System Shoc J{system_shoc .md) engine**: Old proprietary game engine. 
**[TinyGL](tinygl.md)**: Implements à subset of fo engl | (opengl md) « 

Many old |games](game.md) in the 90s implemented their own software renderers, so you can look there. 


3D rasterizer, yery sump e 


le. 
* y Software Rendering Engine, accessible [here](http://runtimeterror.com/tech/ssre/). 


## See Also 


- [3D rendering] (3d_rendering.md) 
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- [pseudo/primitive 3D, 2.5D](pseudo3d.md) 
T1 systemd.md ---------- 
# Systemd 


Systemd, also shitstemd, is a horribly disastrous [bloated](bloat.md), [apti-Unix](unix- phi logopb .md), " FOSS](foss.md)" "software suite" used for initialization of an operating system](os.md) 
and pand ling services like log ging in or managing network connections. It is a sd called [PID Ttptd .mdj process. Systemd has been highly criticised by the proponents of [suckl se} 
(suckless.m l and tis] irs ndi and even normies for its enormous amount of bloat, ugliness, anti-Unix-philosophy design, [feature creep](feature creep.md), security vulnerabilities and other 
stuff. Unfortunately it is being adopted by many [GNU](gnu.md)/[Linux](linux.md) distributions including [Arch Linux](arch.md) and [Debian](debian.md). Some distros such as [Devuan](devuan.md) 


just said no to this shit and forked to a non-systemd version. 
Systemd was born when Harry Pot... ummm [Lennart Poettering](pottering.md) had [gay](gay.md) sex with [Kay Sievers](sievers.md). 


For more detailed bashing, of systemd see e.g. https://nosystemd.org/. The site sums up systemd with a fitting guote: *"If this is the solution, I want my problem back*". Another sum up by 
[suckless](suckless.md): http:/7/suckless.org/suckS/systemd/. There is also e.g. https://sysdfree.wordpress.com/. 


Tool assisted speedrun (TAS, also more generally *tool assisted superplay*) is a category of ame](game.md) [speedruns](speedrun.md) in which help of any tools is allowed, even those that would 
otherwise be considered [cheating](cheating.md), e.g. scripts, savestates, [aimbots](aimbot.m j or time manipulation, however NOT thóse that alter the game itself. This makes it possible to 
create flawless, perfect or near-perfect runs which can serve as a theoretical upper limit for what is achievable by humans -- and of course TAS runs are pretty [fun](fun.md) to watch. The 
normal, non-TAS runs are called RTA (real time attack). For example the current (2022) RTA world record of Super Mario Bros is 4.58.881 while the TAS record is 4.41.27. 


f,Watching a TAS is kind of like watching the God] (god. md) lay the game. I personally like to watch Trackmania TASes, some are really unbelievable. Elastomania TASes are also pretty fucked up. 
lso note that [SAF](saf.md) games have TAS support. -drummyfish } 


There is a website with videos of game TASes: https://tasvideos.org/. 


TAS does NOT allow hacking the gane in other ways than what's possible to achieve þy simply playing the game, i.e. it is not possible to hex edit the game's code before running it or manipulate 
its RAM content at run time with external tools. However note that some games are buggy and allow things such as altering their RAM content or code by merely playing the game erg. Pokemon 
Yellow allows so called arbitrary code execution), which generally IS allowed. The goal of TAS is merely to find, as best as we can, the series of game inputs that will lead to completing the 
game as fast as possible. For this the game pretty much needs to be [deterministic](determinism.md), i.e. the same sequence of inputs must always reproduce the same run when replayed later. 


TAS runs coexist alongside RTA (non-TAS) runs as.separate categories that are beneficial to each other: RTA runners come up with Speedrunning techniques that, TAS programmers can perfectly 
execute and vice versa, TAS runners many times discover new techniques and ideas for RTA runners (for example the insane discovery of groundbreaking noseboost when TAS was introduced to 
Trackmania). In fact RTA and TAS runners are many times the very same people. Of course if you submit a TAS run in RTA category, you'll be seen as a cheater. 


Creating a TAS is not an easy task, it requires great. knowledge of the game (many times including.its code) and its speedrunning, as well as a lot of patience, and often collaboration with other 
TASers. TASes are made *offline* (not in real time), i.e. hours of work are required to program minutes or’ even seconds of the actual run. Many paths heed to be planned and checked. Compared to 
RTAs, the focus switches from mechanical skills towards skillful mathematical analysis and planning. Besides this some technological prerequisites are necessary: the actual tools to assist with 
creation of the TAS. For many new [proprietary](proprietary.md) games it is extremely difficult to develop the necessary tools as their source code isn't available, their assembly is obscured 
and littered with "anti-cheating" malware. Many "[modern](modern.md)" (even [FOSS] (foss md)) games are additionally badly programmed and e.g. lacking a [deterministic (determinism.md) physics, 
which makes precise TASing almost impossible (as the traditional precise crafting of inputs requires deterministic behavior). The situation is better with old games that are played in 
[emulators](emulator.md) such as [DOS](dos.md) games ( [Doom] (doom. md) etc.) or games for consoles like [GameBoy](gameboy.md) -- [emulators](emulator.md) can give us a complete control over the 
environment, they allow to save and load the whole emulator state at any instant, we may slow the time down arbitrarily, rewind and script the inputs however we wish (an advanced technique 
includes e.g. [bruteforcing](brute force.md): exhaustively checking all possible combinations of inputs over the following few frames to see which one produces the best time save). In games that 
don't have TAS tools people at least try to do the next best thing with segmented speedruns. 


There also 


S ists a term *tool assisted superplay* which is the.same principle as TAS but basically with the intention of just flexing, without the goal of finishing the game fast (e.g. playing 
a [Doom](doom.md) lev t 


el against hundreds of enemies without taking a single hit). 


Some idiots are against TASes for, various reasons, mostly out of fear that TASers will use the tools to [SHEAAAAAAAT cheating.md) in RTAs or that TASes will make the human_runners obsolete etc. 
That's all bullshit of course, it's like being against computers out of fear they would make human calcutators obsolete. Furthermore TASes always coexist perfectly peacefully with RTA runs as 
can e.g. be seen in the case of FTPackmania](trackmania md) -- in 2021 TAS tools started to appear for Trackmania and many people feared it would kill the game's competition, however after the 
release of the tools no such disaster happened, TAS became hugely popular and now everyone loves it, human competition happily continues lus the development of the tools actually helped 
uncover many cheaters among the top players (especially Riolu who was forced to leave the scene, this caused a nice drama in the Community). 


We could even go as far as to say that morally TAS is the superior way of speedrunning as it puts humans in the role or thinkers rather.than treating them as wannabe machines who_waste. enormous 
amounts of timé on grinding real time runs with arbitrary obstacles (such as requiring a run to not be spliced etc.), which a real machine can simply do instantly and perfectly. There is really 
no point in someone spending 10000 hours of life on getting lucky ani 

T tattoo.md ---------- 

# Tattoo 


nailing a series of frame perfect keypresses when à computer can do this in 1 second. 


Tattoo is a body disfigurement formed by injecting ink under ,the.skin.to permanently mark it. Tattoo, similarly to Pigrcing](piercing md 
(e oasm-md narcissi | (narcissism md), hérd mentality, [identity] (iden ity_politics.md) crisis, overconfidence of the incompetent and 
ake oneself look interesting. We highly advise to distance oneself from anyone having a voluntarily made tattoo. 


T tech.md ---------- 


; Suits, dyed hair etc., is,a sign of, [egoi: 


sm 
à cheap attempt at desperately trying to get tention or 


a short for [technolog 
- -- technology.md ----- 
& Technology 


(technology.md). 


Technology (from Greek tekhnologia, systematic treatment of art", also just "tech") encompasses tools and knowledge of making.such tools invented and achieved mainly with the help of 13eignee] 
(science.md) and by long systematic effort. This includes everything from [stone toóls](rock.md) to space rockets and [artificial intelligence](ai.md). On the Internet, as well as on this Wiki, 
this term is often used with the focus on [computer](computer.md) technology, i.e. [har ware] (hardware md) and [software](software.md), as this is the kind of technology that is being discussed 
and developed the most in our days. Technology, like fire, should serve us, but can also be dangerous and often gets misused and abused. 

Ill ted kaczynski.md ---------- 

& Ted Kaczynski 


*"The Industrial Revolution and its consequences have been a disaster for the human race."* --Ted Kaczynski 


Ted Kaczynski, known as, *Unabomber*, is an imprisoned American [mathematician] (math mq) who lived a simple life in the nature, warned of the.dangers of advanced technology and killed several 
people by maiting them bombs in order to bring attention to his manifesto that famously starts with the words "The Industrial’ Revolution and its Consequences have been a disaster for the human 
race". Besides being one of the most famous mass murderers he is very well known in the tech community. 


S born on May, 22 1942 in Chicago. As a. kid he was very shy. He was also extremely smart ({1Q] ig. qd) measured at 167), skipped a few grades, graduated from Harvard at 20 years old and got 
a [PhD](phd.md) at 25 at the University of Michigan. Then he became a professor at the University alifornia, until his resignation in 1969. 


Fun fact: at one point he considered a gender change surgery. 


In 1971 he moved to a remote cabin in the woods in Montana, where he lived in a primitive way, with no electricity or running water. He grew more and more disenchanted with the society, especially 
with its technology and how it's enslaving and destroying humanity. The last straw may have been the moment when a road wa$ built nearby his cabin, in the middle of the nature he loved. 


He started sending hand-made bombs to various.universities and, airports (hence the nickname *Unabomber*, *university and airline bomber*). He managed to kill 3 people and injured dozens of 
others. He was arrested on April 3, 1996 in his cabin. He got life imprisonment in court. 


## Manifesto 
The manifesto is named *Industrial Society and Its Future*. In it he refers to his movement as a *Freedom Club* (FC). Let's start by summarizing it: 
{ The following is a sum up according to how I personally understood it, there's most likely subjective bias but I did my best. -drummyfish } 


First he bashes "leftists" ,gnalyses their psychology and.says they are, kind of degenerate sheeple, characterized by low self esteem inventing bullshit artificial, issues (such.as the issue of 
[political correctness] (politica _correctness.md)), Sometimes using violence. He also criticizes conservatives for pupporting technological anü economical growth which in his view inevitably 
rings on shift in societal values and said degeneracy. The usual societal issues are presented such as bad mental health, cople being slaves to the system, feeling powerless, having no 
security, no autonomy etc. The cause of unhappiness and other human issues is identified as people not being able to fulfill what he sees as a necessity for fulfilling life, so called *power 
process the process of considerable struggle towards a *real* goal that can be achieved such as obtaining food by hunting -- he argues nowadays it's "too easy" to satisfy these basic needs 
and people invent artificial "surrogate" activities (such as sports, activism and even science) to do to try to fulfill the power process, however he sees these artificial activities as harmful, 
not *real* goals. It is mentioned we only have freedom in unimportant aspects of life, the system controls and regulates everything, brainwashes people etc. He defines real freedom as the 
opportunity to go through the power process naturally and being in control of one's circumstances. It is talked a lot about modification of humans themselves, either by advanced psychological 
means (propaganda), drugs or genetic modification which is seen as a future danger. A number of principles by which society works is outlined and it is concluded that the industrial Society 
can't be reformed, a revolution is needed (not necessarily violent). Ted argues the system needs to be destroyed, we have to get back to the nature, and for this revolution he outlines a plan 
and certain recommendations {creation of ideology for intellectuals and common folk, the necessity of the revolution being world-wide etc.). He ends with again bashing "leftism" and warns they 
must never be collaborated with. 


Now Let us leave a few comments on the manifesto. Firstly we have to say the text is easy to read, well thought through and Ted makes some great points, many of which we completely agree; this 
includes the overall notion of technology having had mos w negative effects on recent society, the pessimistic view of our future and the Criticism of "harmful modern bullshit" such as 
political correctness. He analyzes and identifies some problems in society very well (ex: the propaganda that's so advanced that even its creators aren't usually consciously aware they're 
creating propaganda, his analysis of the inner working of the system is spot on). Nevertheless we also **disagree on many points**. Firstly we use different terminology; people who Ted calls 
*leftist* and whom he accuses of degeneracy and harmfulness we Call [pseudoleftists](pseudoleft.md), we believe in a truly leftist society (i.e. nonviolent, altruistic, non censoring: Loving 
without fascist tendencies). **We disagree on Ted's fundamental assumption** that people can't change, i.e. that people care primitive animals that need to live primitive lives (go through the 
power process by pursuing *real* goats such as obtaining food by hunting) in order to be happy (we are not against primitivism but we support it for other reasons). We believe society can become 
adult, just like an individual, if it is raised properly (i.e. with effort) and that the primitive side of a human can be overshadowed by the the intellectual side and that activities he calls 
*surrogate* (and considers undesirable) can be fulfilling. We think that in a sane, adult society **advanced technology can be helpful** and compatible with happy, fulfilling lives of people, 
even if the current situation is anything but. And of coürse, we are completely nonviolent and disagree with murdering people for any reason such as bringing attention to a manifesto. 


LIII teletext.md ---------- 
# Teletext 


Teletext is now pretty much obsolete technology that allowed broadcasting extremely simple read “only text/graphical pages along with TV signal so that people could browse them on their [TVs] 
(tv.md). It was used mostly in the 70s, 80s and 90s but with [world wide web](www.ind) teletext pretty much died. 


{ Just checked on my TV and it still works in 2022 here. For me teletext was something I could pretend was "the internet" when I was little and when, we didn't have internet at, home yet, it was 
very cool. Back then it took a while to load any page but I could read some basic news or even browse graphical logos for cell phones. Nowadays TVs have buffers and have all the pages loaded at 
any time so the browsing is instantaneous. ~drummyfish } 


The principal difference against the [Internet ] (internet md) was that teletext was [Broadcast] broadcast.md), i.e. it was a one-way communication. Users couldn't send back any data or even 

request any page, they could only wait and catch the pages that were broadcast by TV stations (this had advantages though, $9; it couldn't be [posed] (ados -md)) « Each station would have its own 
teletext wit ewer than 1000 pages -- the user would write a three place number of the page hé wanted to load ("catch") and the TV would wait until that page was broadcast (this might have been 
around 30 seconds at most), then it would be displayed. The data about the pages were embedded into unused parts of the TV signal. 


Qe pages al towed fixed-width text and some very blocky graphics, both could be colored with very few basic colors. It looked like something you render in a very primitive [terminal] 
erminal.md). 


## See Also 


- [world broadcast](world broadcast.md) 
T1 temple os.md ---------- 
# Temple OS 


Temple OS is a funny [operating system](os.md) made by a schizophrenic guy [Terry Davis (terry davis md) who, has become a [meme](meme.md) and achieved legendary status.for this creation in the 
anternet teen Circles as it's éxtfemely impre$sive that a single person creates Such a complex OS and also the OS features and the whole'context of its creation are quite funny. It has a website 
at https://templeos.org. 


according to_Terry, God commanded him to write TempleOS and guided him in the development: for example it was demanded that the resolution be 640x480. It is written in [HolyC](holy_c.md), 
Terry's Own language. The OS comes with GUI, 2D and 3D library, [games](game.md) and even a program for communicating with God. 
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Notable Temple OS features and programs are: 


- [multitasking] (multitasking md) (non-preemptive) 

- supported [file systems](file system.md): [FAT32](fat32.md), ISO9660, RedSea (custom) 
- HolyC compiler 

- 2D/3D library 

- oracle (communcate with God) 
- pesg 


game.md) 
IDE] (i 


e.md) supporting images and 3D models embedded in text 


In his video blogs Terry talked about how technology became spoiled and that TempleOS is supposed to be [simple](minimalism.md) and [fun](fun.md). For this and other reasons the OS is limited in 
many way, for exàmple: 


no networking 
Only runs on 184] (x64 md) : ; 

Only runs in 640x480 16 color display mode. 

single audio voice 

ring-0 only 

single address space . A 

multitasking is non-preemptive (programs have to yield CPU themselves) 


Temple OS source code has over 100000 [LOC] ( log.md) « .It is publicly available and said to be in the, [pubtic domain](public_domain.md), however there is no actual [license](license.md)/waiver in 
the repository besides some lines such as 00% public domain" which are legally questionable and likely ineffective (see [licensing](license.md)). 


T tensor product.md ---------- 
# Tensor Product 


TODO 


*a (x) b = [a0 * bO, a0 * b1, a0 * b2, ... al * bO, al * bi, ... an * bO, an * bi, ...]* 
T terry davis.md ---------- 
# Terry Davis 


*"An idiot admires complexity, a genius admires simplicity"* --Terry Davis 


Terry A. Davis, aka the *divine intellect*, born 1969 in Wisconsin, was a genius*[schizophrenic](schizo.md) [programmer ] (programming md) that singlehandedly created [TempleOS](temple os.md) in 
his own [programming Language] (programming_language.md) called Holyc (holyc.md), and great ly entertained and enlightened an audience of followers until his tragic untimely death. For his 
rogramming skills and quality videos he became a legend and a [meme](meme.md) in the tech circles, especially on fachan] (chan org) which additionally valued his [autistic](autism.md) and 
Epo itically incorrect](political_correctness.md) behavior. 


He was convinced he could talk to God and, that God commanded him to make an operating system with certain parameters such as 640x480 resolution, also known as the God resolution. According to 
himself he was gifted a *divine intellect* and was, in his own words, the "best pre Fammer that ever lived". Terry was making [YouTube] (youtube.md) talicing/progranming videos in which God was an 
often discussed topic, alongside valuable programming advice and a bit of good old racism](racism.md). He was also convinced that the government was after him and often delved into the 
conspiracies against him famously proclaiming that **"CIA [niggers | (nigger md) glow in the dark"** ("glowing in dark" subsequently caught on as a phrase used for anything [suspicious](sus.md)). 
He was in mental hospital several times and later became homeless ut continued to post videos from his van. An entertaining fact is also that he fell in love with a famous female physics 
YouTuber Dianna Cowern which he stalked online. In 2018 he was killed by a train (officially a [suicide](suicide.md) but word has it CIA was involved) but he left behind tons of videos full of 
endless entertainment, and sometimes even genuine [wisdom](wisdom.md). 


Terry, just as [us](lrs,md), greatly valued simplicity] (minimalism, md) and [fun] (fyn. md) in programming, he was a. low-level programmer and saw that technology went to ghity(shit .md) and wanted 
to create something in the’ oldschool style, e expressed his will to dedicaté his création to the [pub tic domain](public_domain.md). This is of course extremely baséd and appreciated by [us] 
(lrs.md) (though the actual public domain dedication wasn't executed according to our recommendations). 


T throwaway script.md ---------- 
# Throw Away Script 


Throw away script is a script, for one-time job.which you "throw away" after its use. Such,scripts, may be ugly] (ugly md), badly written and don't have to follow [LRS](lrs.md) principles as their 
sole purpose is to quickly achieve something without any ambition to be good, future-proof, readable, reusable etc. 


For example if you have a.database in some old format and want to convert it to a new format, you write a throw away script to do the conversion, or when you're mocking an idea for a [game] 
(game md), you write a quick throw away prototype in JavaScript to just test how the gameplay would feel. 


For throw aways cripts it is acceptable and often preferrable to use languages otherwise considered bad such as [Python](python.md) or [JavaScript](javascript.md). 


T1 tom scott.md ---------- 
# Tom Scott 


TODO 


LOL this, idiot tries to take some kind of ownership of ideas in a video called, *14.science fiction stories in. under. 
have to have his permission for commercial use, even though it's probably not legally possible to own ideas like thi 


T toxic.md ---------- 
& Toxicity 


6 minutes* figel:ffvtam), he just comes up with story ideas and says people 
s. Fucking faScist. Do hot support. 


A social environment is said to be toxic if it induces 
include a [capitalist](capitalism.md) society and [SJW](sjw.md 
T tranny software.md ---------- 

# Tranny Software 


a high psychological discomfort, toxic individuals are members of such environment that help establish it. Examples of toxic environments 
Social networks. 


Tranny software is a harmful [software] (software. md) developed within and infected by the culture of the toxic LGBTFJJJGIIQWWQW SJW [gsgudoteftists (pseugoteft-md), reatly characterized e.g. by 
codes of conduct](coc.md) and excluding straight white males from the development ih the name of inclusivity. Such software is retarded. It is practically always à high level of [bloat] 
bloat.md) with features such as [censorship](censorship.md), bugs and [spyware](spyware.md). 


To be clear, *tranny software* does NOT stand for *software written by transsexuals*, it stands for a specific kind of software infected by [fascism](fascism.md) (in its features, development 
practices, culture, goals etc.) which revolves around things such as Sexual identity. Of course with good technology it doesn't matter by whom it is made. 


Some characteristics of tranny software are: 


- **It is typically FOSS](fosg.md)*? because a big part_of trannyism in software is the development process and interaction with public (and with [proprietary] (proprietary md) software the 
development is not open t ublic). In theory we mày call a proprietary software *tranny* if it e.g. very aggressively promote some [SJW](sjw.md) bullshit -- 1 act most Compánies are nowadays 
infected by [sawism}(sjw.md) -- but it's not so common to use this term for proprietary software. 
- **Typically has a [code of conduct](coc.md)** or some equivalent "SJW guideline" (excluding the anti-COCs). 
- Sometimes promotes SJW fascism in other ways, e.g. [LGBT](lgbt.md) flags etc. : . J AT. 
- **It is typically [b'gatl(bloat,md) and [capitalist software](capitalist software.md)**, and generally just very bad software at least from the [URS] (irs md) point of view. This is partly 
because devs try to be "inclusive" and afraid to refuse [PRs] (pull_request md) from "diverse people" (who are mostly incompetent, again trying software development e.g. as part of proving that 
"minorities can program too"), partly because their software doesn't even aim to be good but rather popular (as it is to serve to promote political ideas etc). 

**It often has SJW "features"**, e.g. "slur filters", "diverse" characters in games etc. 


Examples of tranny software are: 


Rust](rust.md) 
Linux](linux.md) 
Firefox] Crirerox md) 
Lemmy] ( Lemmy . md ) 
Chromium](chromium.md) 


Example of software that doesn't seem to be tranny software: 


- all official [LRS](lrs.md) 

- TODO 

T transistor.md ---------- 
# Transistor 


Transistor is.a small [semiconductor](semiconductor.md) element of [glectronic] (electronics md) circuits that can be used as an amplifier or a switch, and which is a basic building block of |. 
[digital](digital.md) électronic [com utere | (computer md), integrated circuits’ and many, other électronic devices. Transistors replaced [vacuum tubes](vacuum_tube.md) and [relays] (relay. md) which 
were used in primitive computers of the 20th century; transistors can be made much small faster. 


, n r er, cheaper, more reliable and, unlike relays, operated purely electronically and there 
Transistor has become the most manufactured device in history. 


ore muc 


Transistor generally has three terminals, Its key principle is that of behaving like an glectronically operated amplifier or switch: we can make a transistor, *open* or *close* (i.e. conduct, or 
not conduct electricity) by applying different voltage or current (and we can also make it something between *open* and *close*). The voltage/current by which we control the transistor can be 
lower than that which we control, so we can see this as an amplifier: we can control high current with low current, i.e. the high current follows the low current but has higher amplitude. We can 
also see this as a switch: by applying voltage/current we can make a wire connect (low resistivity) or disconnect (high resistivity) similarly to a physical switch. This switch behavior is 
important for computers because we can exploit it to implement [binary](binary.md) (on/off) [logic circuits](logic gate.md). 


A basic division of transistors is following: 


- **bipolar junction transistor (BJT)**: They have 3 terminals: **emitter**, **base** and **collector**. By applying **current** in the base we control the current between emitter and collector 
(this current can be greater than thé control current). BJTs use both kinds of carriers at once, electrons and holes. BJTs are older than FETs, not much used in integrated circuits now. 

- **PNP**: There is P semiconductor (emitter), N (base) and then P again (collector), creating 2 NP junctions. It opens when there is no current at base. 

- **NPN**: The other way around that PNP (N, then P, then N). It opens when there is current at base. . A 
- **field effect transistor (FET)**: They hàve 3 terminals: **source**, **gate** and **drain**. By applying **voltage** to gate we control the current between source and drain. They use only one 
kind of charge carriers (electrons or holes). This is due to a different internal structure from BJTs, e.g. by having gate Separated from source and drain with a metal oxide layer in MOSFET. A 
voltage applied here kind of "pushes" the holes or electrons out of the way to create a channel between source and drain. The transistor can either be in enhancement mode (high voltage opens the 
transtetor, or depletion mode (low voltage opens the transistor). FETs are newer and have some nicer properties, e.g. lower noise or lower power consumption: they **only consume power on state 
change**. 

**P channel**: Source and drain are made of P semiconductor put into an N semiconductor. 
- **N channel**: Source and drain are made of N semiconductor put into a P semiconductor. They have a bit different properties from P channel FETs. 


Commonly used graphical symbols for transistor are (usually in a circle): 


BJT (NPN) BJT (PNP) FET (N) FET (P) 


First FET. transistors were. JFETs (junction-gate FET) but by today were mostly replaced by **MOSFETS** {metal-oxide- semiconductor FET), a transistor ing a metal oxide layer for separating the 
gate terminal which gives it some nice propérties over JFET. These transistors are used to implement [logic gates](logic_gate.md) e.g. using the **[ S] (amos sind) ?* fabrication process which 
uses complementary pairs of P and N channel FETs so that e.g. one is always off which decreases power consumption. 
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TI triangle.md ---------- 
& Triangle 


Triangle is a three sided [geivgoni polygon.md), one of the most basic 
simplést ["shape composed sides olytope.md) in [2 dimensions](2d. 
m 


[generic] (geometry amd) shapes, It isa [convex {convex.md) shape. Furthermore it is a 2-[simplex] simplex md), i.e, the 
md). Trian s are Very important, they for example help us’ to compute [distances] (distanc snd) or define functions like 
[sine](sin.md) and [cosine](cos.md) (Poe [trigonometry](trigonometry.md)). 


t Inm favorite book fe tat land) (flat Land md) triangles represent the lowest class of men with isoscele triangles being the lowest as they are most similar to [women](woman.md) who are just 
straight [lines](line.md). ~drummyfish } 


Triangle consists of three fvertices] (vertex .md) (usually labeled *A*, *B* and *C*), three sides (usually labeled *a*, *b* and *c* according to the side's opposing vertex) and three angles 
(usually labeled *alpha*, *beta* and *gamma* according to the closest vertex): 


B B 
LN c= / 
ce Na hypotenuse / a 
/ \ / 
vA \ y 
A b C A De 
triangle right triangle 


[pi pi md) 42 [radians] (radian.md) is an especially important type of triangle. Right triangles are. used to defin 
nd angent](t 


**Right triangle**,.a triangle with. one angle equal to 90 degrees Jg Q Q e 
) an.md), as ratios of Side lengths as a function of the triangle angle. For examplé in a right triangle (as drawn 


trigonometric’ functions, such as [sine](sih.md), [cosine](co3.md 
above) it holds that *sin(alpha) = a / c*. 


**Similar triangles** are triangles that, "have the same shape" (but may be of different sizes, positions and rotations). Two triangles are similar if the lengths of Corresponding sides have the 
same ratios, or, equally, if théy have the same inside angles. E.g. a triangle with side lengths 1, 2 and 3 is similar to a triangle with side lengths 2, 4 afd 6. This fact is véry useful in 
some geometric computations as it can help us determine unknown side lengths. 


pi /.3 radians); Equilateral triangles are of course all similar 
e u 


**Equilateral triangle** isa triangle whose sides have the same. length, which means all its angles are also equal (60 degrees s t 
. An * e** triangles (ol sé having one angle greater than 90 degrees). 


e 
to each other isoscele triang is a triangle with two sides of the same length. We can aíso distinguish acute and obtüs 


In a triangle there exist two important types of helper line segments: **median** and, **altitude**, Median goes from.a triangle's vertex to the opposite side's center. Altitude goes from a 
vertex to the opposite side in a perpendicular direction to that side. Each triangle has three medians and three altitudes. 


Some basic facts, features and equations regarding triangles are following (beware: many of them only hold in [Euclidean geometry](euclidean geometry.md)): 


- **Triangle angles add up to 180 degrees** ([pi](pi.md) [r&dians)(radian-md)). This can be used to determine unknown side angles. 
- fares} (ar wei ne: average the three coordinates, or take the intersection of the triangle's medians. 
- [Area] (area.md): 

- general triangle: *a * altitude(a) / 2* 

- right triangle: *a * b / 2* 
- celo y thagorean thegrem] (pyEhaggrean theorem.md)**: For the lengths of the sides of a RIGHT triangle it always holds that *a^2 + b^2 = c^2*. This is extremely important and can be used to 
determine ünknown side léngths óf right triangle$. 
- **[Thales's theorem](thales theorem.md)**: if points *A*, *B* and *C* lie on a [circle](circle.md), then they form a right triangle with hypotenuse equal to the circle diameter (and the center 
of the circle lying in the middle of the hypotenuse). 
- **Triangle ineguality*^: Sum of any two side lengths can't be, greater than the length of the third side, i.e.,*a * b «- c*, That means that e.g. a triangle with side lengths 1, 2 and 4 can't 
exist because 1 + 4 > 2. if one side of a triangle is exactly thé sum of the other two, the triangle is cálled **degenerate**, its vertices lie ön the samé line and it is Completely "squashed". 
- **Law of sines**: *a / sin(atpha) = b / sin(beta) = c / sin( gamma) * 
- **Law of cosines**: Generalization of Pythagorean theorem: *a\2 = bA2 + c^2 - 2 * b * c * cos(alpha)*. 
- Triangle [tessellation] tessellation.md) is one of only three possible regular plane tilings (the other two being [square](square.md) and [hexagon](hexagon.md)). 
- Every triangle has one [incircle](incircle.md) ([circle](circle.md) inside the triangle which touches each of its sides at one point) and one [circumcircle](circumcircle.md) ("outside" circle 
passing through all three triangle'$ vertices). 
- Triangle vertices always line in a single [plane](plane.md) (unlike other polygons). 


In non [Euclidean] (euclidean md) ("crazy") geometries triangles behave weird, for example we can draw a_triangle with three right angles on a surface of a [sphere](sphere.md) (i.e. its angles 
add to more than © degrees). This fact Can be exploited by inhabitants of a space (e.g. our [Universe](universe.md)) to find out if they in fact live in à non Euclidean space (and possibly 
determine the space's exact [curvature](curvature.md)). 


Constructing triangles: if we are to construct (draw) triangles with tony partial Know Ledge of its parameters, we may exploit the above mentioned attributes to determine things we don't " 
explicitly Know. For example if we're told to constrüct a triangle with knowing only the lengths of the sides but not the angles, we can determine an angle of one side using the law of cosines 
at which point we can already draw all three vertices and just connect them. In other words just use your brain. 


Triangles also play a big role e.g. in [realtime] (realfime md) [30 rendering](3d rendering.md) where they are used as a basic building block of [3D models](3d model.md), i.e. we [approximate] 
approximation.md) more Complex shapes with triangles because triangles are Simple (thankS to being a [simplex](simplex.md)) and so have nice properties such as always lying in a In ane] 

(p ane.md) so we cannot ever see both its front and back side at once. They are relatively easy to draw ([rasterize](rasterization.md)) so once we can draw triangles, we can also draw complex 
Shapes composed of triangles. In general triangles, just as other simple shapes, can be used to [approximate] (approximation md) measures and attributes -- such as area or center of mass -- of 
more complex shapes, even outside computer graphics. For example to determine an area of some complex shape we approximate it by triangles, then sum up the areas of the triangles. 


**[Barycentric coordinates](barycentric coords.md)** provide a [coordinate](coordinate.md system that can address specific points inside any triangle -- these are used e.g. in [computer 
grapnies](graphies.md) for [tex uring](texture md . The coordinates are three numbers that always add up to 1, e.g. [0.25, 0.25, 0.5]. The coordinates can be though of as ratios of areas of the 
hree subtriangles the point creates. Points inside the triangle have all three numbers positive. E.g. the coordinates of the vertices *A*, *B* and *C* are [1, 0, 0], [0, 1, 0] and [0, 0, 1], 

and the coordinates of the triangle center are [1/3, 1/3, 173]. 


.e. B 
going clockwise or countérclockwise around the triangle center. This is important e.g. for [backface culling](backface culling.md) in computer graphics (determining which side of a triangle in 
3D we are looking atls Determining of the winding of triangle can be derived from the sign of the z-component of the [cross product](cross product.md) of the triangle's sides. For the lazy: 
compute *w = (y1 - yO) * (x2 - x1) - (x1 - x8) * (y2 - y1)*, if *w > 0* the points go clockwise, if *w < 0* the points go counterclockwise, otherwise (*w = 0*) the points lie on a line. 


qodinding^r of the triangle,says.whether the ordered vertices of the triangle go clockwise or counterclockwise. I.e. winding says whether if we were to id in the direction *A -» -> C* we'd be 


[Sierpinski triangle](sierpinski triangle.md) is a [fractal](fractal.md) related to triangles. 


**Testing if point lies inside 2D trjanglett: one way to do this is following. For each triangle side.test whether the winding of the tested point and the side is the same as the winding, of 
whole triangle -- if this doesn't hold for any side, the point is outside thé triangle, otherwise it is inside. In order words for each side we are testing whether the tested point and the 
remaining triangle point are on the same side (int the same half plane). Here is a [C](c.md) code: 


Pt pointIsInTriangle(int px, int py, int tp[6]) 


// winding of the whole triangle: : l ! 
s "ign EPD A SPED a (pla = tps) - (tp[2] - tp[0]) * (tp[5] - tp[3]); 


for (int i = 0; i < 3; ++i) // test winding of point with each side 


2* 


int ii as 
i1 != 4? 11+ 2: 0; 


int i2 = 
int w2 = (tp[ii + 1] - "m > (tp[i2] - gran - (tp[it] - px) * (tp[i2 + 1] - tp[ii + 1]); 
int sign2 = w2 > 0 ? 1 : (w2 <0? -1: 0); 


if (sign * sign2 == -1) // includes edges 
//if (sign !- sign2) // excludes edges 
return 0; 
return 1; 
to. 
T trom.md ---------- 
# TROM 


{ WIP, still being researched. Was trying to reach the Tio guy but he didn't respond. -drummyfish } 


TROM RE Reality Of Me) is a project running since 2011 that's educatin ,Deinly about the harmfulness] (harmful md of trade-based society and. tries to show a better way: that of establishing 
so called [trade-free](trade_free.md) (in thé sense of WITHOUT trade) society. It is similar to e.g. [Venus Project](venus_project.md) (with which TROM collaborated for à while), the [Zeitgeist 
Movement] (zeigeist. movement .md) and our own [ERS] ( less_retaded society md) -- it shares the common core of opposing money and trade as a basis of society (which they correctly identify as the 
core issue), even though it differs in some details that we (LRS) don't see as wholly insignificant. The project website is at https://www.tromsite.com/. 


TROM was started and is.run by a. Romanian guy called Tio (born June 12 1988, according to blog), he has a personal blog at https://www.tiotrom.com and now lives mostly in Spain. The project 
seems more or less run just by him. 


The project is funded throu h; [Patergon] (patreon md) and has created a very impressive volume of very good quality educational materials including books, documentaries 
(gnu.md)/[Linux](Llinux.md) distroi (ais ro.md) ([iromjaro] (trom aroma) ) h 
trade-free society -- Tio says that he simply likes to learn all about 


i memes, even its own [GNU] 
e materials TROM creates sometimes edücate about general topics (e.g. language), not just those directly related to 
he world and then share his knowledge. 


The idea behind TROM is very good and.similar to LRS, but just as the [Venus project](venus project.md) it is a bit [sus](sus.md), we align with many core ideas and applaud many things they do, 
but can't say we 100% support everything about TROM. 


## Summary 


4 WATCH OUT, this is a work in progress sum up based only, on my at the moment a rather brief research of the project, I don't yet guarantee this sum up is absolutely correct, that will require 
e to put in much more time. Read at own risk. ~drummyfish } 


**good things about TROM**: 


ini Eae eny trade/money/[capitalism](capitalism.md) as the root cause of most problems in society -- this we basically agree with (we officially consider [competition](competition.md) to be 
e root cause). 

- It has TONS of very good quality educational materials exposing the truth, breaking corporate propaganda, even showing such things as corruption in [soyence](soyence.md) and [open source] 
(open source.md) etc. -- that's extremely great. 


**bad things about TROM**: 


- It is based on [fight culture](fight culture.md) and [hero culture]herg-eulture md) (judging by the content of the book *the origin of most problems*, creating superheroes and stating such 
things as "the world needs an enemy ), which we greatly oppose, we (LRS) don't believe à good and peaceful society can worship heroes and wars. Hopefully this is something the project may 
realize along the way, however at this point there is a great danger of falling into the trap of turning into a violent revolutionary [pseudoleftist](pseudoleft.md) movement. 

- TROM refuses to use [free (as in freedom) licenses](free_culture.md)! Huge letdown, Tio gives some attempt at explanation at https://www.tiotrom.com/2022/08/free-software-nonsense/, but he 
doesn't seem to understand the concept of free culturé/software very well, he's the "it don't need no license I say do whatever you want" guy. 

- [Bloat](ploat.md) a_lot of bloat everywhere, Javascript sites discrimipating against non-consumerist computers. Tio isn't a programmer and seems to not be very aware of the issues regarding 
software, he uses the [Wordpress](wordpress.md) abomination with plugins he BUYS étc. 

- There seems to be signs of fathesst] (atheism md)/2amverysmarténsi de grass overrationalism, some things are pretty cringe and retarded, see the following point. eh N 

- From Tio's blog TROM seems to be just his one-man project, even though he may employ a few helpers -- not that there's anything wrong about one man projects [:)](lrs.md) -- Tio is very 
determined, talented in certain areas such as "content Creation" etc., however he dropped out of school and lacks a lot of knowledge and insight into important aréas such as technology and free 
culture while talking about them as if he knew them very well, this is not too good and even poses some dangers. He really loves to write about himself, shows great signs of narcissism. Hell 
at times he seems straight from /r/iamverysmart, e.g. with this real cringe at his own theory of black holes https://www.tiotrom.com/2021/11/my-theory-about-black-holes/. Of course it's alright 
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nius at everything { Not wanting. to mak n 


el t e fun of en there myself. :) -drummyfish }. His eagerness 
trength and wéakneSs of it as well. Don't blindly 


to speculate and talk about anything, but sometimes it seems he thinks he's a g e m 
8$ TROM, takes thé good out of it, leavé the rest. 


is both his great strength and weakness, and as TROM is HIS project, it's the 
T trump.md ---------- 
& Donald Trump 


*"me goin to hav covfefe"* --president of the [United States](usa.md) 
TODO 


He is the smartest [capitalist](capitalism.md) of all time, which puts his intellect somewhere between a dolphin and a rat. When written in [binary](binary.md), his [IQ](iq.md) goes into triple 
igits! 

T1 trusting trust.md ---------- 

& Trusting Trust 


for example éven a completely |freé](free soTtware.md) compiler such as [gcc](gcc.md) w: verifiably non-maliciou$ code, which has been compiled by self and which is running on 100% free and 
non-malicious hardware may still contain malicious features if a non-trusted technology was ever involved in the creation of such compiler in the past, because such malicious techno logy may have 
inserted a self replicating malicious code that's hiding and propagating only in the executable binaries. It seemed like this kind of attack was extremely hard to detect and counter, but a 
method for doing exactly that was presented in 2009 in a PhD thesis called *Fully Countering Trusting Trust through Diverse Double-Compiling*. The problem was introduced in [Ken Thompson's] 
(ken_thompson.md) 1984 paper called *Reflections on Trusting Trust*. 


In computer ESen a ebah ieke ty {red (krusting trus" refers.to the observation (and a type of attack exploiting it) that one cannot trust the Feghpology he didn't create 100% from the ground up; 
n) H i i 


**Example**: imagine free software has just been invented and there are no free [C](c.md) compilers yet, only a proprietary (potentially malicious) C compiler *propC*. We decide to write the 
first ever free compiler called *freet*, in C. *freeC* code won't contain any malicious features, Of Course. Once we've written *freeC*, we have to compile it with something and the only. 
available compiler is the proprietary one, *propC*. So we have to compile *freeC* with sprone. -- doing this, even if *freeC* source code is completely non-malicious, *propC* may sneakily insert 
malicious code (e.g. a [backdoor | (backdoor md) or [telemetry] (telemetry. md) ) to *freeC* binary it generates, and it may also insert a self-replicating malicious code into it that will keep 
replicating into anything this malicious *freeC* binary will compile. Then even if we compile *freeC* with the (infected) *freeC* binary, the malicious self-replicating feature will stay, no 
matter pow many Times we recompile *freeC* by itself. Keep in mind this principle may be used even on very low levels such as that of [assembly](assembly.md) compilers, and it may be extremely 
ifficu o detect. 


**For a little retarded people**: we can, perhaps imagine this with robots creating other robots. Let's say we create plans fọr a completely nice, non-malicigus, well, behaved servant robot that 
can replicate itself (create new nice behaving robot$). However someone has to make the first robot -- if we let some potentially evil robot make the first "nice" robot according to our plans, 
the malicious robot can add a little malicious feature to this othrwise "nice" robot, e.g. that he will spy on its owner, and he can also make that "nice" robot make pass this feature to other 
robots he makes. So unless we make our first nice robot by hand, it's very hard to know whether our nice robots don't in fact posses malicious features. 

T twos complement.md ---------- 

# Two's Complement 


Two's complement is an elegant way of encoding signed (i.e. potentially negative) integer (and possibly also [fixed point](fixed point.md)) numbers in [binary](binary.md). It is one of the most 
basic concepts to know as à programmer; for its simplicity and nice properties two's complement is the way that's used to represent binary integers almost everywhere nowadays. Other ways of 
encoding singed numbers, mainly [sign-magnitude](sign magnitude.md) and [one's complement](ones complement.md), are basically always inferior. 


Why is two's complement so great? Its most notable advantages are: 


- **There if only one [zero](zero.md) value** (while other encodings such as sign-magnitude and one's complement have positive and negative zero which wastes values and complicates algorithms). 
- **Highest bit indicates the number sign** in the same way as e.g. in sign-magnitude and one's complement representations, i.e. determining whether a number is positive or negative is just as 
easy aS in the more naive representations. 

**Addition, subtraction and multiplication (both signed and unsigned!) work the, same as with unsigned represenratign and. overflow.naturally**, i.e. we can have exactly the same hardware. for 
these operations as for unsigned numbers and we don't even have to know whether the number is suppoSed to be unsigned or signed (this of course does NOT hold for any operation, e.g. division or 
comparison). Operations such as decrementing © or incrementing -1 correctly yield -1 and 0, respectively, without any special conditions. Subtraction can simply be done as adding a negated 
value. One's complement and sign-magnitude have to have special conditions for many of these situations. 

:.**Positive values and zero are the same as the straightforward unsigned representation**, i.e. it is "backwards compatible" with the Straightforward representation. For example the 4 bit value 
0011` represents number 3 in two's complement just like it does in a normal unsigned binary number. (This also holds in sign-magnitude and one's complement.) 

- **Multiplying by -1 is still relatively simple** -- even though it is a tiny bit more expensive than in one's complement or sign-magnitude, it is still pretty straightforward (only requires 
two operations instead of one) and in [hardware](hardware.md) it can be implemented just as fast. 


TODO: disadvantages? 
*N* bit number in two's complement can represent numbers from *-(2^N) / 2* to *2^N / 2 - 1* (including both). For example with 8 bits we can represent numbers from -128 to 127. 


**How does it work?** EZ: the highest (leftmost) bit_represents the sign; 0 is positive (or zero), 1 is negative, To negate a number negate all its bits and add 1 to the result (with possible 
overflow). (There is one exception: negating the smallest possible negative number will give the’ same number as its positive value cannot be represented.) 


In other words given *N* bits, the positive values representable by two's complement with this bit width are the same as in normal unsigned representation and any representable negative value *- 
x* corresponds to the value *2AN - X*. 


**Example:** let's say we have a 4.bit number, 0010" (2). It is positive because the leftmost bit is © and we know it repregents 2 because positive numbers are the same as the straightforward 
er i e se is 


representation. To get number -2, i.e. multiply our num by -1, we negate the number, which gives '1101' , and add 1, which gives 1110'. e by the highest 1 bit that this number 
negative, as we expected. As an exercise you may try to negate this number back and see we obtain the original number. Let's just now try adding 2; we expect that adding 2 to -2 will give 0. 
Sure enough, ~1110° + `0010` = ^0000'. EtCetc. :) 


The following is a comparison of the different representations, notice the shining superiority of two's complement: 


value unsigned two's com. sign-mag. one's com. 
000 [o] 0 Q [o] 
001 Ay 1 a T 
010 2 2 2 2 
011 3 3 3 3 
100 4 -4 -0 -3 
101 5 -3 -1 -2 
110 6 -2 -2 -1 
A11 7 -1 -3 -0 


Universal basic income (UBI) is the idea that all people should get regular pay from the state without any conditions, i.e. even if they don't work, even if they are rich, criminals etc. It is a 
great idea and **[we](lrs.md) fully support it** as the first stép towards the [ideal society](less retarded society.md) in which people don't have to work. As Yatitomat ion] (automation md) takes 
away more and more jobs, it is being discussed more and experiments with UBI are being conducted, even though capitalist idiots rather try to invent more and more [bullshit jobs] 
(bullshit_job.md) to keep people enslaved. 


UBI that itself covers all basic needs is called full, otherwise it is called partial: UBI subscribes to the idea that **the goal of progress is to eliminate the need for work**, which is 
correct -- we should leave all work to machines eventually, that's why we started civilization. This doesn't mean we can't work, just thàt we aren't obliged. 


The first reaction of .a noob hearing about UBI is "but everyone will, just Stop working!" Well no, for a number of reasons (which have been.confirmed by real life experiments). For example most 
people don't want to just survive, they want to buy nice things and have somethii extra, so most people will want to get Some additional income. Secondly people do want to work -- work in the 
sense of doing something meaningful. If they don't have to be wage slaves, most will decide to dedicate their free time to doing something useful. Thirdly people are already used to working, 
most will keep doing it just out of inertia, e.g. because they have friends at work or simply because they actually happen to like going there. 


Another question of the noob is "but who will pay for it?!" well, we all and especially the rich. In current situation, even if we make the rich give away 90% of their wealth, they won't even 
notice. 


Of course, UBI works with [money](money.md) and money, is bad, however the core idea is sim Y about sharing resources, i.e. true fcommunism] (communism md) which surpasses the.concept of money. 
That is once money is eliminated, the idea of UBI will stay às the right of everyone to ge hings such as food and health care unconditionally. LRS supports UBI as the immediate next step 
towards making money less important and eventually eliminating them altogether. 


Advantages of UBI: 


- **People will, seize to be slaves of capitalist employers** as it will no longer be mandatory to work somewhere. Nowadays people have, to accept shitty working conditions, because they have no 
other choice. They can't go elsewhere because it is thé same everywhere or their conditions don't allow them to move, every employer abuses his employees as much as possible so people today can 
only choose their slave master but they can't choose not being slaves. **If people can actually leave, employers will have to offer good conditions to keep people working for them**. It may also 
lead to e.g. greater freedom from consumerism as people can e.g. decide to not use certain bad technology which they are nowadays forced to use by employers. 
- **It will greatly suppress fputtshit jobs](bullshit_job.md)** and undesirable phenomena such as the [antivirus paradox](antivirus_paradox.md). People who stop doing bullshit jobs will be able 
to actually focus on useful things. 

**Suffering of many people will be lowered or eliminated**. Simple as that. 
- **We will. actually save money and other resources** because the system will simplify a lot. Nowadays we have gomp tex bureaucracy, and commissions that judge who can get social welfare, who can 
get disability pensions etc. Huge amounts of money are wasted to just keep unnecessary jobs existing, e.g. people have to commute to their bullshit jobs, which implies cars and roads have to be 
maintained more, also workplaces have to be maintained, cleaned, maintain work safety, etcetc. If everyone just gets money to live, we can save on this bureaucracy, maintenance, commissions, on 
doctor examinations, caring about the homeless, maintaining hugely complex laws etc. If people become less stressed, mental health will also improve and we will save money on treatment of 
mentally ill people. Money may also be saved on organization of worker unions as they may become much less important etc. 
- **Society will become more [ecological](ecology.md)** thanks to the elimination of bullshit and saving resources, as mentioned above. 
**People will become less stressed**, happier, will have security and as a result perhaps even become more "productive" (this has been confirmed by some experiments). 
iagLamina lity will greatly decrease** as it is directly linked to poverty, this will of course further save money on police, lawyers, medical bills etc. 
**People will become more equal** which will shift us closer to the [idea society](leps retarded society md). 
**People will be able to do more important things than work if needed**, for examp 
therefore better. 
- **Social security will Suppress fear in people** and therefore make them less xenophobic, less militant, less fascist etc. 
- **Homelessness will greatly decrease**, streets will be cleaner, we'll be able to close many homeless centers etc. 
- **There will be many more indirect benefits**, e.g. people may start to live without unnecessary things, that, are nowadays forced on. them by jobs such as cell phones, cars or bank accounts, 
which will subsequently make people consume less, Spend less time on toxic social networks and live moré healthy lives among friends in local Communities, lowering the negative effects of 
globalization such as the spread of the US culture etc. 
- **Capitalists will be crying like little babies**. 


e they may choose to focus on education for a few years, which will make the population better educated and 


Disadvantages of UBI: 


znone hu I guess a slight advantage might be that UBI still works with the idea of money, but as mentioned above, the principle of UBI will be preserved even after abolishment of money. 
-drummytis 

-- ui.md --- 
# User Interface 


user. interface, or UI, is an interface between human and computer. Such interface interacts with some of the human senses, i.e. it can be visual (text, images), auditory (sound), touch (haptic) 
etc. 


Remember the following inequality: 


*non-interactive [CLI](cli.md) » interactive [CLI](cli.md) » [TUI](tui.md) » [GUI](gui.md)* 


Some faggots hake living just by designing interfaces without even knowing programming lmao. They call it "user experience" or [UX](ux.md). We call it a [bullshit](bullshit.md). 
Ll unicode.md ---------- 


--creator of.d, Uno Sx 


In Unicode every character is unique like unicorn. 
T universe.md ---------- 
* Universe 
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niverse is everything that exists, it is the [spacetime](spacetime.md) and everything in it, all matter and energy as well as a he, laws of nature by which it behaves. The size of the whole 
Uni i ythi that ist it is th ti ti id d thi in it Tt tt d ll ll the 1 f t b hich it beh Th i f th hol 
universe is not known, it is possibly [infinite](infinity.md), however the size of thé observable universe -- the part of it with which we can ever interact due to limited [speed of light] 
speed of light.md) combined with constant expansion of space -- is about 93 billion [light Years] (Light year md in diameter, and contains an estimated number of 100 billion [galaxies 
galaxy.md), each containing hundreds of billions of [stars] (star md). Current science says the universe is about 13.7 billion years old and that it started with the [Big Bang (Big bang.md), a 
point in time from which everything began to rapidly expand from a single point in space. 


[com uters](eompyter md) çan. be used to simulate] (simulation .md certain parts of the universe, in fact all programs mimic the universe in some kind of simplified way, be it scientific 
imulations of planet collisions, government databases or ames](game.md)'-- they all more or less accurately model the reality. We can also see computers as a way 0 creating smaller 
universes, which leads many to think our universe may itse be à f simu lation] (simulation hypothesis md) running on some computer in a "bigger" universe (note that this probably 

and the debate isn't scientific, but we can lead philosophical discussions about it). 

T unix.md ---------- 


isn't testable 


*"Those who don't know Unix are doomed to reinvent it, poorly."* --obligatory quote by Henry Spencer 


Unix is an [etd] Cold md) [operating,system](operating-system,md) developed since 1960s as a research project of feet Labs] (bell labs md), which has become one_of the most influential pieces of 
software in history and whose principles (8:9. the [Unix philosophy] (unix philosophy .md) ) live on in many so called Unix-like operating systems such as [Linux](linux.md) and [BSD](bsd.md) (at 
least to some degree) : ghe original System itself is no longer in use, the name UNIX is nowadays a trademark and a certification. However, as someone once said, *Unix is not so much an operating 
system as a way of thinking*. 


Unix has reached the highest level a software can, reach: it has transcended its implementation and became a [de facto standard] (de facto standard.md). This means it has become a set of interface 
conventions, cultural and philosophical ideas rather than being a single system, it lives on as a concept thāt has many impleméntations. This is extfemely important as we don't depend on any 


single Unix implementation but we have a great variety of choice between which we can switch without greater issues. This is very important for [freedom](freedom.md) -- it prevents 
monopolization -- and its one of the important reasons to use unix-like systems. 

## History 

In the, 1960s, Bell Labs along with other groups were developin [Multics](mulfics md). a kind of [operating system os.md) -- however the project failed and was abandoned for its complexity and 
expensiveness of development. In 1969 two Multics developers, tk ennis Ritchie ennis ritchie.md), then started to create their own system, this time with a 


different philosophy; 
things as a file system, 
in [assembly] (assembly .md 


n Thompson] (key_thompson.md) and 
that of [sim licity](minimalism.md) (see [Unix phi losophy] (unix philosophy. m F): They weren't alone in developing the system, a number of other hackers helped program such 
penel ](shell.md) and simple utility programs. At VCF East 2019 Thompson said that they developed Unix as a working System in three weeks. At this point Unix was written 


the early 1970s the system got funding as well as its name Unix (a pun on Multix). By now Thompson and Richie were developing a new language for Unix which would eventually become the [C] 
md) language. In version 4 19573) UniX was rewritten in C. 


called System V was 


Unix then started being sold commercially. This led to its fragmentation into different versions such as the |8$01 (bsd md) or [Solaris](solaris.md). In 1983 a version . 
h Os, which led to a few Unix 


e 
released which would bécome one of the most successful. The fragmentation and a lack of a unified standard led to so called [Unix Wars](unix_wars.md) in the late 198 
standards such as [POSIX](posix.md) and Single Unix Specification. 


Fer, zooners] (aene md) and other noobs: Unix wasn't like [windows ] (windows md) it was more like [DOS] (dos md). „things were done in [text interface] (cti md) -- if you use the command line in 
"[Linux](linüx.md)" nowadays, you'll get an idea of what it was like, except at was all even more primitive. Things we take for granted such as a [ Ouse | Umpuse:md) [copy-pastes | (copy-paste md), 
interactive text editors, having multiple user accounts or [running multiple programs at once](multitasking.md) were either non-existent or advanced features in the early days. Anything these 
guys did you have to see as done with stone tools. 


T unix philosophy.md ---------- 
# Unix Philosophy 


Unix philosophy is one of the most important and essential approaches. to programming which advocates great [minimalism] (minimalism. md and is best known by the saying that **a program should 
only do one thing and do it well**. (Vmix philosophy is a collective wisdom, à set of recommendations evolved during the development of one of the earliest [operating systems](os.md) called 
[Unix](unix.md), hence the name. Unix pi osophy advocates simplicity, clarity, modularity, reusability and composition of larger programs out of smaller programs rather than designing huge 
monolithic programs as a_whole. Unix philosophy, at least partially, lives on in many project and Unix-like operating systems such as [Linux](linux.md) (though Linux is more and more distancing 
from Unix), has been wholly adopted by groups such as [suckless](suckless.md) and [LRS](lrs.md) (us), and is even being expanded in such projects as [plan9](plan9.md). 


In 1978 [Douglas Merlpoy] (mei troy,md) has written a short overview of the Unix system (*UNIX Time-Sharing System*) in which he gives the main points of the system's style; this can be seen as a 
summary Of the Unix philósophy (the following is paraphrased): 


1. **Each program should do one thing and do it well**. Overcomplicating existing programs isn't good; for new functionality create a new pro ram. 
2. **Output of a program should be easy to. interpret by another program**, In Unix programs, are chained by so called [pines] (Pipe. nd) in whi one program sends its output as an input to 
another, so a programmer should bear this in mind. [Interactive](interactive.md) programs should be avoided if possibte. 

3. **Program so that you can test early, don't be afraid to throw away code and rewrite it from scratch**. 

4. **Write and use tools**, even if they're [short-lived](throwaway script.md), they're better than manual work. Unix-like systems are known for their high [scriptability](script.md). 


This has later been condensed into: do one thing well, write programs to work together, make programs communicate via text streams, a universal interface. 


**Example**: maybe the most common practical example that can be given is {pipin ](pipe,md) small [command line](cli.md) utility programs; in Unix there exist a number of small programs that do 
*only one thing but do it well*, for example the cat dat md) program that only displays the content of a file, the [ grep o epo md) program that searches for patterns in text etc. In a 
command line we may use so called [pipes] (pipe.md to chain some of these simple programs into more complex processing pipelines. Let's say we want to for example automatically list all first 
and second level headings on given webpage and write them out alphabetically sorted. We can do it with a command such as this one: 


curl "https://www.tastyfish.cz/lrs/main.html" | grep "<h[12]>.*</h[12]>"_ | sed "s/[^»]*» *\([4<]*\) *<.*/\1/g" | sort 
Which may output for example: 


Are You A Noob? 

Some Interesting Topics 

Welcome To The Less Retarded Wiki 
What Is Less Retarded Software 


In the command the pipes (`|`) chain multiple programs together so that the output of one becomes the input of the next, The first command, ligu (curl.md), downloads the [HTML] (html mdp 
content of the webpage and paSses it to the second command, [ grep dtgrep.md), which filters the text and only prints lines with headings, this is passed to ij sed`](sed.md) that rémoves the HTML 
code and the result is passed to `sort` that sorts the lines alphabetically -- as this is the last command, the result is then printed. This is fast, powerful and very flexible way of processing 
data for anyone who knows the Unix tools. Notice the relative simplicity of each command and how each works with text -- the universal communication interface. 


Compare this to the opposite [Window philosophy] Cwindows-phi losophy md) in which combining programs into collaborating units is not intended or even purposefully prevented, and therefore very 
difficult, slow and impractical to do -- suc programs are designed for manually performing some predefined actions, é.g. painting pictures with a mouse, but aren't made to collaborate or be 
, 


automatized, they can rarely be used in unintende inventive ways needed for [hacking] (hacking ma). 


**watch out! Do not misunderstand Unix philosophy.** There are many extremely dangerous cases of misunderstanding Unix philosophy by [modern] (modern md) wannabe programmers. One example is the 
hilarious myth about "[React](react.md) following Unix philosophy, ([LMAO this](http://img.stanleylieber.com/src/20872/img/small.1527773532.png)), Supposedly the "devs" think that having billion 
of dependencies or focusing on doing one huge thang ([GUI](gui.md)) somehow implies Unix philosophy -- **nothing based on {javascript (js md) can ever follow Unix philosophy!** Unix philosophy 
can NOT be built on top of non-unix philosophy technology, and focusing on a very broad goal does not mean doing one thing. 


{ One possible practical interpretation of Unix philosophy I came up with is this; there's an upper but also lower limit gn, complexity. "Do one thin means the program shouldn't be too complex, 
we can simplify this to e.g. "Your program shouldn't surpass 10 KLOC". "Do it well" means the programs shouldn't bee too trivial because then it is hardly doing it well, we could e.g. say "Your 
program shouldn't be shorter than 10 LOC". E.g. we shouldn't literally make a separate program for printing each ASCII symbol, such programs would be too simple and not doing a thing well. We 
rather make a [cat](cat.md) program, that's neither too complex nor too trivial, which can really print any ASCII symbol. By this point of view Unix philosophy is really about balance of 
triviality and huge complexity, but hints that the right balance tends to be much closer to the triviality than we humans are tempted to intuitively choose. Without guidance we tend to make 
programs too complex and so the philosophy exists to remind us to force ourselves to rather minimize our programs to strike the correct balance. ~drummyfish } 


## See Also 


- [Unix](unix.md) 

- [minimalism](minimalism.md) 

- [suckless](suckless.md) 

- [KISS](kiss.md) 

- [Windows philosophy] (windows philosophy.md) 
T2 update culture.md ---------- 

& Update Culture 


Update culture.is a negative mindset of [capitalist] (capitalism.md) society which in technology manifests by developers of a (typically. [bloated bloat. mdp) program or similar product creating 
frequent modifications called "updates" and forcing users to keep Consuming these "updates", é.g. by deprecat ing or neglecting old versions, dropping [backwards compatibility] 
(backwards_compatibility.md) (e.g. [Python](python.md)) or by downright forcing updates in code. This is typically seen as a familiar pop-up message: 


*"Your software is too old, please update to the latest version."* 


In software this process is a lot of times automatized and known as [autoupdates](autoupdate.md), but update culture encompasses more than this, it's the whole mentality of having to constantly 
update one IS Software, hardware and other products. It is similar to [consumerism](consumerism.md) but more about constant modifications masked as "cool updates" rather than replacement of 
physical products. 


A typical example are [web browsers](browser.md) or proprietary [operating systems](operating system.md) that strive for [bloat monopoly](bloat monopoly.md). 


Update culture is however not limited to computers, or technology, hell no. It is the mindset of the whole society and applies to things such as fashion, business, gossip, watching TV news every 
day, browsing social media or constantly updating laws, it is e acceptance and approval of living in a constant stress of having to extort extreme amounts of energy just to keep up with 
artificially made up [bullshit](bullshit.md), to race against oneself and others in a never ending artificially sustained race with no winners, just with extremely exhausted participants. 
Current system of law requires constant everyday maintenance that's extremely costly, law needs to be constantly remade and rewritten to reflect any emerging trend in society because it is so 
unbelievably complex and tries to encompass every single aspect of our society. Of course we eventually oppose any kind of formal law, however the kind of update culture law is yet orders of 
magnitude worse -- if we see law as a tool to serve society, this kind of law is an utterly shitty tool similar to a hammer that has to be repaired every second just to keep functioning. 


Software updates are usually iugtified by "muh [security] security.md and "muh [ygdernj(modern md) [features] (fegture. md)", Users who want to avoid these updates or simply can't install them, 
ERR due to using old incompatible hardware or missing dependency packages, are ridiculed as *poorfags*, idiots and their Suffering is ignored. In fact, update culture is [Cancer](cancer.md) 
ecause: 


2o** 


- It_is a form of software [consumerism] (consumerism. md)* even if the updates themselves are gratis, they always come at.a cost such as potential unstability, requiring new hardware, forcing 
installing more dependencies, required learning to use thé new version, or even dropping of old féatures and malicious code in the updates. 

- **It is dangerous**, updates regularly break things, and there are cases where a lot depends on software running smoothly. 

- i is [bullshit](bulls it.md) effort, **wasting human work and creating an intentionally high [maintenance](maintenance.md) cost**. Humans, both users and programmers, become slaves to the 
software. 

**The security] (security md) justifications are lies**: a true concern for security would lead.to unbloating and creating a minimal, stable and well tested software, Update culture in fact 
constantly pushes newly created vulnerabilities with the updates which are only better in not having been discovered yet, i.e. relying on **security by obscurity**. This creates an intentionally 
**endless cycle of creating something that will never be finished** (even if it well could be). 

- **It kills, freedom**. E.g, with the,example of web the constant meaningless updates of JavaScript and addition of "features" eliminates any small competition that can't afford to keep up with 
the constantly changing enVironment. **This is why we have no good web browsers**. 

-,**It is a huge security risk** (Yes. we don't really buy intro.security but this still holds), The developer, whoever it is, has the power to remotely push and execute any, code, at any time to 
the devices of many users. In fact this can be seen as the definition of [backdoor | (backdoor sma hs This is not just an issue of [proprietary](proprietary.md) software, there have been many [FOSS] 
(foss.md) projects pushing [malware](malware.md) this way (look up e.g. the projects that targeted malware at Russians during the Russia-Ukraine war). 

T usa.md ---------- 


United States of America (USA, US or ipst "murika") is a [dystopian] (dystopia md) country of fat, stupid fascist people enslaved by [capitalism] (capitalism.md) people endlessly. obsessed with 
things such as money, wars, shooting their presidents and shooting up their schools. USA consists of 50 states located in North America, a continent that ancestors of Americans invaded and have 
stolen from Indians, the natives whom Americans mass murdered. 


USA is very similar to [North Korea](north_korea.md): in both countries the people are successfully led to believe their country is the best. North Korea is ruled by a single political party, US 
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is_ruled by two practically same militant gapitalist imperialist parties (democrats and republicans), i.e. de-facto one party as well. Both countries_are obsessed with weapons_and their 
military; oth are nighty and openly [fascist](fascism.md) (nationalist). Both countries are full of extreme [propagandal (prbpaganda ind) « [censorship](censorship.md) and greatly support cult of 
personality, people worship dictators such as Kim Jong-un or [Steve Jobs] (steve_jobs md) - US is even worse than North Korea because it exports its toxic culture over the whole world and 
constantly invades other countries, it is destroying all other cultures and leads the whole world to doom and destruction of all life. 


In US mainstream [politics](politics.md) there exists no true left, only [right (left right md) and [Pseudo tert] (pseudo left md). It is only in extreme underground, out of the sight of most 
people, where cens ona ly something good comes into existence as an exception to a general rule that nothing good comes from the US. One of these exceptions is [free software](free software.md) 
(es ablished by [Richard Stallman](rms.md)) which was however quickly smothered by the capitalist [open sour ee (open" source md) counter movement. 


On 6th and 9th August 1945 **USA casually killed about 200000 civilians**, most of whom were innocent men, women and children, by throwing atomic bombs on Japanese cities Hiroshima and Nagasaki. 
The men who threw the bombs and ordered the bombing were never put on trial, actually most Americans praise them as [heroes|(heró culture:md) and think it was a good thing to do. 


T used.md ---------- 

# Used 

Used is someone usin feghno logy that abuses him, most notably [proprietary](proprietary.md) software. For example those using [Windows](windows.md) are not users but useds. This term was 
popularized by [Richard Stallman](rms.md). 

T2 usenet.md ---------- 

# Usenet 

Usenet (User's Network) is.an ancient digital discussion network -- a [forum](forum.md) -- that existed long before the [World Wide Web](www.md). At the time it was very popular, it was THE 
place tó be, but nowadáys it's been forgótten by the mainstream, sadly hardly anyone rémembers it. 


Back in the day there were no Awe, browsers] (browser mq), there was no web. Many users were also **not connected through Internet** as it was expensive, they formally used other networks like 
[UUCP] (uucp.md) working through phone lines. They could communicate by some forms of electronic mail or by directly connecting to servers and leaving messages for others there -- these servers 
were called [BBS] (obs mdjes and were another popular kind of "[social network] (Social network md)" at the time. Usenet was a bit different as it was Taecentralized](decentralization md -- it 
wasn't stored or managed on a single [server](server.md), but on many independent servers that provided users with access to the network. This access was (and is) mostly paid (to [lurk](lurk.md) 
for free you can search for Usenet archives online). To access Usenet a **newsreader** program was needed, it was kind of a precursor to web browsers (nowadays newsreaders are sometimes built 
into e.g. email clients). Usenet was lots of time not moderated and anonymous, i.e. kind of free, you could find all kinds of illegal material there. 


Usenet invented many things that survive until today such as the words *[spam](spam.md)* and *[FAQ](faq.md)* as well as some basic concepts of how discussion forums even work. 


Usenet was originally pect Cascii me only, but people started to post binary files encoded as ASCII and there were dedicated sections just for posting binaries, so you co go 


It worked like this: there were a number of Usenet servers that all collaborated on keepin a database of *articles* that users posted (very roughly this is similar to how [blockchain] 

(boe kchain amd works nowadays ; the servers would more or less mirror each other's content. These servers were called *providers* as they also allowed access to Usenet but this was usually for 
à fee. The system uses a [NNTP {nntp md) (Network News Transfer Protocol) protocol. The articles users posted were also called *posts* or *news*, they were in plain text and were similar to 
email messages. Other users could reply to posts, creating a discussion thread. Every post was also categorized under certain **newsgroup** that formed a hierarchy (e.g. *comp.lang.java*). After 
so called *Big Renaming* in 1987 the system eventually settled on 8 top level hierarchies (called the *Big 8*): comp.* (computers), news.* (news), sci.* (science), rec.* (recreation), soc.* 
(social), talk.* (talk misc.* (other) and humanities.* (humanities). There was also another one called alt.* for "controversial" topics (see especially alt.tasteless). According to [Jargon 
ile](jàrgon file.md), by 1996 there wàs over 10000 different newsgroups. 


Usenet was the pre-[web](www.md) web, kind of like an 80s [reddit](reddit.md) which contained huge amounts of historical information and countless discussions of true computer [nerds] (ngrd md) 
which are however not cast ly accessible anymore as there aren't so many archives, they aren't well indexed and direct Usenet access is normally paid. It's a shame. It is possible to find e.g. 
initial reactions to the [AIDS] aids md) disease, people asking what the [Internet](internet.md) was, peop le discussing future technologies, the German cannibal (Meiwes) ooking for someone to 
eat (which he eventually. id), [Bezos](bezos.md) looking for [Amazon](amazon.md) programmers, a heated debate between fuinus Torvalds](torvalds.md) and [Andrew Tanenbaum](tanenbaum.md) about the 
best OS architecture (the "Linux is obsolete" discussion) or [Douglas Adams](douglas adams.md) talking to his fans. There were [memes](meme.md) and characters like [BIFF](biff.md), a kind of 
hilarious noob wannabe cool personality. Some users became kind of famous, e.g. Scott Abraham who was banned from Usenet by court after an extremely Long flame war, Alexander Abian, a | 
mathematician who argued for blowing up the Moon (which according to his theory would solve all Earth's issues), Archimedes Plutonium who suggested the Üniverse was really a big plutonium atom 
(he later literally changed his name to Plutonium lol) or John Titor (pretend time traveler). There are also some politically incorrect groups like *alt.niggers* [lol](lol.md). 


{ I mean I don't remember it either, I'm not that old, I've just been digging on the Internet and in the archives, and I find it all fascinating. -drummyfish } 
## Where To Freely Browse Usenet 


Search for Usenet archives, I've found some sites dedicated to this, also [Internet archive] (ánternet-archive.md) has some newsgroups archived. [google] (google .md) has Usenet archives on a 
website called "Google groups" (now sadly. requires login). There is a nice archive at https://www.usenetarchives.com. Possibly guys from Archive Team can help 
(https://wiki.archiveteam.org/index.php/Üsenet, https://àrchive.org/details/usenet, ...). See also http://www.eternal-september.org. 


## See Also 
- [BBS](bbs.md 

- [modem world] (modem_world.md) 
T2 vector.md ---------- 


Vector is a basic mathematical object that expresses direction and magnitude. (such as velocity, force etc.) and is usually expressed as an "array of numbers". For example in two dimensional 
space an array [4,3]' expresses à vector pointing 4 units to the "right" (alóng X axis) and units "up" (along Y axis) ànd has the magna tude 5 (which is the vector's length). Vectors are one 
of the very basic concepts of advanced math and are used almost in any advanced area of math, physics, programming etc. -- basically_all of physics and engineering operates with vectors, 
programmers will mostly encounter them in areas such as 3D [graphics] (graphics md), [physics engines] (p stes engine md) (forces, velocities, acceleration, ...), [machine learning] 

(machine. learning md) (feature vectors, ...) or [signal processing](signals.md) (e.g. [Fourier transform] (fourier_trans orm md) just interprets a signal as a vector and transforms it to a 
ifferent basis) etc. In this article we will implicitly focus on vectors from programmer's point of view (i.e. "arrays of numbers"), which to a mathematician will seem very simplified, but 
we'll briefly also foreshadow the mathematical view. 


Just like in elemental mathematics we deal with "simple" numbers such as 10, -2/3,.0r hid spt md) z- we retrospectively, call such "simple" numbers *ngscatars] (scalar md ** -- advanced mathematics 
generalizes the concept of such a number into vectors ("arrays of numbers", e.g. ~[1,0,- l of ^[0.5,0.5] ) and yet further to [matrices (matrix m ) ("two dimensional arrays of numbers") and 
efines a way to deal with such generalizations into **[ y vectors and matrices and solve [equations](equation.md) with 


l linear algebra] (linear algëbra.md)* ; i.e. we have ways to add and multip 
them, just like we did in elemental algebra (of course, linear algebra is a bit more complex as it mixes together scalars, vectors and matrices). In yet more advanced mathematics the concepts of 
vectors and matrices are further generalized to **[tensors](tensor.md)** which may also be seen as "N dimensional arrays of numbers" but further add new rules and interpretation of such "arrays" 
-- vectors can therefore be also seen as a tensor (of rank 1) -- note that in this context there is e.g. a fundamental distinction between row and column vectors. Keep in mind that vectors, 
matrices and tensors aren't the only possible generalization of numbers, another one is e.g. that of [complex numbers](complex number.md), [quaternions](quaternion.md) etc. Amway, in this . 
article we won E be discussing tensors or any of the more advanced concepts further, they are pretty non-trivial and mostly beyond the scope of mere programmer's needs :) We'll keep it at linear 
algebra level. 


**Vector is not merely a.coordinate**, though the traditional representation, of it suggest such representation and programmers often use vector data types to store coordinates out of convenience 
(e.g. in 3D graphics engines vectors are uséd to specify coordinates of 3D objects); vector should properly be seen as a **direction and magnitude** which has **no position**, i.e. a way to 
correctly imagine a vector is something like an **arrow** -- for example if a vector represents velocity of an object, the direction (where the arrow points) says in which direction the object 
zs moving And the mggnd tude (the arrow length) says how fast it is moving (its [speed](speed.md)), but it doesn't say the position of the object (the arrow itself records no position, it just 
"hangs in thin air"). 


Watch out, **mathematicians dislike defining vectors as arrays of numbers** because vectors are essentially NOT arrays of numbers, such arrays are just one way to express them. Similarly we 
don't have to interpret any array of numbers as a vector, just as we don't have to interpret any string of letter as a word in human language: A vector is simply a direction and magnitude, an 
"arrow in space" of *N* dimensions; a natural way of expressing such arrow is through multiples of basis vectors (so called components), BUT the specific numbers (components) depend on the 
choice of basis vectors, i.e. the SAME vector may be written as an array of different numbers (components) in a different basis, just as the same concept of a [dog](dog.md) is expressed by 
different words in different languages. Even with the same basis vectors the numbers (components) depend on the method of measurement -- instead of expressing the vector as a linear combination 
of the *N* basis vectors we may express it as *N* [dot products](dot product.md) with the basis vectors -- the numbers (components) will be different, but the expressed vector will be the same. 
Mathematicians usually define vectors abstractly simply as members of a **[vector space](vector space.md)** which is a set of elements (vectors) along with operations of addition and 
multiplication which satisfy certain given rules ([axioms](axiom.md)). 


## How Vectors Work 
Here we'll explain the basics of vectors from programmer's point of view, i.e. the traditional "[array](array.md) of numbers" simplification (expressing a linear combination of basis vectors). 


Given an *N* dimensional space, a vector to us will be an farray] array.md) of [reat numbers](real number.md) (in programming [floats](float.md), [fixed point](fixed point.md) or even just 
integers) of length *N*, i.e. the array will have *N* components (2 for 2D, 3 for 3D etc.). 


For example suppose 2 vectors in a 2 dimensional space, *u - [7,6]* and *v - [2,-3.5]*. To visualize them we may simply plot them: 
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NOTE: while for normal (scalar) variables we use letters such as *x*, *y* and *z*, for vector variables we usually use letters *u*, *v* and *w* and also put a small arrow above them as: 


-> -> 
u= [7,6], v = [2,-3.5] 


The vector's components are referred to by the vector's symbol and subscript or, in programming, with a dot or square brackets (like with array indexing), i.e. *u.x = 7*, *u.y = 6*, *v.x = 2* 
and *v.y = -3.5*. In programming data types for vectors are usually called vecN* or vN  wheré’*N* is the number of dimensions (i.e. '"vec2 , "veca eté.). 


Also note that we'll be writing vectors "horizontally" just as shown, which means we're using so called row vectors; you may also see usage of so called columns vectors as: 
-> 7 -> 2 
ul = [6], v= [-3.5 


Now notice that .we do NOT plot the vectors.as points, but as arrows starting at the origin (point (9.91) -- this is again. because we don't normally interpret vectors as a position but rather as 
a **direction with magnitude**. The direction is apparent from the picture Pu points Kind of top-rig and *v* bottóm-right) and can be exactly Computed with [arcus tangent](atan.md) (i.e. 
angle of *u - atan(6/7) - 40.6 degrees*, ...), while the magnitude (also length or nort) is given by the vector's Euclidean **[length](len Eh imd) 

puackets (in programming the function for getting the lengt e "len^, ^size' or ‘abs’, even though [absolute value] (al 
ere), i.é.: 


** and is denoted by the vector's symbol in '||^ 


may be called something lil s.md) is not really a mathematically correct term 


-> 
llul] = sqrt(7^2 + 6^2) ~= 9.22 

-> 
|lvI] = sqrt(2^2 + -3.5^2) ~= 4.03 
In, fact we may choose to represent the vectors in a format that just directly says the angle with the X axis (i.e. direction) and magnitude, i.e. *v* could be written as *{40.6 degrees, 
9.22...}* and *u* as *{-56.32 degrees, 4.03...)* (see also [polaf coordinateS](polar coorüs.md)). This represents the same véctors, though we don't do this so often in programming. 


A vector whose magnitude is exactly 1 is called a **unit vector** -- such vectors are useful in situations in which we only care about direction and not magnitude. 
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The vectors *u* and.*v* may e.g.,represent a velocity of cars in a 2D top-down facing game -- the vectors themselves will be used to update each car's position, during one game frame and their 
magnitudes may be displayed as the current speed of each car to their drivers. Howevér keep in mind the vector magnitude may also represent other things, e.g. in a 3D engine a vector may be used 
to represent camera's orientation and its magnitude may specify e.g. its [field of view](fov.md), or in a physics engine a vector may be used to represent a rotation (the direction specifies the 
axis of rotation, the magnitude specifies the angle of rotation). 


**But why not just use simple numbers?** A Velocity of a car could just as well be represented by two variables like 'carVelocityX, and 'carVelocityY', why all this fuzz with defining vectors n 
shit? Well, this simply creates an [abstraction](abstraction.md) that fits to many things we deal with and generalizes well, just like we eq define the Concept of a sphere and cylinder even 
though fundamentally these are just sets of points. If for example we suddenly want to make a 3D game out of our racing game, we simply start using the 'vec3' data type instead of 'vec2' data 
type and most of our equation, such as that for computing speed, will stay the same. This becomes more apparent once we Start dealing with more complex math, e.g. that related to physics where 
we have many forces, velocities, momenta etc. This becomes even more apparent when we start to look into operations with vectors which are really what makes vectors vectors. 


Some of said **operations** with vectors include: 


- **addition** (vector * vector - vector): Just like.with numbers we can.add vectors, i.e. for, example if there are two forces acting on an object and we represent them by vectors, we can, get 
the total force as a vector we get by adding the individual vectors. Addition is pretty straightforward, we simply add each component of both vectors, e.g. ^u * v = [7 + 2, 6 - 3.5] = [9,2.5]*. 
Geometrically addition can be seen as drawing one vector from the other vector's endpoint (note that the [order doesn't matter](commutativity.md), i.e. *u * v - v * u*): 


OS QONHPINO RUOLO - 


- **subtraction** (vector - vector - vector): Subtracting vector *v* from vector *u* is the same as adding *v* times -1 (i.e. *v* with opposite direction) to *u*. 
- **multiplication**: There are several ways to "multiply" vectors. 

.- **scalar multiplication** (scalar * vector -» scalar): Multiplying vector *u* with_scalar *x* means scaling the vector *v* along its direction by the amount given by *x* -- for this we 
simply multiply each component of *u* by *x*, e.g. if *x = 0.5*, then *u * x = [7 * 0.5,6 * 0.5] = [3.5,3]*. 

- tahdot product](dot product.md)** (vector * vector -> scalar): Dot product of vectors *u* and *v* is a very common operation and can be used to determine the angle between the vectors, it is 
denoted as *u . v* and is computed as *u . v = u.x * V.X + uy *'v.y + U.Z * V.Z + ...*; the value this gives is the [cosine] (cos md) of the angle between the vectors times the magnitude of *u* 
times the magnitude of *v*. I.e. if *u* and *v* have length of 1 (are normalized), we directly get the cosine of the angle and can get the angle with the [asos] acos.md) function. This is used 
in many situations, e.g. in graphics [shaders] (shader .md) dot product is used to determine the angle at which light hits a surface which says how bright the surface will appear. 

- **[cross product](cross_product.md)** (vector * vector -> vector): Cross product basically gives us a vector that's perpendicular to the input vectors. 

- **vector matrix multiplication** (yector * matrix -> vector): Multiplying a vector by matrix can achieve e.g. a specific transformation of the vector (such as rotating it). For details see 
the article about [matrices](matrix.md). 

- **[normalization](normalization.md)**: Normalization forces a vector's magnitude to a certain amount, typically 1 -- we do this when we have a vector and simply want to just discard its . 
magnitude because we only care about direction (e.g. when doing a dot product to get an angle between vectors we first normalize them). To normalize a vector (to length 1) simply divide all its 
components by the current magnitude, e.g. *normalized(u) = [u.x / ||u||,u.y 7 Hutt z [0.76...,0.65...]*. 


## Code Example 
TODO 


T1 venus project.md ---------- 
& The Venus Project 


The Venus Project is a big project established by [Jacque Fresco](jacque fresco.md), already running for decades, aiming for a voluntary and rational transition towards an ideal, highly . n 
technological and automatéd [spen ety I(soctery md without [money](money.md), Scarcity, need for human [work[(work.md), Social [compe tation | (comers tion. md), wars and violence, a society in which 
people would have abundance thanks to so called [resource based Sconomy |(resour ce_based_economy md), where they would be [collaborating](collaboration.md), loving, respecting the nature, caring 
for others and free to pursue their true potential. It is similar to the [Zeitgeist Movement](zeitgeist movement.md) and [TROM](trom.m In its views, goals and means the Venus Project is 
extremely close to fies) (irs ad) and we highly support it, however watch out: while the ideas behind the project are good, the project itself is a bit [sus](sus.md) and may show internal 


corruption just as the [FSF](fsf.md), [TROM](trom.md) and other projects -- use your brain, follow ideas, not people. 


There is a non-profit. organization called [One Community](one community.md) that tries to pursue goals set by the Venus Project and strive for what they call *Highest Good*. Its website is at 
https: //www.onecommunityglobal.org. 


## Overview 


{the Following is based mainly on my understanding of what I've read in Fresco's book *The Best That Money Can't Buy*. I recommend the book for an overall overview of the project. 
~drummyfis 


The project is a child of [aacque Fresco] (jacque fresco md), a eneralist] (qeneralism.md) futurist who sadly died in 2017, who worked on it for many decades with his life partner Roxanne 
Bata eats has a center located in Florida and is a [nonprofit](nonprofit.md) organization that performs research, education and prototype technology according to their ideas of a future we 
should strive for. 


à it is [de facto](de facto.md) **[anarcho pacifist](anpac,md) communist] 
Very nicely it also seems, at least as of 5022, uninfected with the [SJW](sjw.md) [cancer] (cancer imd) e fight culture] 


Although the project seems to be avoiding, specific political labels Mover" as to avoid historical associations) 
eir goals and Fresco explicitly stated that we have to stop constantly fighting for human rights and rather establish a 


(Semi c ** movement (i.e. politically the same as TERS] CES md 
fight cultureé.md) and [fascism](fascism.md) goes directly against t 
Society with human rights built-in. 

Fresco highly.criticizes today's society and just as [usd (us. mdp says it only tries to cure the symptoms (search the solutions within the current framework and.mindset) rather than the root 
cause of its issues (the system itself). He mainly criticizes the presence of the monetary system and laws -- currently taking the form of [capitalism](capitalism.md) -- which he correctly 
blames for most today's issues such as artificial scarcity, hunger, wars, [fascism](fascism.md), lack of social security, poverty, [wage slavery](wage slavery.md), destruction of natural 
environment, waste, energy crisis, [planned absolescence|(plenned obsolescence md), deteriorating psychological health etc. He says with the presence of advanced technology we have this system 
is highly outdated (for example it forces artificial scarcity because only scarce resources can be sold, unlike for example air) and points out the fact that we have more than enough resources 
for everyone on Earth and could live in abundance and peace, practicing **[collaboration](collaboration.md) rather than competition] (coñptetition- md)". Therefore he argues that we have to 
eliminate {money (money md), barter and markets from the society and change the very basis of whole society, down to our mentality and outdated historical associations (and eventually even 
language which should be closer to the scientific language). 


He argues to replace the monetary system with so called **[resource based economy] (resource-based economy md)** (RBE) which should be a pillar of the future society. RBE is called an "economy" 
but doesn't use any money or barter, it starts by declaring that all Earth's resources are a common heritage of all people on Earth -- it basically means that "everything is available to 
everyone", i.e. no one can own resources of the Earth, they belong to us all and whoever needs something can take it. RBE would be supported by high automatization and computer monitoring to 
deliver resources where they are needed. Normies usually can't comprehend that this could work, they say "but then someone will just steal everything", but Fresco correctly argues that with 
correct and rational use of our technology we can, unlike in the past, already extract as many resources as to satisfy everyone with high abundance; basically we can make for example food as 
abundant as is air nowadays -- no one wi be (and can be) stealing food when there's more free food than anyone can eat, just as stealing air isn't a concern nowadays. 


This. should therefore also eliminate the need for complex. laws -- when no.one is stealing, we don't need laws against stealing etc, Elimination of money and laws will remove the need for 
[bullshit](bullshit.md) jobs such as lawyers, judges, politicians, marketing guys, bankers etc., freeing more péople and getting rid of a lot of unnecessary work and burden of society. 


Fresco supports this by the fact that **human behavior is determined by the environment and upbringing? * -- nowadays we have criminality mostly because firstly people are poor, i.e. pushed into 
illegal activit and secondly nurtured by the competitive propaganda that teaches them, right from little children, to [fight](fight cülture.md) and compete with others. In a caring society 


that provides alt their needs and raises Xhem in the spirit of collaboration and love towards others criminals will be almost nón existent, there will simply be no gain from it. 


The.project further seeks to **eliminate the need for human [work](work,md)**: all work, ingluding complex decision making, would be automated. Bullshit jobs would be removed ang; [maiptenanee] 
(maihtenance.md) reduced to minimum. People would be free to pursue their true interests and could fully and freely devoté themselves to it. Again normie$ usually say something like "BUT THEN 
NOBODY AIN'T GONNA WORK". Well, firstly that wouldn't be an issue since no human work would even be needed anymore, and secondly Fresco correctly answers by saying that competition and force 
isn't the only drive of human activity, people are motivated for work and creative activity by other phenomena such as curiosity, sense of accomplishment, boredom, moral values etc., and usually 
even perform tter than when forced to it. [Maslow's Hierarchy of Needs] (mas Lows hierar chy_o  needs.md) is a well known psychological model that says that once basic needs such as food and 
shelter are satisfied (which RBE will accomplish), people start voluntarily pursuing higher needs such às art, science and other Creative work. People did work and create tong before money and 
Jobs existed. The idea of reducing or eliminating human work is already being consider nowadays in the form of [universal basic income](ubi.md) -- experiments have been confirming that it 
works. 


Venus Project stresses the important of iolscience]|(seience-md)* -- their approach is strictly scientific,-- technology (such as [At] fai- md) and sensors all over the Earth) and [rationality] 
(rationality md) and argues for application of technology to everything as that, in their opinion, will allow RBE and remove the néed for human government. **There should bé no human governing 
the society**, decisions will be made mostly by machines in a network of decentralized cities all over the Earth ("technophobes" are informed that even nowadays we put our lives into the hands 
of machines, 9:9: in planes or with pacemakers, and they do better job than humans) Techno logy should be sustainable, respect the nature and be aligned with it, i.e. not fight against it but 
rather direct its forces towards good causes. Protection of the environment and in egration of natural elements in cities is stressed. Only clean and safe energy would be used. Earth carrying 


capacity should be respect, i.e. people would avoid overpopulation by voluntary birth control. 
The, project is for **absolute freedom of information** -- there would be no [intellectual property] (intellectual property.md) (copyright, patents, :;:), no trade secrets, state secrets and 
probably also no personal secrets, as in a non-competitive society there wouldn't be a danger of abusing personal information. They argue that deSpite computer sensors being present everywhere, 


there would simply be no need for surveillance of people as there would be no corporations, no criminality etc. 


It also opposes nationalism, racism and other forms of privilege and inequality. However this shouldn't be forced in the [SJW](sjw.md) style, it should rather come naturally thanks to fixing the 
the root cause of these issues (removing competition, governments, money etc.). 


Education would play a huge role in the society -- again, it wouldn't be forced on children, they should want to go to school because education would be [fun] (fun. md) and give them freedom to 
pursue their interests. There would be no grades and it should teach high scientific and critical thinking, rational discussion, nonviolent resolution of conflicts, Collaboration through group 
project and collaborative games, love towards nature (e.g. by projects involving growing plants) etc. [Generalism](generalism.md) would be preferred before hyper [specialization] 
(specialization.md) (which we see nowadays). 


Fresco also addresses the, fear of some people of, people becoming too uniform and losing individuality -- h 
Dy 


f stresses that individuality would be focused on, uniformity would only lie in common 
goals and caring for all humans and nature. Unlike in current s l 


e 
iety, each human would have the freedom to pursue his true interests and goals. 


The project claims it has years, of research and seems to have a great number, of, specific ideas for what the techno logy might look like, how we would harness energy, travel etc. There are many 3D 


visualizations. Fresco claims that in the new society everyone would have a higher living standard than the rich have’ nowadays. 

The transition towards this society should be ropeacetul and evolutionary, NOT revolutionary**. It has to be voluntary and rational, The initial stage -- building the first center with the 

project ideas in mind -- has already been completed in Florida. Raising Tunds and educating the public should continue, then more cities in the spirit of the project should start to appear, 
a 


interconnect and prove the ideas in practice. Then slowly the new cities and ideas would start to replace our current system. 


## Comparison With LRS 


We, FERS] (Urs md) highly support and agree with the Venus Project as an idea, in its analysis of current society, goals and means of achieving it. At least as of 2022, we can't know if any 
single próject will become corrupt in the future (e.g. with [SJWs](sjw.md)). We may still disagree on some details, focus a bit more on different areas etc. Here are a few points about that. 


Venus Project seems.to only focus on humans, unlike LRS which is based on the love of all. life, i.e. also animals, possibly even alien life etc. Venus Project mentions that in the future there 
would posSibly be fish farms -- for us this seems unacceptable as we advocate [vegetarianism](vegetarianism.md), even the lives of fish are precious to us. In a highly advanced society 
artificial meat (whieh we accept) would probably be available and replace meat from any living animals so we would eventually align with Venus Project, but the human-centeredness of Venus 
Project is sti there. 


It may, seem.we also focus on simplicity of technology (e.g. suck lessness] (suckLess .md) } while Venus Project seems to adyocate {bloat ] (bloat md) and overapplication of technology. This may not 
be such an issue because a truly good technology that Venus Project advocates should converge towards simplicity naturally thanks to minimizing maintenance, maximizing safety (minimizing 
dependencies), removal of bullshit features etc. In other word even hi-tech advocated by Venus Project can be done in a suckless way, for example the automation would work on top of [Unix] 
(unix_philosophy.md) operating systems. Still the future from LRS point of view may look less hi-tech, we might prefer simple buttons to voice recognition and so on :-) 
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And a bit more criticism: the project doesn't seem to practice Ere culture](free culture.md) and [free software] (tree software.md), even though of course it would implement them in their 
Society -- it kind of makes sense' as they seem to be trying to be above current movements, they simply think we should Focus Beyond them. We might disagree and say that even looking into the far 
future we should still keep an eye on the now, education about free culture can greatly contribute to education about the advantages of information freedom etc. Furthermore they are selling some 
videos on their site, which we don't really like but the project justifies it as raising funds for their operation. To their credit they have many gratis videos and educational material, even 
the books can_be found as "free download". Another criticism comes towards the materials themselves which are sometimes a bit unprofessional which is a shame (e.g. the book has many typos and is 
not so readable). Also there seems to be a bit of personality cult around Jacque and Roxanne, their faces are all over the place and even though they seem like really reat people and even 
though it may simply be due to the lack of other "strong personalities", this makes the movement look like a religious cult to some critics. Tio, the guy behind [TROI yttrom. nd) who collaborated 
with Venus Project also expressed slight criticism of organization of the project, that they were too concerned about control over their materials and that he even met a few toxic people there, 
though he says the experience was till mostly positive. We have to keep in mind that people, teams and projects are imperfect, they can become spoiled and fail, however this changes nothing 
about the ideas the project presents, which we support. As always, we have to separate ideas and people -- the situation here is perhaps similar to [free software](free_software.md) as an idea, 
which we fully support, vs [free software foundation](fsf.md) aS a project and team of people, which has a few issues. 


## History 
TODO 
## See Also 


less retarded society](less_retarded_society.md) 
trade tree (trade Pres md 
Zeitgeist Móvement](zeitgeist movement.md) 
TROM] (trom.md 
One Community] (one_community.md) 

Positive Revo ution] (positive_revolution.md) 
Il version numbering.md ---------- 
& Version Numbering 


TODO 
## LRS Version Numbering 


At [ERS] lrs.md).we Suggest the following.version numbering (invented/employed by [drugmyfish] (drummyfish.md)): { OFC I don't know if anyone else is already doing this, I'm not claiming any 
history firsts, just that this is what I independently started doing in my projects. ~drummyfish } 


This is a simple system that tries to not be [dependent (dependency.md) on.having a [version control system] (ycs.md) such as batty (9t. md), i.e. this system works without, being able to make 
different development branches and can be comfortably used even if you're just déveloping a project in a local directory without any fancy tools. Of course you can use a VCS, this system will 
just make you depend less on it so that you can make easier transitions to a different VCS or for example drop a VCS altogether and just develop your projects in a directory with FTP downloads. 


Version string is of format *major.minor* with optional suffix letter ^d', e.g. 0.35, 1.0 or 2.1d. 


Major and minor numbers have the. usual meaning. Major number signifies the great epochs of development and overall project state --.0 means the project is in a state before the first, stable, 
highly usable, [optimized](optimization.md), Tiestad] (testing m ) and [refactored](refactoring.md) release that would have all initially set goals and features implemented. 1 means the ay 
as alr that 


eady reached such state. Any further increment signifies a similarly significant change in the project ([API](api.md) overhaul, complete rewrite, extreme number of new features etc. 
has already been incorporated with all the testing, optimization, refactoring etc. At the start of each major version number the minor version number is set to © and within the same major 
version number a higher minor number signifies smaller performed changes (bug fixes, smaller optimizations, added/removed individual features etc.). Minor number doesn't have to be incremented 
by a. the Aue may try to intuitively reflect the significance of the implemented changes (e.g. versions 6.2 and 0.201 differ only very slightly whereas versions 0.2 and 0.5 differ 
significantly). 


From the user's perspective a greater *major.minor* number signifies a newer version of the project and the user can be sure that versions with the same *major.minor* number are the same. 


The main difference against traditional version numberings is the opțional `d` suffix. This suffix added to version number *X* signifies an in:development (non-release) branch based on version 
*X*. **If a version has the d suffix, it doesn't have to change major and minor numbers with implemented changes**, i.e. there may be several different versions of the project whose version 
number is for example 0.63d. I.e. with the 'd' suffix it no longer holds that versions with the same number are necessarily the same. This allows developer to not bother about incrementing 
version number with every single change (commit). The deve toper simply takes the latest release version (the one without `d` suffix), adds the 'd' suffix, then keeps modifying this version 
without caring about changing the version number with each change, and when the changes are ready for release, he removes the `d`ò suffix and increases the version number. The user may choose to 
only use the release (stable, tested, ...) version without the suffix or he can take the risk of using the latest development version (the one with the “d° suffix). 


With this a project can be comfortably developed in s single git branch without managing separate stable and development branches. The head of the branch usually has the latest in-development 
version (with the d' suffix) but you may just link to prévioüs commits of release vérsions (without the 'd' suffix) so that users can download the release versions. You can even not use any VCS 
and just develop your project in a directory and make hard backups of each release version. 


Here is an example of version numbering a project with the LRS system: 


xt editór](text editor.md) for s 
f a much simpler editor tul (ei md) that was made in 1976 and which has become a standard text editor installed on every [Unix](unix.md) system. Vim added features like tabs, [syntax highlight] 
syntax highlight md), [scriptabi lity] (scri t.md), sessions and plugins and as such has become not just a simple text editor but an editor that can comfortably be used for [programming] 
programming.md) instead of any bloated [IDE](ide.md). Observing a skilled Vim user edit text is really like watching a magician or a literal movie hacker -- the 

without any use of mouse, it transcends mere text editing and for some becomes something akin a way of life. 


version description release? 

0.0 just started z YES 

0.0d added license, Makefile, ... no 

0.0d added some code no 

0.0d added more code no 

0.01 it already does something! YES 

0.01d added more features no 

0.01d fixed some bugs no 

0.01d refactored no 

0.2 it is already a bit usable! YES 

0.2d added more features no 

0.9d fixed bugs nó 

0.9d refactored no 

1.0 nice, stable, tested, usable! YES 

1.0d added a small optimization no 

2:0 complete rewrite for perform. YES 

2.0d added a few features no 

2.0d fixed a bug no 

2.01 a few nice improvements YES 
Dll... vimimd ---------- ux 
# Vim 
{ This is WIP, I use Vim but am not such guru really so there may appear some errors, I know this topic is pretty religious so don't eat me. ~drummyfish } 
Vim sya Improved) is a legendary [free as in freedom] (free software md), fairly (though not hardcore) lyipimalist](minimalism,md) and guckless | (suck less. md) terminal] (terminal, md) -only o 
GUI](gui.md)) [te killed programmers and hackers, and one of the best éditors you can choose for text editing and [programming](programming.md). It is a Successor 
o 


editing is extremely fast, 


Vim is generally known to be **"difficult to learn"** -- it is not because it is inherently difficult but rather for being very different from other editors -- it has no GU1](gui.md) (even 
though it's still a screen-oriented [interactive](interactive.md) [TUI](tui.md)), it is keyboard-only and is operated via text commands rather than with a [mouse](mouse.md), it's also preferable 
to not even use arrow keys but rather [hjk] (hjk .md) keys. There is even a [meme](meme.md) that says Vim is so difficult that just exiting it is a non-trivial task. People not acquainted with 
Vim aren't able to do it and if they accidentally open Vim they have to either Google how to close it or force kill the terminal [xD](xd.md) Of course it's not so difficult to do, it's a little 
bit different than in other software -- you have to press escape, then type "ig^ and press enter (although depending on the situation this may not work, ed. 
and want to exit without saving you have to type ':wqa' etc.). The (sad) act is that most [coding monkeys](coding.md) and proressional programmers" [nowaday 
ugly [bloated](bloat.md) [IDE](ide.md) as their most important tool rather than investing two days into learning Vim, probably the best editor. 


if you have multiple documents open 
s](kids_these_days.md) choose some 


roby use Vim?** Well, simply because it is (relatively) [sycktess](suckless.mq), universal and extremely good for editing.any, text and for any kind of [programming] (programming md), for many it 
[settles](settled.md) the search for an editor -- once you learn it you'll find it is flexible, powerful, Comfortable, modifiable, lightweight... it has everything you néed. Anyone who has ever 
invested the time to learn Vim will almost certainly tell you it was one of the best decisions he made and that guy probably only uses Vim for everything now. Many people even get used to it so 
much they download mods that Fn add Vim commands ànd shortcuts to programs like web browsers. A great advantage is that **vi is installed on every Unix** as it is a standard utility, so if you 
know Vim, you can just comfortably use any Unix-like system just from the [command line](terminal.md): when you [ssh ](sshsmd) into a server you can simply edit files without setting up any 
remote GUI or whatever. Therefore Vim is automatically a must learn skill for any sysadmin. A huge number of people also use Vim for **"[productivity](productivity cult.md)"** -- even though we 
don't fancy the productivity cult and the bottleneck of programming speed usually isn't the speed of t ping. it is true that **Vim makes you edit text extremely fast** (you don't move your hands 
between mouse and keyboard, you don't even need to touch the arrow keys, the commands and shortcuts make editing very efficient). Some nubs think you "need" a huge IDE to make big programs, 
that's just plain wrong, you can do anything in Vim that you can do in any other IDE, it's as good for editing tiny files as for managing a huge codebase. 


Vim's biggest rival is [Emacs] (emacs.md), a similar editor which is however more complex and [bloated](bloat.md) (it is Dagkedl (jokes md) that Emacs is really an [operatin system] os,md)) -- 
Vim is more Suckiess (Suck leas md); yet not less powerful, and so it is naturally the choice of the Suckless cómmunity and also° [ours](irs.md). Vim and Emacs are a subject of a **[holy war 

(holy war.md)** for the the best editor yet developed; the Emacs side calls itself the *[Church of Emacs](church of emacs.md)*, led by [Richard Stallman](rms.md) (who created Emacs) while the Vi 
supporters are called members of the *[Cult of Vij(cult of vi.md)* (vi vi vi - 666). 


It has to be noted that **Vim as a program is still kind of [bloated] bloat .md)** large part of the [suckless](suckless.md) community acknowledges this ([eat-v1(cat-v.md) lists Vim as [harmful] 
(harmful.md), recommends [Acme](acme.md), [Sm] (Sam. md) or led} (edm instead). Nonetheless the important thing is that **Vim is a good [de facto standard](de_facto_standard.md)** -- the Vim's 
interface and philosophy is what matters the most, there are alternatives you Can comfortably switch to. The situation is similar to for example "Unix as a concept", i.e. its interface, 

[philosophy](unix philosophy.md) and culture, which together create a certain standardization that allows for different implementations that can be switched without much trouble. In the suckless 
community Vim has a similar status to [C](c.md) [Einux jt tinuma). or [Xii](xii.md) -- it is not ideal, by the strict standards it is a little bit bloated, however it is one of the best existing 
solutions and makes up for its shortcomings by being a stable, well established de-facto standard. 


## How To 
These are some Vim basics for getting started. There are two important editing modes in Vim: 


- **insert mode**: For writing text, you just type text as normal. Pressing *ESC* enters command mode. Here **CTRL + ^n'^** can be used for text completion. 
- **command mode**: For executing commands. Pressing *i* enters insert mode. 


Some important commands in command mode are: 


- **arrow keys**: Can be used for moving cursor, even though many prefer to use the *hjkl* keys. With *SHIFT* held down the cursor moves horizontally by words and by screens vertically. 
- *** ho, j>; k^, Vl **: Cursor movement. 
- **'$'**: Move cursor to end of the line. 
- **'0^**: Move cursor to start of the line. 
- **CTRL + "w^ + "w^**: Move between windows (created with ^:split' or '":vspit'). 
- **CTRL + PAGEUP**, **CTRL + PAGEDOWN**: Move between tabs. 
- **u**: Undo. 
- **CTRL + SHIFT + ^r^**: Redo. 
- **'i'**: Allows entering longer commands. *TAB* can be used for completion and up/down keys for listing command history. Some of the commands are: n : t A 
pean: Rie Quit, or close the current extra window/tab. Use **'qa'** for closing all windows/tabs and quit. **'q!'^** (or **'qa!' **) quits without saving changes, **'wq'** quits with saving 
changes, **' wqa' ** quits all saving all changes etc. 
- **"w^**: Save changes (can be followed by filename). 
- **'noh'**: Cancel high ighted text (e.g. after search). 2 1 : Y r , 
k CAR yor Run command in terminal, you Can e.g. compile your program this way. For running Vim commands before the terminal commands use **'vimcommands |! terminalcommands' **, e.g. ~:wa |! 
make ./program'. 
- **'tabedit filename'**: Opens given file in a new tab (tabs are closed with ':q'). 
- **'tabmove number'**: Move current tab to given osition ('*' and '-' can be used for relative movement of tabs). 
- **'ysplit' **: Creates a new window by splitting the current one vertically. 
- **'split'**: Creates a new window by splitting the current on horizontally. 
- ***>°**: Indent to the right, well combined with text selection (^v^, "V^ 
- **',"**: Repeat previous command. 
- **"*4s/find/replace/g' **: Search and replace [regex](regex.md), [sed](sed.md) style. 
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- **'help command **: Show help about given command. | S 
- ***set variable value`**: Set a variable, used e.g. in configs. 
- nea ios Aare Search for a [regex](regex.md) patter entered after ^/^. Found matches will be highlighted ('^:noh^ cancels the highlight), you can move to the next one with ^n'^ and to the 
previoüs one wi i 
- **NUMBER `G`**: Go to line with given number (0 means last line). 
eoe p io ERO EORR Pe lect/high Lig t text (by characters and by lines). 
:.t*'d'**: Delete, this is followed by a command saying what to delete, e.g. "dw deletes to the end of the word, **'dd'** deletes the whole line. WARNING: delete actually copies the deleted 
text into clipboard (it behaves like *cut*)! 
**'o!**: Insert new line. 
"d Paste. 
Copy (yank), followed by a command saying what to copy (e.g. 'yw^ copies a word), **`yy`** copies the whole line. 


Vim can be configured with a file named **'.vimrc^** in home directory. In it there is a set of commands that will automatically be run on start. Example of a simple config file follows: 


set number set line numbering 

set et " expand tabs 

set sw-2 

set hlsearch 

set nowrap no line wrap 

set colorcolumn-80 " highlight 80th column 
set list 

set listchars-tab:». 

set backspace-indent,eol,start 

syntax on 


## Alternatives 


Of course there are alternatives to Vim that are based on different paradigms, such as [Emacs] (emacs md), its biggest rival, or, plan9 editors.such as [Acme] (acme md) - In this regard any [text 
editor](text editor.md) is a potential alternative. Nevertheless people looking for Vim alternatives are usually looking for other vi-like editors. Thése are for example: 


- **[vi](vi.md)**: while you probably won't use the original ancient vi program but rather something like [nvàdgnvi. ma, viis a [POBIX](pogix. md) standard for a text editor that's much simpler 
and ünivérsal than Vim. It lacks many features one may De used to from Vim Such as tabs, [autocomp lettoni t utocómplete:md), [synt x highligh](syntax_highlight.md) or multiple [undos](undo.mf). 
But fame yourself Eo, only using the features specified Dy, he standard makes you more likely to be able to operate any vi-like text editor you encounter. (List of features added by Vim to vi 
can be found in "runtime/doc/vi diff.txt' in Vim source tree. 

ME neovim](negvimymd)*e: .Iries to be the " qodernizeg](moderp.md)" ([refactorgd] (refactoring.md)) fork of Vim, it removes some code, adds a,new plugin system but also [bloat] (bloat .md) like 
[CMake](cmaké.md). One of its self-stated goals is to bé more "community driven". It is also written in C99 (while Vim is in C89, more portable). { At least I think. ~drummyfish } 
- e vis DA md)** (Ren 2150 by vim and [55m] (sam img), written in gis Seed Sd rie nir afew Trin Has no fabs: { At least I didn't find them. ~drummyfish } 
- nvi](nvi.m new vi): Vi implementation originally made for [BSD sd.m much simpler than Vim (see vi above). 

- **[elvis](elvis.md)**: Another vi implementation, pretty simple (see " above). B aor i : 

- **[BusyBOx vi](busybox.md)**: Very minimal vi implementation with very few features {see vi above), missing even window splits etc. 

a FE gvim] (gvim.md **: Various versions of Vim wit [GUI] (qui. md) frontends made with libraries such as [gres (gtK3- md) or Xavi] (xaw.md) - These run in a graphical window and have a menu with 
item$ you find in mainstream editors (*save*, *open*, *find* etc.). Of course you can still use this in the samé way aS the terminal version. 

T------ viznut.md ---------- 

# Viznut 


(minimalism.md). He is known for examplé for his [countercomplex](countercompléx.m » discovéring at](bytebeat.md) and creatin frBNiZ | (abniz md) is own words, he believes 
much more can be done with much less. He also warns of [collapse](collapse.md) (http://viznut.fi/en/future.html). According to his [Fediverse]( ediverse.md) page he lives in Turku, Finland, was 


Viznut (reat name Ville-Matias Heikkilä) is a Finnish [demoscene](demoscene.md) programmer, [hacker] (hacking. md) and fartist)(ant.md) that advocated high fechnotogicgl [minimalism] 
dj blog, có- [bytebe. : nh 
born around 1977 and has been programming since the age of seven. 


His work is pretty based, in many ways aligned with [LRS] 
ü 


HEacebok] (facebook md), [twitter](twitter.md) and [gith 


} s.md), he contributed a great deal to minimalist technology. Unfortunately in some ways he also seems pretty retarded: he uses 
fail ab.m 


r 
§ (github.md) and also mentions "personal pronouns" on his twitter xD Pretty disappointing TBH. This would make Viznut a [type A fail] 


His personal site is at http://viznut.fi/en/ and his blog at http://countercomplex.blogspot.com/. He collects many files at http://viznut.fi/files/, including very interesting writings about 
demoscene, programming experiments etc. 


In 2011 he released [IBNIZ](ibniz.md), a tiny [SDL](sdl.md) fviccual flachine} (ym.md and a language that's meant as a platform.for creating [genos] (demoscene md) . Also in 2011 hẹ was involved in 
the discovery of [bytebeat](bytebeat.md), a way of creating music with extremely sii pte [C](c.md) expressions -- later he published a paper about it. In 2012 he founded [Skrolli](skrolli.md), a 
magazine about sustainable/non-consumerist technology. In about 2019 he released PC-lamerit, an animated series about 90s computer hackers, made as an executable computer program -- it looks 
pretty cool. He also created UNSCII, a fixed-width font usable for [ANSI art](ansi art.md). 

T watchdog.md ---------- 

# Watchdog 


watchdog is a special [timer](timer.md) that serves as a safety mechanism for detecting malfunction of computer programs at [run time](run_time.md) by requiring programs to periodically reset 
e timer. 


Basically watchdog keeps counting up and a correct ly behaving program is supposed to periodically reset this count ("kick" or "feed the dog") -- if.the reset doesn't happen for a longer period, 
the watchdog counts up to a high value and alerts that something's wrong ("the dog starts barking"), e.g. with an [interrupt] (interrupt md] or a [signal](signal.md). This can mean for example 
that the program has become stück in an [infinite loop](infinite loop.md) or that its instructions were corrupted ànd the program control jumped to Some unintended area of RAM and is doing crazy 
[shit](shit.md). This is usually handled by resetting the system so as to prevent possible damage by the program gone insane, also [logs](log.md) can be made etc. Watchdogs are very often used 
in [embedded systems](embedded.md). [Operating systems](os.md) may also use them to detect nonresponsive [processes](process.md). 


Watchdog is similar to the. dead man's switch used e.g. in trains where the operator is required to periodically push a button otherwise the train will automatically activate brakes as the 
operator is probably sleeping or dead. 


## See Also 


- [dog] (dog.md) 
T wavelet transform.md ---------- 
# Wavelet Transform 


*Good luck trying to understand the corresponding [Wikipedia](wikipedia.md) article.* 


Wavelet transform is a [mathematical] (math smd) operation, similar fo.e.9, [Fourier transform] (fourier transform. md), that takes a fgignall (signal_processing. md) £818; audio or an image) and 
outputs information about the [frequencies](frequency.md) contained in that signal AS WELL aS the locations of tho$e frequencies. ThiS is òf Course extremely uSeful when we want to analyze and 
manipulate frequencies in our signal -- for example Yape6 2000](jpeg_2000.md) uses wavelet transforms for [compressing](compression.md) images by discarding certain frequencies in them that our 
eyes are not so sensitive to. 


The main advantage over [Fourier transform](fourier transform.md) (and similar transforms such as [cosine transform](cosine_transform.md)) is that wavelet transform shows us not only the 
frequencies, but ALSO their locations (i.e. for example time at which these frequencies come into play in an audio signal). -This allows us for example to locate specific sounds in audio or apply 
compression only to certain parts of an image. While localizing frequencies is also possible with Fourier transform with tricks such as [spectrograms] (Spectrogram mà). wavelet transforms are a 
more elegant, natural and continuous way of doing so. Note that due to [Heisenberg's uncertainty principle](uncertainty principle.md) it is mathematically IMPOSSIBLE to know both frequencies and 
their locations exactly, there always has to be a tradeoff -- the input signal itself tells us everything about location but nothing about frequencies, Fourier transform tells us everything 
about frequencies but nothing about their locations and wavelet transform is a **midway** between the two -- it tells us something about frequencies and their approximate locations. 


Of course there is always an inverse transform for a wavelet transform so we can transform the signal, then manipulate the frequencies and transform it back. 


Wavelet transforms use so called splwave lets] (wavelet .md ** (*tiny waves*) as their basis function, similarly to how Fourier.transform uses [Sine] (sin,md)/ [cosine] (cos.md) functions to analyze 
the input signal. A wavelet is a spécial function (satisfying some given properties) that looks like a "short wave", i.e. while a sine function i$ an infinite wave (it goés on forever), a 
wavelet rises up in front of 0, vibrates for a while and then gradually disappears again after 0. Note that there are many possible wavelet functions, so there isn't a single wavelet transform 
Se wavelet transforms are a **family of transforms** that each uses some kind of wavelet as its basis. One possible wavelet is e.g. the [Morlet](morlet.md) wavelet that looks something 
ike this: 


The wavelet is in fact a Joomplex] (com lex number.md) function,, what's shown here is just its real part (the [imaginary | (ima inary_number .md art looks similar and swings in.a_perpendicular way 
to real part). The transfórm can Somewhat work even just with the real part, for understanding it you can for start ighdre complex numbers, but working with complex numbérs will eventually 


create a nicer output (we'll effectively compute an envelope which is what we're interested in). 


The output of a.wavelet transform is so. called a gralogram"* (similar to [spectrum] (spectrum md) in Fourier transform), a multidimensional function that for each, location in the signal (e.g. 
time in audio signal or pixel position in an image) and for each frequency gives "Strength" of influence of that frequency on that location in the signal. Here the "influence strength" is 


basically similarity to the wavelet of given frequency and shift, similarit meaning basically a [dot product | (dot product md) or feonve tur ton] (conve ution.md). Scalogram can be computed by 
[brute force](brute_force.md) simply by taking each possible frequency wavelet, shifting it by each possible offset and then convolving it with the input signal. 


For big brains, similarly to Fourier transform, wavelet transform can also be seen as transforming a point in high.dimensional space -- the input function -- to a different orthogonal pvertor 
basis}tvector basis md) -- the set of basis vectors represented by the possible scaled/shifted waVelets. I.e. we literally just transform the function into a different coordinate system where 
our coordinates are frequencies and their locations rather than locations and amplitudes of the signal (the original coordinate system). 

TODO 

l2 web.md ---------- 

# Web 


*Ouch, this is embarrassing!* 


The article is actually [here] (www.md). 
T1 whale.md ---------- 
# Whale 


the game stores daily hey highly engáge in [microthéft](microtheft.md) and may throw even thousands of dollars at the game every day (cases of players spending over 1 million dollars on a 
casual game are known). In the playerbase there may exist just a handful of whale players but those are normally the main source of income for the game so that the developers actually focus 
almost exclusively on those few players, they craft the game to "catch the whales". The income from the rest of the players is negligible -- nevertheless the non-whales also play an important 
role, they are an attraction for the whales, they are there so that they can be owned by the whale players. 


In online [pay to win] (pay to win.md) {games ] (gene; mp a.whale is a und} a who spends enormous sums of mone much more than most of other players combined. They buy the most expensive items in 


Existence of whale players is one of the demonstrations of the [pareto principle](pareto.md) (80/20 rule): 80% of the game's income comes from 20% of the players, out of which, by extension, 80% 
again comes from the 20% and so on. 


The, terminology,can be extended further: besides **whales** we may also talk about **dolphins** (mid-spending players) and **minnows** (low spending players). Extreme whales are sometimes called 
**white whalesS** or **super whales** (about 0.2% generating 50% of income). 


In some games, such as [WoW](wow.md), players may buy multiple accounts and practice so called [multiboxing](multiboxing.md). This means they control multiple characters at once, often using 
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scripts (Sgript.md) to coordinate them,, which of course gives a great advantage. Thou! h ysing scripts or "hacking" the game in similar ways is in other cases considered unacceptable, [cheating] 
cheating.md hat results in immediate ban, for obvious reasons (money) developers happily allow this -- of course this just shows they don't give a single shit about fairness or balance, they 


only thing they care about is $$$profit$$$. 
T2 wiby.md ---------- 


Wiby is a [minipalist](minigalisq,md);non-corporate [web] (www md) search engine] (search Sn gine. md for old-style non- bloated] (bloat md) (web 1.0, Oba web](smol_internet,md)") websites. | 
Searching ön wiby will yield small, Simple websites, mostly non-interactive, static [HTML](Atml.md ersonal/hobby sites, small community sites and obscure weird sites -- this kind of sear chang 
is not onl (funy fun.md), adventurous and nostalgic [90s](90s.md) like experience, but it actually leads to finding useful information which on corporate search engines like [Google] (google.md) 
or [Bing](bing.m get buried under billions of useless noise sites and links to "content platforms" like [YouTube](youtube.md) and [reddit](reddit.md). We highly recommend searching on wiby. 


It can be accessed at https://wiby.me and https://wiby.org. Of course, no [JavaScript](js.md) is needed! Clicking "surprise me" on wiby is an especially entertaining activity. 
The engine doesn't automatically crawl the whole web, it instead works by users submitting links, the admin approving them and a bot potentially crawling these sites to a small depth. 


Wib ¡appears to have been launched in October 2017 and built.by a sole programmer who remains anonymous and accepts donations. On the [ASCII art](ascii art.md) on the front page there are 
initials 'jgs which may or may not point to the author of wiby. 

On July 8, 2022 wiby, became even more amazing by **being released as [free (as.in freedom) software](free software.md)** under [GPLv2](gpl.md)! It works on the [LEMP](lemp.md) stack. See http:// 
wiby.me/about/guide.html. (The database of sites though seems to remain [proprietary](proprietary.md).) 


A similar search engine seems to be https://search.marginalia.nu/. 
T--------- wiki authors.md ---------- 
# LRS Wiki Authors 


Contributors, list yourselves here if you have made at least one contribution. This helps keep track of people for legal reasons etc. 
Contributors to this wiki include: 
- Miloslav Cíz aka [drummyfish](drummyfish.md) (https://www.tastyfish.cz) 


l1 wikidata.md ---------- 
# Wikidata 


wikidata is a large collaborative project {a sister project of priki edia] (wikipedia.nd), hosted by Wikimedia Foundation) for creating a puge noncommercial [ppb lic domain] (public domain.md) 
database](databaSe.md) containing information basically about éverything. Well, not literally everything -- there are some rules about what can be included that are similar to those on 
Wikipedia] (wikipedia.md), e.g. notability (you can't add yourself unless you're notable enough, of course you can't add illegal data etc.). Wikidata records data in a form of so called 

know edge graph](knowledge graph.md), i.e. it connects items and their properties with statements such as "Earth:location:inner Solar System", creating a mathematical structure called a [graph] 
graph.md). The whole database is available to anyone for any purpose without any conditions, under [CC0](ccO.md)! 


Wikidata is wildly useful and greatly overlooked in the shadow of Wikipedia even though it offers a way to easily obtain large, absolutely [free] (free culture md) and public domain data_sets 
about anything. The database can be queried with specialized languages so one can e.g. get coordinates of all terrorist attacks that happened in certain time period, a list of famous male cats, 
visualize the tree of biological species, list Jews who run restaurants in Asia or any other crazy thing. Wikidata oftentimes contains extra information that's not present in the Wikipedia 
article about the item and that's not even quickly found by [googling](google.md), and the information is sometimes also backed by sources just like on Wikipedia, so it's nice to always check 
Wikidata when researching anything. 


wikidata was opened on 30 October 2012. The first data that were stored were links between different language versions of Wikipedia.articles, later Wikipedia started to use Wikidata to store 
intormation to display in infoboxes in articles and so Wikidata grew and eventually became a database of itS own. As of 2022 there is a little over 100 million items, over 1 billion statements 
and over 20000 active users. 


## Database Structure 
The database is a [knowledge graph](knowledge graph.md). It stores the following kinds of records: 


- **entities**: Specific "things", concrete or abstract, that exist and are stored in the database. Each one has a unique [ID](id.md), name (not necessarily unique), description and optional 
aliases (alternative names). 
(hólocà MS) 008953, 9f the real world, their ID is a number prepended with the letter *Q*, e.g. *[dog](dog.md)* (Q144), *[Earth](earth.md)* (Q2), *idea* (QQ131841) or *[Holocaust] 
olocaust.m K 
- **properties**: Attributes that items may possess, their ID is a number prepended with the letter *P*, e.g. *instance of* (P31), *mass* (P2067) or *image* (P18). Properties may have 
constraints (created via statements), for exàmple on values they may take. 
- **statements**: Information about items and properties which may possibly link items/properties (entities) with other items/properties. One statement is so called triplet, it contains a 
subject (item property), verb (property) and object (value, e.g. atem proper Ey; number, string, ...). I.e. à statement is a record of form *entity:property:value*, for example 
*dog(Q144):subclass of(P279):domestic mammal(Q57814795)*. Statements may link one property with multiple values (by having multiple statements about an entity with the same property), for 
example a man may have multiple nationalities etc. Statements may also optionally include *qualifiers* that further specify details about the statement, for example specifying the source of the 
ata. 


The most important properties are probably **instance of** (P31) and **subclass of** (P2729) which put items into [sets] (set .md /classes and establish subsets/subclasses. The *instance of* 
attribute says that the item is an individual manifestation of à certain class (just like in [OOP](oop.md)), we can usually substitute is with the word "is", for example Blondi (Q155695, 
[Hitler](hitler.md)'s dog) is an instance of dog (Q144); note that an item can be an instance of multiple classes at the same time. The *subclass of* attribute says that a certain class is a 
subclass of another, e.g. dog (Q144) is a subclass of pet (Q39201) which is further a subclass of domestic animal (Q622852) etc. Also note that an item can be both an instance and a class. 


## How To 
There are many [Libraries (library .md)/[Abzs} api.md) for wikidata you can use, unlike shitty corporations that guard their data by force wikidata provides data in friendly ways -- you can even 
download the whole wikidata database in [JSON](json.md) format (about 100 GB). 


g to the online query interface https://query wikidata org), entering a query (in [BPAROL](spargl md) language, 
JSO SV] (csv 


The easiest way to retrieve just the data you are interested in is probably g e 
l ni N](json.md), [ .md) etc. That can then be processed further with whatever Language or 


oin 
similar to ES (salma) ) then clicking download data -- you can choose several formats, e.g. [ 
tool, be it [Python](python.md), [LibreOffice](libreoffice.md) Calc etc. 


**BEWARE**: the query you enter may easily take a long time to execute and time out, you need to write it nicely which for more complex queries may be difficult if you're not familiar with 
SPARQL. However wikidata offers online tips on [optimization](optimization.md) of queries and there are many examples right in the online interface which you can just modify to suit you. 


Here are some example of possible queries. The following one selects video [games](game.md) of the [FPS](fps.md) genre: 


TT ?item ?itemLabel WHERE 


?item wdt:P31 wd:Q7889. # item is video game and 
?item wdt:P136 wd:Q185029. # item is FPS 


# this gets the item label: 
SERVICE wikibase: label { bd:serviceParam wikibase: Language "[AUTO LANGUAGE],en". } 


lar 100 # limit to 100 results, make the query faster 
Another query may be this one: select [black holes](black hole.md) along with their mass (where known): 


SELECT ?item ?itemLabel ?mass WHERE 
{ ?item wdt:P31 wd:Q589. } # instances of black hole 


UNION 
{ ?item wdt:P31 ?class. # instance of black hole subclass (e.g. supermassive blackhole, ...) 
?class wdt:P279 wd:Q589. } 


OPTIONAL { ?item wdt:P2067 ?mass } 
SERVICE wikibase: label { bd:serviceParam wikibase: Language "[AUTO LANGUAGE],en". } 


dh. 


wikipedia.md 


" Wikipe ia 


Wikipedia is a non-commercial, [free/open] (free culture md) [pseudoleftist] (pseudo left md : online] (www. md) encyclopedia of general knowledge written mostly by volunteers, running on, [free 
Sofitware|(free software md), allowing almost anyone to edit its content (i.e. being a [wiki](wiki.md)); it is the largest and perhaps most famous encyclopedia created to date. It is licensed 


under [C BY SA (cc_by_sa. md) and is run by the [nonprofit](nonprofit.md) organization Wikimedia Foundation. It is accessible at https://wikipedia.org. Wikipedia is a mainstream information 
source and therefore politically censored^1234567891011121314151617181920. 

Shortly after the project started in 2001, wikipedia used to.be a great project -- it was very similar to how LRS wiki looks right now; it was relatively unbiased, objective, well readable and 
used plain HTML and A: 


CII art (see it as https://nostalgia.wiki edia.org/wiki/HomePage), however over the years it got corrupt and by 2020s it has become a political battleground and kind of a 
[politically correct](political correctness.md [Joke] (Jokes md) - A tragic and dangerous joke at that. It's still useful in many ways but it just hardcore censors facts and even edits direct 
quotes to push a [pseudoleftist](pseudoleft.md propaganda. **Do not trust Wikipedia, especially on anything even remotely touching politics* always check facts elsewhere, e.g. in old paper 
books, on Metapedia, Infogalactic etc. As old Wikipedia is still accessible, you may also browse the older, less censored version, to see how it deranged from a project seeking truth to one 
abusing its popularity for propaganda. 


Wikipedia exists in many. (more than 200) versions differing mostly by the, [language (Language md) used but also in other aspects: this includes HE Simple English Wikipedia,or Wikipedia in 
[Esperanto](esperanto.md). In all versions combined there are over 50 million articles and Over 100 million users. English Wikipedia is the largest with over million articles. 


There are also many sister projects of Wikipedia such as [Wikimedia Commons](wm_commons.md) that gathers [free as in freedom](free_culture.md) media for use on Wikipedia, [WikiData] 
(wikidata.md), Wikinews or Wikisources. 


Information about hardware and software used by Wikimedia Foundation can.be found at https://meta.wikimedia.org/wiki/Wikimedia_servers, As of 2022 Wikipedia runs of the traditional [LAMP 
lamp.md) framework and its website doesn't require (JavaScript |( Javascript md) amazing!). [Debian] (debian md) [GNU] (gnu.md)/[TLinux](linux.md) is used on web servers (switched from [bu atu] 
pupe mahan in 2019). The foundation uses its own [wiki](wiki.md) engine called itt J: 

, 


MediaWiki] (mediawiki.md) that's wr en mainly in [PHP](php.md). Database used is [MariaDB](mariadb.m The 
servers run on server clusters in 6 different data centers around the world whic! 


are rented: 3 in the [US](usa.md), 3 in [Europe](europe.md) and 1 in [Asia](asia.md). 


Wikipedia was created by [Jimmy Wales](jimmy_wales.md) and [Larry Sanger](larry sanger.md) and was launched on 15 January 2001. The basic idea actually came from Ben Kovitz, a user of . 
[wikiwikiweb ] (wikiwikiweb.md), who proposed it to Sanger. Wikipedia was made aS a complementary project alongside [Nupedia](nupedia.md), an earlier encyclopedia by Wales and Sanger to which only 
verified experts could contribute. ikipedia of course has shown to be a much more successful project. 


There exist [forks](fork.md) and alternatives to Wikipedia. Simple English Wikipedia can offer a simpler alternative to sometimes over ly complicated articles on the main English Wikipedia. 
Citizendium](citizendium.md) is a similar online encyclopedia co-founded by [Larry Sanger](larry sanger.md), a co-founder of Wikipedia itself, which is however [proprietary] (proprie ary.md) 
[NC](nc.md) license). Citizendium's goat is to improve on some weak points of Wikipedia such as its reliability or quality of writing. [Metapedia](metapedia.md) and [Infogalactic] 
infogalactic.md) are a Wikipedia forks that are written from a more [rightist] (left rignt-nd)/neutral point of view. [Infoga lactic] (infogalactic) is also a Wikipedia fork that tries to remove 

the [pseudotertist] (pseudo lert md) bullshit etc. Encyclopedia Britannica can also be used as à nice resource: its older versions are already [pub ic domain] (public domain md) and can be found 

e.g. at [Project Gutenberg](guten erg.md) ; and there is also a modern online version of Britannica which is [proprietary] (proprietary .md) (and littered with ads) but has pretty good articles 

even on modern topics (of Course facts you find there are in the public domain). Practically for any specialized topic it is nowadays possible to find its own wiki on the Internet. 


## Good And Bad Things About Wikipedia 
Let's note a few positive and negative points about Wikipedia, as of 2022. Some good things are: 


- Despite its flaws Wikipedia is still a **highly free, relatively high quality noncommercial source of knowledge for everyone**, without ads and bullshit] bs.md). It is quite helpful, 
Wikipedia may e.g. be printed out or saved in an offline version and Used in the third world as a completely frée educational resource (see [Kiwix](kiwix.md)). 


- Wikipedia **helped prove the point of [free culture](free culture.md)** and showed that collaboration of volunteers can far surpass the best efforts of corporations. 
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- Wikipedia's **website is (/used to be) pretty, nice** (at.least as of 2022), kind of minimalist, lightweight and **works without [Javascript](javascript.md)**. { Indeed as of 2023 they fucked 
it up :D It is still not as bad as other Sites but it's shit now. -drummyfish } 
- Wikipedia is very **friendly to computer analysis**, it provides all its data publicly, in simple and open formats, and doesn't implement any [DRM](drm.md). This allows to make a lot of 
research, in depth searching, collection of statistics etc. 

- Wikipedia **drives the sister projectes" some of which are extremely useful, e.g. Wikimedia Commons, Wikidata or [Mediawiki](mediawiki.md). 2 . ? 

- Even if politically biased, **Wikipedia may serve as a basis for [forks] (fork má) that fix the political bias** (E etapedia](metapedia.md), [InfoGalactic](infogalactic.md), ...). 

i Wikipedia prasyaes itself as *free encyclopedia* (as of 2023), i.e. it uses the word **"free" instead of "open"**, which is a good thing (see [free software](free software.md) vs [open source] 
open Source.md)j. 

- Though it became corrupt and censored lately, the project managed to create a relatively good encyclopedia in the past, which is still completely accessible and free, e.g. at 
https://nostalgia.wikipedia.org or internet afchive. 


And the bad things are (see also this site: http://digdeeper.club/articles/wikipedia.xhtml): 


- Wikipedia is, ** censored] (censorship md), fpelitically correct | (political. correctness.md), biased, pushes a harmful political propaganda and often. just pyre lies**, even though it [proclaims 

the opposite] (https://en.wikipedia. org/wiki/Wikipedia:What_Wikipedia_is_not#Wikipedia_is_not_censored) (which makes it much worse by misleading people). "Offensive" material and material not 

aligned with [pseudoleftist](pseudoleft.md) propaganda is removed as well as material connected to some controversial resources (e.g the link to 8chan, https://8kun.top, is censored, as well as 

{Nina Paley](nina paley.md)'s Jenndra Identitty comics and much more). There is a heavy ^ Lpssudoteft](pseudoteft md), [pgeudoskeptic](pseudoskepticism.md) and [soyence](soyence.md) bias** in 
[3 e 


he articles. It creates a list of **banned sources** ([archive](https://web.archive.org/web/20220830004126/https://en.wikipedia.org/wiki/Wikipedia:Reliable sources/Perennial sources)) which 
just removes all non-[pseudoleftist](pseudoleft.md) sources -- so much for their "neutral point of view". It wasn't always this way, browsing pre 2010 Wikipedia provides a less censored 
experience. 


-,Wikipedia includes material under jrlfair use] (fair_use.md) i", such as screenshots from proprietary games, which makes it partially Gepgpcagtary] (proprietary .md) i.e. Wikipedia, is technically 
**NOT 100% free**. Material under fair use is still proprietary and can put remixers to legal trouble (e.g. if they put material from Wikipedia tó à commercial context); even if the use on 
Wikipedia itself is legal (remember, proprietary software is legal too). 

- Wikipedia is **intentionally deceptive** -- it supports its claims by "citations" ("race is a social construct"^1234567891011121314151617181920) to make things look as objective facts, but the 
citations are firstly cherry picked (there is a list of banned sources), self-made (articles of Wikipedians themselves) and secondly the sources often don't even support the claim, they're . 
literally there just for "good look". Not only do they practice censorship, they claim they do NOT practice censorship and then write article on censorship so as to define censorship in their 
own convenient way :) Furthermore their articles intentionally omit points of view of their political opponents. 

- Wikipedia often suffers from writing inconsistency, bad structure of text and **poor Writings, in general. In a long article you sometimes find repeating paragraphs, sometimes a_lot of stress 
is put on one thing while mentioning more important things only briefly, the Level of explanation expertness fluctuates etc. This is because in many articles most people make small contributions 
without reading the whole article and without having any visions of the whole. And of course there are many contributors without any writing skills. 

- Wikipedia is **too popular** which has the negative. side effect of becoming a **political battlefield**, This is one of the reasons why there has to be a lot of **bureaucracy**, including 
things such as **locking of articles** and the inability to edit everything. Even if an article can technically be edited by anyone, there are many times people watching and reverting changes on 
specific articles. So Wikipedia can't fully proclaim it can be "edited by anyone". 

- Wikipedia.is **hard to read**. The articles go to great depth and.mostly even simple topics are explained with a great.deal of highly technical terms so that they can't be well understood by 
people outside the specific field, even if the topic could be explained simply (Simple English Wikipedia tries to fix this a little bit at least). Editors try to include as much information as 
ossible which too often makes the main point of a topic drown in the blablabla. Wikipedia's style is also very formal and "not [fun] (run md) to read, which isn't bad in itself but it just is 
boring to read. Some alternative encyclopedias such as [Citizendium](citizendium.md) try to offer a more friendly reading style. Back in the day Wikipedia used to be written pretty well, check 
it out e.g. at https://nostalgia.wikipedia.org. 

- Wikipedia, is, **not [Publig domain] (public_domain md **, It is licensed under [CC-BY-SA](cc by sa.md) which is a [free](free_culture.md) license, but has a few burdening conditions. We belive 
knowledge shouldn't bé owned or burdened by any conditions. 

- Even though there are.no ads, there regularly appears **political propa anda**, main page just **hard pushes [feminist](feminism.md) shit** as featured images and articles, there appear popups 
for LGBT/feminist activism, and of coursé all articles are littered wit fpseudolertist (psetdoleft.md) propaganda etc. 


- **Many articles are bought e there exist companies that offer editing and maintaining certain articles in a way the client desires. and of course. corporations and politicians take this n 
oppor tunity -- of course Wikipedia somewhat tries to prevent it but no prevention ever works 100%, so a lot of information on Wikipedia is either highly misleading, untrue, censored or downright 
abricated. 


## Fun And Interesting Pages 
There are many interesting and entertaining pages and articles on Wikipedia, some of them are: 


**unusual articles**: https‘ renspikipedia;orgewiki Wikipedia unusu&l.artic les 

**don't delete the main page**: https://en.wil ipedia orgéwiki/Wikipedia:DonX27t delete the main page 
**Wikipedia records**: https://en.wikipedia.org/wiki/Wi ipedia:wikipedia records 

**longest pages**: https://en.wikipedia.org/wiki/Special: ongPages 

**special pages** i https://en.wikipedia.org/wiki/Special:SpecialPages 

**list of lists of lists**: https://en.wikipedia.org/wiki/List of lists of lists 

**current events**: https://en.wikipedia.org/wiki/Portal:Current events 


## Alternatives 


Due to mass censorship and brainwashing going on at Wikipedia it is important to look for alternatives that are important especially when researching anything connected to politics, but also 
when you just want a Simpler, more condensed explanation of some topic. This is a comparison of Wikipedia and some of its alternatives, as of 2023: 


{ See also old Wikipedia at https://nostalgia.wikipedia.org/wiki/Race. -drummyfish } 


| encyclopedia license comment 

| Wikipedia] (wikipedia.md) CC BY-SA biggest, mainstream, **EXTREME CENSORSHIP AND PROPAGANDA** 

| old wikip.](https://nostalgia.wikipedia.org/wiki/HomePage) GFDL archived old Wikipedia, less censorship 
|[Citizendium](citizendium.md) PROPRIETARY? (CC BY-NC-SA)| similar to Wikipedia, probably censored as well, faggots have unclear 
icense 

L Metapedia] (metapedia.md) GFDL Wikip. fork, no SJW censorship, ATM limited account creation, "pro- 
üropean" fascism | 

1 Infogalagtic] (infogalactic md) CC BY-SA Wikip. fork, no SJW censorship, **FOR PROFIT** (you can buy article 
Ontrot lol), Can't make accounts | 

| installgentoo wiki](https://wiki.installgentoo.com) "public domain" mostly tech, seems very uncesored 

| Britannica online] (https://www.britannica.com/) PROPRIETARY proprietary, bloated, has ads, but nicely written 

| Britannica 1910](https://www.gutenberg.org/ebooks/search/?query=Britannica) public domain very old but large and completely free, without any modern propaganda 
| WikiSpooks] (wikispooks.md) CC BY-SA no SJW censorship, seems only focused on politics 

| LRS wiki](lrs wiki.md) cco best encyclopedia 

| Conservaedia] (conservapedia.md) PROPRIETARY American fascist wiki, has basic factual errors 

| [Encyclopedia Dramatica](dramatica.md) cco informal/fun/"offensive" but valuable info (on society, tech, ...), 

basically no censorship, no propaganda 

| Tor Hidden Wiki] (http: //zqkt lwiuavvvqqt4ybvgvi7tyo4hj l5xgfuvpdf6otjiycgwqbym2qad. onion) PROPRIETARY Deepweb wiki on [Tor](tor.md), probably less censored. 


TODO: darknet wikis 
## See Also 


Wa led [wal md) 

Intellipedia] (intellipedia.md) 
Citizendium](citizendium.md) 
Infogalactic]|(infogalactic.md) 
wikiwikiweb] (wikiwikiweb.md) 


---------- Wiki rights.md ---------- 
# LRS Wiki Usage Rights 


This page serves to establish usage rights for the whole LRS wiki. It is here to be part of the work so that the legal rights are always clear, even if e.g. the README gets lost somewhere along 
e way. 


Everything on this wiki has been created from scratch solely by people listed in, [wiki authors] wiki authors.md). Great care has been taken to make sure no copyrighted content created by other 
people haS been included in any way. This is because one of the goals of this wiki is to be completely in the public domain world wide. 


Each contributor has agreed to release the whole LRS Wiki under the Creative Commons Zero 1.0 (CCO 1.0) waiver, available at https://creativecommons.org/publicdomain/zero/1.0/, with an 
additional option for you to also freely choose the following waiver instead: 


The intent of this waiver is to ensure that this work will never be encumbered by any exclusive intellectual property rights and will always be in the public domain world-wide, i.e. not putting 
any restrictions on its use. 


Each contributor to this. work agrees that they waive any exclusive rights, including but not limited to gopyright, patents, trademark, trade dress, industrial design, plant varieties and_trade 
secrets, to any and all ideas, Concepts, processes, discoveries, improvements and inventions conceived, discovered, made, designed, researched or developed by the Contributor either solely or 
jointly with others, which relate to this work or result from this work. Should any waiver of such right be judged legally invalid or ineffective under applicable law, the contributor hereby 
grants to each affected person a royalty-free, non transferable, non sublicensable, non exclusive, irrevocable ànd unconditional license to this right. 

---------- Wiki style.md ---------- 

# Wiki Style 


This outlines the style and rules of this Wiki that should ensure "quality" and consistency. You should read this before contributing. 
If you contribute, add yourself to [wiki authors](wiki_authors.md)! You can also join us on the [Island](island.md). 
## Rules 


1. **Everything is fpublic domain] (public_domain.md)** under [CCO](ccO.md) to which all contributors agree. No one owns what we write here. 

2. **No [fair use](fair use,md)** or. even unfrair use. We want this Wiki to be as free as possible and don't thread the fine legal lines. That means you can't directly include anything on this 
Wiki if it's copyrighted, **evén if it's under a free license**. So generally **avoid any Copy pasting and rather try to write éverything yourself**. 

3..**NO unnecessary [censorship](censorship.md)**, Necessary Censorship basically only includes. spam, shitty content, [7P](intellectual_property.md)-infected content (content that would make 
this wiki not be in uo ie domain) and hardcore illegal stuff that would immediately put us in jail. However spreading truth mustn't be hurt by fear of jail. Controversial/incorrect/taboo 
content etc. is NOT to be censored. 


## Style 


: SUDORE. Hirie-break paragraphs** (a pragraph is on a single line). The reasoning is that a text manually formatted to specific width is hard to edit. It's easier to switch to auto-line breaking 
in your editor. 
- **Avoid [unicode] (unicode md), highly prefer [ASCII](ascii.md)**, for the sake of maximum compatibility and simplicity. Use of unicode has to be greatly justified. 
**Each page shall start with a heading** (which may not correspond to article file name). 

I've finally decided that with certain exceptions eadings should be written like this: **Each Word Of A Heading Is Capitalized**. This is for simplicity. 
**Filenames of articles shall use a lowercase snake case**. ; : "n , 3 
.**Article/file names are to be preferably singular nouns**. I.e. "animal" rather than "animals", nportabitity’ rather than "portable" etc. But there may be exception, e.g. articles that are 
Dicis may use plural ("human" is about humàn as species, "people" is a list of existing humans), non-nous MAY be used if nouns would be too long/awkward (e.g. "weird" instead of "weirdness"). 

se your brain. 
- **This isn't [pi ipedia](wikipedia.md)", memes, opinions and uncensored truths are allowed (and welcome). ; 4 > 
- The style of this wiki is inspired by the classic hacker culture works such as the [Hii kiweo | Cul kiwi kaweb ma) and [Jargon File] (jargon_file.md) . 
- nyariting style should be relaxed and in many parts informal**. Formality is used where it is useful (e.g. definitions), most of other text can benefit from being written as a tech 
conversation among friends. 
-.**Depth/complexity/level of articles**: Articles shouldn't try to go to unnecessary depth, but also shouldn't be shallow. This is written mainly for, programmers of {less retarded society] 
(less_retarded_socitty md), the complexity should follow from that. Again, start simple and go more into depth later on in the article, very complex things should rather be explained 
intuitively, no need for complex proofs etc. 
- **Political incorectness, slurs and "offensive speech" is highly encouraged**. Avoid the use of the word "person" (use "man", 
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"guy", " " 


"human", "one" etc., possibly "individual" at worst). Of 


course this is not to "offend" anyone, this helps people unlearn being offended.. f : i . " : 
- **Images**: for now don't embed images. [ASCI artlfaseii-art.md) càn be used in many places instead of an image. Thousand words are worth a picture. Non-embedding links to images may be okay. 
- **You can leave comments right in the text of articles**, e.g. like this: { I disagree with this [shit](shit.md). ~drummyfish }. 


Articles should be written to be somewhat readable and understandable to tech savvy people who already know something about technology, i,e. not only experts (as is sometimes the case e.g. on 
Wikipedia). **Each article should ideally start with a general dictionary [definition] (der inition.me ) * and continue with a simple géneral explanation and overview of the topic. With mor 
paragraphs the text can get more complex. The idea is that a noob will read the first paragraph, understand the basic idea and take something away. A more advanced reader will read further on 
and take away more things etc. I.e. we educate in a top-down approach. 


## Sources 
These are some sources you can use for research and gathering information for articles: 


- **[Wikipedia](wikipedia.md)**: of course, but don't limit your search to it. Searching other language Wikipedias with machine translate can also help find extra info. 

- **[Citizendium](citizendium.md)**: can offer a different angle of view from Wikipedia. 

- **non-SJW forks of Wikipedia**: to get past SWJ censorship/propaganda on Wikipedia try MAR [infogalactic](infogalactic.md) or [metapedia](metapedia.md). 

- **Britannica online**: proprietary; but articles are nicely written, facts are in the public domain so we can steal them. d $ $ , E 

- **Archives: [Internet Archive](internet archive.md), [Archive Team Wiki](https://wiki.archiveteam.org/), [archive li] Ent tps sz" archive 1/4); ...**: Most information once available on the 

Internet is most likely no longer accessible nowadays (taken down, privatized, censored, no longer indexed, ...). Look in the archives! 

- **[wikiwikiweb](wikiwikiweb.md)** 

Simp tity Craby «im ), marginalia and other non-commercial search engines**: this will find nice small non-commercial sites of tech and other nerds that Google suffocates under bloatsites (or 

simply censors 

- **[Project Gutenberg] ( utenberg.md)**: mostly older books but there are already some computer related books like [RMS S | {rms md) biography or [Jàr on File](jargon file.md) 

pnp/University theses (and scientific paper of course): many university theses are publicly accessible and usually nicely sum up topics, bachelor level theses may be better understandable than 
master théses. 

- **Slides**: slides from various presentations are actually great resources as they condense the topic into its main points, they filter out the piles of noise. 

- **Wikisource** and **Wikibooks** 

- **[Metapedia](metapedia.md)**, **[Infogalactic](infogalactic.md)** etc. 

- **[books](book.md)**: Books are still of higher quality than online sources so you can [pirate](piracy.md) some and steal some facts from them. Check out libgen, torrents etc. 

- **[insta entoowiki] (https. //MIKi insta Plgentoo com) 

- ** YouTube] (youtube -m )**: Yes, sadly this is nowadays one of the biggest sources of information which is unfortunately hidden in videos full of ads and retarded zoomers, the information is 

unindexed. If you are brave enough, you can dig this information out ahd write it here as a proper text. 

- Try searching with different search engines than just Google (wiby, marginalia, Yandex, Bing, Yahoo, Internet Archive, ...). 

- **Non-web**: When web fails, you can search the [ arknet](darknet) hd), gopher ] (gopher md), f gemini] (gemini.md), [usenet](üsenet.md), [tor](tor.md) etc. 


## Purpose 
Basically the purpose of this wiki is to have fun and also create a coherent and consistent philosophy of a truly good software, technology and also to a related degree society. 
Additionally we want to create a nice, completely public domain, suckless educational resource, an encyclopedia that's written in a nicer style than e.g. Wikipedia. 


Another goal.is to serve as a historical account of our age. We, suppose that people in the future may want to read first-hand accounts of how people saw the society and its technology, what they 
thought was important, what they predicted etc. We like to do this ourselves thanks to e.g. Project Gutenberg. Kids in the future will be like "haha those idiots couldn't see they would bloat 


themselves to death", this Wiki will show that indeed we foresaw it, we were just in a huge minority. Future kids: don't repeat the same mistakes we did. 
wikiwikiweb.md ---------- 
# WikiWikiWeb 


Wikiwikiweb (also *c2 Wiki* or just *Wiki*) was the first ever created [NET] (wiki md) (user.editable) website, created in 1995 in Pert} (pert.md) by {ward Cunningham] (cunningham md) - It was 
focused on [software engineering](sw enginéering.md) and computer technology in general but included à lot of discussion and pages touching on other’ topics, e.g. those of politics, humor or nerd 
and [hacker ](hacking.md) culture. The principles on which this site worked, i.e. allowing users to edit its pages, greatly influenced a lot of sites that came after that are now generally called 
[wikis](wiki.md), of which most famous is [Wikipedia](wikipedia.md). The style of WikiWikiWeb was partly an inspiration for our [LRS wiki](lrs wiki.md). 


It had over 36000 pages (http://c2.com/cgi/wikiPages). Since 2014 the wiki can no longer be edited due to vandalism, but it's still online. It was originally available at 
http://www.c2.com/cgi/wiki, how at http://wiki.c2.com/ (sadly now requires [JavaScript](js.md), WTF how is this a hacker site???). 


The site's engine.was kind of [suckless](suckless.md)/[KISS (kiss md) even_Wikipedia looks bloated] (bloat md), compared to it. It was pure unformatted ]ETML] (html. md) that used a very clever , 
system of [hyper Links] (hyper text md) between article$: any amelCasé](camelcase.md) multiword in thé text was interpreted as à link to an article, so for example the word 'SoftwareDevelopment 
was Bera nds a_link to a page called *Software Development*. This presented a slight issue e.g. for single-word topics but the creativity required for overcoming the obstacle was part of 

, 


the [fun] (fun.md for example the article on [C](c.md) was called ~CeeLanguage’. 


Overall the site was also very different from [Wikipedia](wikipedia.md) and allowed informal comments, jokes and subjective opinions in the text. It was pretty entertaining to read. There's a 
lot of old hacker wisdom to bé found there. 


There are other wikis that work in similar spirit, e.g. CommunityWiki (https://communitywiki.org, a wiki "about communities"), MeatBallWiki (http://meatballwiki.org/wiki/) or EmacsWiki. 
## Interesting Pages 
These are some interesting pages found on the Wiki. 


**CategoryCategory**: List of categories of pages. 

**CategoryHumor**: Humorous pages. 

**ComputerGame** 

**ExtinctionOfHumanity**: Discussing end of humanity and a possible [collapse](collapse.md) . 

**GameOfChess**: About [chess](chess.md). 

**LanguageGotchas** 

**WeirdErrorMessages** 

**WikiwikiWebFaq* 

**WithinTwentyYears**: Mostly pre-2005 predictions about what technology would be like in 20 years, a lot of hits and misses. 
**wikiHistory** 


## See Also 


- [Jargon bile] jargon-fi te.md) 
Wikipedia] (wikipedia.md) 
T windows.md ---------- 
# Micro$oft Window$ 


Microsoft Windows is a series of malicious, [bloated](bloat.md) [proprietary](proprietary.md) "[operating systems](os.md)". AVOID THIS [SHIT](shit.md). 


## Versions 


# Wizard 


Wizard is a male [virgin] (virgin.md) who is at least 30 years old ([femate]Cfemate.md) virgins. of Such. age haven't been seen yet). The word is sometimes also used for a man who's just very good 
with [computers](Compüter.md). Thesé two sets mostly overlap so it rarely needs to be distinguished which meaning we intend. 


There is an [imageboard](imageboard.md) for wizards called ["izardchan] (wizchan.md) . It is alright but also kind of sucks, for example you can't share your [art](art.md) with others because of 
stupid anti- doxsing](dox mdj rules thát don't even allow tó dox yourself. 


## See Also 


- [incel](incel.md) 

volcel](volcel.md) 
atta! woman.md ---------- 
# «3 Woman <3 


A woman (also,girl, gril, gurl, femoid or succubus) is one of two genders (sexes) of humans, the other one,being [mand (gen, md , Women.are cute]|(cute,md (sometimes) but notoriously bad at 
programming reden" marks [math](math.md) and [technology] (techno logy .md) : in the field they usually "work n [bullshit](bullshit.md and mostly [harmful](harmful.md)) positions such as 
e m 


diversity artment", arketing](marketing.md), [HR] (human resources md) ^. [UI](ui.md)/[user exper tence | (ux md), or as a [token](token.md) girl for media. I they get close to actual 
technology, their highest "skills" are mostly limited to casual "[coding](coding.md)" (which itself is a below-average form o programming](programming.md)) in a baby language such as [Python] 
(python, md) [Javascript](javascript.md) or Trust] (rust md): Mostly they are just hired for quotas and make coffee for men who do the real work (until TV cameras appear). Don't let yourself be 
ooled by he propaganda, women have always been bad with tech. 


Historically women have been privileged over men -- while men had to [work] (work md) hard, go to [wars] (war md), explore and hunt for food, women often weren't even supposed to work, they could 
stay at home, chill while guarding the fire and playing with children -- this is becoming léss and less so wit [capitalism] (capitalism.md) which aims to simply enslave everyone, nowadays mostly 
through the feminist] (reminism:m ) cult that brainwashed women to desire the same slavery as men. Statistically women live about 5 years longer lives than men because they don't have to worry 
and stress so much. 


Women also,can't drive, operate machines, they, can't compare even to the worst men in sports, both physical and mental such as [chess [chess,md). Women have to have.separate leagues and more 
relaxed rules, e.g. the title Woman Grand Master (WGM) ih chess has far lower requirements to obtain than regular Grand Master (GM). cording’ to [E Lo] (eto. md) rating the best woman chess 
player in history would have only 8% chance of winning against current best male who would have 48% chance o winning) On the İnternational Mathematical Olympiad only 43 out of 1338 medals were 
obtained by females. There are too many funny cases and video compilations of women facing men in sports (watch them before they're censored lol), e.g. the infamous Vaevictis female "progaming" 
team or the [football](football.md) match between the US national women team (probably the best women team in the world) vs some random under 15 years old boy's team which of course the women 
team lost. Of course there are arguments that worse performance of women in mental sports is caused culturally; women aren't led so much to playing chess, therefore there are fewer women in 
chess and so the probability of a good woman player appear ing is lower. This may be partially true even though genetic factors seem at least equally important and it may equally be true that not 
so many women play chess simply because they're not naturally good at it; nevertheless the fact that women are generally worse at chess than men stands, regardless of its cause -- a randomly 
picked men will probably be better at chess than a randomly picked woman, and that's what matters in the end. Also if women are displaced from chess by culture, then what is the area they are 
displaced to? If women are as capable as men, then for any area dominated by men there should be an area equally dominated by women, however we see that anywhere men face women men win big time, 
even in the woman activities such as gogking, TE makes sense from the evolutionary standpoint, women simply evolved to take care of children, guard fire and save resource consumption by being 
i 


only as strong as necessarily required for S task, while men had to be stronger and smarter to do the hàrd job of providing food and protection. 


Now because today's brainwashed reader will see this as [gexism](sexism md)", let us remind ourselves that this is completely OK. Women, are weaker, but in a [good society] . 
(less retarded society.md) this doesn't matter as in a good society people don't have to compete or prove their usefulness, everyone is loved equally, weak or Strong. The issue here is not 
pointing out our differences but perpetuating a [shitty society](capitalism.md). 


Of course even though rare, well performing women may statistically appear. The issue is women are very often involved with a cult such as the [feminists] (feminism.md) who waste their effort on 
[fighting](fight culture.md) men instead of focusing on study and Creation of real technology, and on actually loving it. They don't see technology as a beautiful field of art and science, they 
see it as a battlefield, a political tool to be weaponized to achieve social status, revenge on society etc., which spoils any rare specimen of a capable woman. Even capable women can't seem to 
understand the pure joy of [programming] (pro ramming.md), the love of creation for its own sake, they think more in terms of earning to COOODE will get me new followers on social networks" 
etc. Woman mentality is bio ogically very different from men mentality l OV : 
(which is understandable from evolutionary point of view as women had to ensure choosing a good father for their offspring); men, even if cheating, hormally tend towards deep tafe. tong ove 
relationships, be it with women or art. You will never find a virgin basement dweller programmer or [demoscene] (demoscene. md) programmer of female sex which isn't a poser, a [hacker](hacking.md) 
who is happy existing in a world of his own programs without the need for approval or external reward, a woman will likely never be able to understand this. 


a woman is normally not capable of true, deep and passionate ve, woman only thinks in terms of benefit, golddigging etc. 


Supposed "achievements" of women after circa 2010 can't be taken seriously, [propaganda] (propaganda md) has started to tryhard and invent and overrate achievements and basically just.steal 
achievements of men and hand them over to women. There are [token](token.md) women inserted on [soyentific](soyence.md) pósitions etc. (lol just watch any recent [NASA] (Rasa mdy mission 
broadcast, there is always a woman inserted in front of the camera). 


of course, [LRS](lrs.md) loves all living beings equally, even women. In order to truly love someone we have to be aware of their true nature so that we can truly love them, despite all 
imperfections. 

**Is there even anything women are better at than.men?** Well, women seem for example more peaceful or at least less violent on average (feminism.of course sees this as a "weakness" and tries to 
change it), though they seem to be e.g. more passive: ag ressive. Nevertheless there have been a few successful queens in history, womén Can sometimes perhaps be good in representative roles (and 
other simple chair-sitting jobs). They have also evolved to perform the tasks of housekeeping and care taking at which they may excel (still it seems that if men fully focus on a specific tasks, 
they will beat women: for example the best cooks in the world are men). Sometimes women may be preferable exactly for not being as "rough" as men, e.g. as singers, psychologists, massage 
therapists, sex workers etc. 
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lol http://www.menarebetterthanwomen.com 


## Women In Tech/Science 


Finding famous women,capable in technology is almost a futile task. One of, the most famous women of [modern](modern.md) tech, even though more an entrepreneur than engineer, was, [Elizabeth 
Holmes} (elizabeth nones ing) who, to the feminists' dismay, turned out to be a complete fraud and is now fa ang criminal charges. [Gracé Hopper](grace_hopper) (not "grass hopper" tot) is a woman 
actually worth mentioning for her contribution to programming languages, though the contribution is pretty weak. [Ada Lovelace](ada lovelace.md) cited by the feminist propaganda as the "first 


programmer" also didn't actually do anything besides Scribbling a note about a computer completely designed by a man. This just shows how desperate. the feminist attempts at finding capable women 
in tech are. Then there are also some individuals who just contributed to the downfall of the tec nology who are, in terms of gender, at least partially on the woman side, but their actual 
classification is actually pretty debatable -- these are monstrosities with pink hair who invented such [cancer](cancer.md) as [cocs](coc.md) and are not even worth mentioning. 


In the related field of [free gut ture (tree culture.md) there is a,notable woman, [Nina Paley] (nin 
l 


e 1 e. nota paley.md), that has actually done some nice things for the promotion of free culture and also 
standing against the [pséudoleftist](pSeudoleft.md) faScism by publishing a series of comics with 


a. 
a character named Jenndra Identitty, a parody of fascist trannies. 
In [science](science.md) at wide we occasionally find a capable woman, for example Marie Curie. 

## Men Vs Women In Numbers 


Here is a comparison of men and women in Some randomly chosen disciplines and measures that are easy tp quantify by numbers, and still possible to find on the highly censored Internet. Of 
course, the numbers hold for the time of writing of this text, at the time or reading they may be slightly outdated, also keep in mind that in the future such comparisons may become much less 
objective due to [530] (sw md) forces -- HTE because of [trans] (tranny md) athletes in sports we may see diminishing differences between measurements of performance of men and "women" because 
what in the future wi e called women will be just men pretending to be women. 


Note: It is guaranteed that [soyentific](soyence.md) BIGBRAINS will start screeching "MISLEADING STATISTICSSSSSSS NON.PEER REVIEWED". Three things: firstly.chill your balls, this isn't a 
scientific paper, just a fun comparison of Some numbers. Secondly we try to be benevolent and not choose stats in a biased way (we don't even have to) but it is not easy to find better 
statistics, e.g. one might argue it could be better to compare averages or medians rather than bests -- indeed, but it's impossible to find average performance of all women in a population in a 
specific sport discipline, taking the best performer is simply easier and still gives some idea. So we simply include what we have. Thirdly any statistics is a simplification and can be seen as 
misleading by those who dislike it. 


On average, male brain weights 10% more than woman's and has 16% more brain cells. [IQ](iq.md)/intelligence measured by various tests has been consistently significantly lower than that of men. 


discipline men WR women WR comparison 

200m outdoor 19.90s (Bolt) 21.34s (G-Joyner)|best W ranks lower than 45769 among M 
60m indoor 6.34s (Coleman) 6.92s (Privalova)|best W ranks lower than #3858 among M 
raw deadlift 460kg (Magnusson) |305kg (Swanson) best M lifts about 50% more weight 
marathon 2:01 (Kipchoge) 2:14 (Kosgei) best W ranks #3935 among men 

100m frees. swim|46.8s (Popovici) 51.7s (Sjostrom) best W ranks lower than #602 among M 
chess 2882 Elo (Carlsen)|2735 Elo (Polgar)|best W win 8%, lose 48%, draw 44% 
speedcubing 3x3 |3.47s (Du 4.44 (Sebastien) |best W ranks #16 among [/] 

Starcraft II 3556 (Serral 2679 (Scarlett) best M has ~80% win chance against W 
holding breath 24:37 (Sobat 18:32m (Meyer) Ms have ~35% greater lung capacity 


wetter cess work.md ---------- 


*Work is a glorification of [slavery](slavery.md).* 


Work is an unpleasant effort that one is required to suffer, such as harvesting crops or [debugging](debugging.md) computer programs. Work hurts living beings and takes away the meaning of their 
lives, it destroys their bodies and minds. Work makes us slaves, it wastes our lives and is a Càusé of a rgé number of [suicides](suicide.md) -- many consider it better tó die than tó work. 
One of the main goals of civilization is to eliminate any need for work, i.e. create machines that will do all the work for humans (see [automation](automation.md)). 


While good Pociery tries to eliminate work [capitalism] (capitalism.md) aims for the opposite, i.e. artificially creating bullshit jobs and bullshit needs so as to keep everyone enslaved to the 
System. Fortunate y movements such as the fantiwork](antiwork.md) movement try to oppose this, however masses have already been brainwashed to be hostile to such movements and instead demand 
their own enslavement. 


[Dea ertum? ae it as essential to start educating people about the issue as well as starting to eliminate jobs immediately with things such as [automation](automation.md) and [universal basic 
incóme](übi:md). 

T1 world broadcast.md ---------- 

# World Broadcast 


{ I don't know too much about radio transmissions, please send me a mail if something here is a complete BS. ~drummyfish } 
*WIP!* 


World (or Wor id-wide) [broadcast](broadcast.md) is a possible [technological](tech.md) service (possibly complementing the, [Internet](internet.md)) which could be implemented in_a [good society] 
(less retarded society.md) and whose main idea'is to broadcast generally useful [information](information.md) over thé wholé globe só that simple’ and/or energy saving [computers](cómputer.md) 
could get basic information without having to perform complex and costly two-way communication. 


It would work on the same principle as e.g. [feletext ] (teletext md): there would be many different [rdiol(radio.md) transmitters (e.g. towers, satellites or small radios). that would. constantly 
be broadcasting generally useful information (e.g. timè or news) ih a very simple forma something akin téxt in [Morse code](morsé códe.md)). any device capable of receiving radio signal could 
wait for desired information (e.g. waiting for certain keyword such as ^TIME:' or "NEWS:') and then save it. The advantage would be [simplicity] ( iss.md): unlike with [Internet](internet.md) 
(which would of course still exist) the device wouldn't have to communicate with anyone, there would be no servers communicating with the devices, there would be no communication protocols, no 
complex code, no [DDOS] (ddos md -like over loading of servers, and the receiving devices wouldn't waste energy (as transmitting a signal requires significant energy compared to receiving it -- 
like shouting vs just listening). It would also be more widely available than Ínternet connection, e.g. in deserts. 


World of Warcraft (WoW) is an AAA [proprietary](proprietary.md) [game](game.md) released in [2004](2004.md) by [Blizzard](blizzard.md) that was one of the most successful and influencing games 
among [MMORPGs ](mmorpg.md) . 


There is a. TORS] {Foss md) implementation of WoW server called [MaNGOS](mangos.md) that's used to make private servers. The client is of course proprietary and if you dare make a popular server 
Blizzard witl ki your grandmother and rape your children. 


{_ The classic WoW (some time until the end of WOTLK) lied somewhere in the middle between good old and shitty [modern] (medern md games (the WoW of today is 100% shit of course). For me the peak 
of Warcraft was [Warcraft III:TFT](warcraft.md), it was perfect in every way (except for béing proprietary and bloated of course). As a great fan of WarCraft III, seeing WoW in' screenshots my 
fantasy made it the best game possible to be created. When I actually got to. laying it it was really good -- some of my best memories come from that time -- nevertheless I also remember being 
disappointed in many ways. Especially with limitation of freedom (soulbound items, forced grinding, effective linearity of leveling, GMs preventing hacking the game in fun ways etc.) and here 

E 


and ere a lack of polish (there were literally visible unfinished parts of the map, also visual transitions between zones too fast and ugly and the overall world design felt kind of bad), 
laziness and repetitiveness of the design. I knew how the gene could be fixed, however I also knew it would never be fixed as it was in hands of a corporation that had other plans with it. That 
was the time I slowly started to see things not being ideal and the possibility of a great thing going to shit. ~drummyfish } 

TL www.md ---------- 

# World Wide Web 

World Wide Web (www or just *the web*) is (or was -- by 2023 mainstream web is dead) a network of interconnected documents on the [Internet](internet.md), which we call *websites* pr, webpages: 
Webpages are normally written in the [HTML](html.md) [language](language.md) and can refer to each other by [hyperlinks](hyperlink.md) ("clickable" links right in the text). The web itself works 
on top of the [HTTP](http.md) protocol which says how clients and servers communicate. Some people confuse the web with the Internet, but of course those people are retarded: web is just one of 


many so_called services existing on the Internet (other ones being e.g. [email](email.md) or [torrents](torrent.md)). In order to browse the web you need an Internet connection and a [web 
browser ] (browser .md). 


t **How to browse the web in the [age of shit](21st_century.md)?** Currently my "workflow" is following: I use the [bagwo lf] (badwolf md browser (a super suckless, very fast from-scratch browser 
hat allows turning JavaScript on/off, i.e. I mostly browse [small web) (Smo _internet.md) without JS but can still do banking etc.) with a **CUSTOM START PAGE** that I completely own and which 
only changes when want it to -- this start page is just my own tiny ML on my disk that has links to my favorite sites (which serves as my suckless "bookmark" system) AND a number of search 
bars for different search engines (Google, Duckduckgo, Yandex, wiby, Searx, marginalia, Right Dao, ...). This is important as nowadays you mustn't rely on Google or any other single search 
engine -- I just use whichever engine I deem best for my request at any given time. ~drummyfish } 


An ampgr tang pant ony ene web is also searching its vast amounts of information with [search engines](search_engine.md) such as the infamous [Google](google.md) engine. It also relies on systems 
such as ns.md). 


Tainitream web igon EXTREMELY bloated and practically unusable, for more [suckless](suckless.md) alternatives see [gopher](gopher.md) and [gemini](gemini.md). See also [smol web] 
smol internet.md). 


The web used to .be.perhaps the greatest part of the web, the thing that, made Internet widespread, however it quickly deteriorated by capitalist mainstreamization, and, commercialization_and by 
now, in 2020s, it is one of the most illustrative, depressing and most hilarious examples o [capitalist] (capita lis ..software.md) b loat](bloat.md). A nice article about the issue, called *The 
Website Obesity Crisis*, can be found at https://idlewords.com/talks/website obesity.htm. There is a tool for measuring a website bloat at https://www.webbloatscore.com/: it computes the ratio 
of the page size to the size of its screenshot (e.g. [YouTube](youtube.md) currently scores 35.7). 


## How It Went To Shit 


(anarchism,md) and often even fcommunist ] (communism md) 
ult to implement and mostly non-existent’ and websites Used 
, MUCH faster and more robust as they were pure [HTML 

e iv 


Back in the days (90s and early 2000s) web used to be a.place of freedom working more or less in a decentralized manner, on [anarchist] 
à by passionate nerds who had a crea e freedom and lus 


principles -- people used to have their own unique websites where they shared freely and openly [censorsnip | (censorship mo) was diffi 
to have a much better design, were [KISS](kiss.md), safer, "open" (no paywalls, registration walls country ocks [DRM] Corm md) acia) 
(heal. md documents. It was also the case that most websites were truly hice, useful and each one had a "soul" as they were usua ly mad: 
lesires to create a nice website (yes, even if they were making a commercial website for some company). 


As the time marched on web used to become more and more [shit](shit.md), as is the case with. everything touched by [gapitalist |(capitalist_software md) hand -- the advent of so called **web |. 
2.0** brought about a lot of [comp Lexa ty (complexity: md); websites started to incorporate client-Side Scripts ([JavaScript](javascript.md), [Flash](flash.md), [Java](java.md) applets, ...) which 
led to many negative things such as incompatibility with browsers (kickstarting browser consumerism and [update culture](update_culture.md n performance loss ànd security vulnerabilities (web 
pages now ecame Turing complete programs rather than mere documents) and more complexity in web browsers, which leads to immense [bloat oat.md) and browser monopolies] (bloat monopoly md) 
(greater effort is needed to develop a browser, making it a privilege of those who can afford it, and those can subsequently dictate de-facto standards that further streng hen their monopolies). 
Another disaster came with **[social networks](social network.md)** in mid 2000s, most notably [Facebook] (Facebook. md) but also [YouTube ] youtube smd); [witter] (twitter -m ) and others, which 
centralized the web and rid people of control. Out of comfort people stopped creating and hosting own websites and rather created a page on Facebook. This gave the power to corporations and 
allowed **mass-surveillance**, **mass-censorship** and "Brgeaganda brainwashing**. Às the web became more and more popular, corporations and governments started to take more control over it, 
creating technologies and laws to make it less free. By 2020, the good old web is but a memory and a hobby of a few boomers, everything is controlled by corporations, infected with billions of 
unbearable ads, [Dem] (drm-md), malware (trackers, [crypto](crypto.md) miners, ...), there exist no good web browsers, web pages now REQUIRE JavaScript even if it's not needed in principle due to 
which they are painfully slow and buggy, there are restrictive laws and censorship and de-facto laws (site policies) put in place by corporations controlling the web. 


Mainstream web is quite, literally_unusable nowadays. What people searched for on the web they.now search.on on a handful of platforms like Facebook and, YouTube foften not_even using a_web 
browser but rather a mobile "[app](app.md)"); if you try to "google" something, what you get is just a list of unusable sites written by [AIs](ai.md) that load for several minutes tuntess you 
have the latest 1024 TB RAM beast) and won't let you read beyond the first paragraph without registration. These sites are uplifted by {st0](seo.md) for pure commercial reasons, they contain no 
useful information, just ads. Useful sites are buried under several millions of unusable results or downright censored for political reasons (e.g. using some forbidden word). Thankfully you can 
still try to browse the [smol web](smol internet.md) with search engines such as [wiby](wiby.md), but still that only gives a glimpse of what the good old web used to be. 


## History 


World Wide Web was invented by an English computer scientist [Tim Berners-Lee](berners lee.md). In 1980 he employed [hyper Links] (hy ep Tink md) in a notebook program called ENQUIRE, he saw the 
idea was good. On March 12 1989 he wàs working at [CERN](cern.md) where he proposed a system Called "web" that would use [hyper ex i {hyper tex .md) to link documents (the term hypertext was 
already around). He also considered the name *Mesh* but settled on *World Wide Web* eventually. He started to implement the system with a few other people. At the end of 1990 they already had 
implemented the [HTTP](http.md) protocol for client-server communication, the LATHE Chem! smd) 7 language for writing websites, the first web server and the first [web browser](browser.md) called 
*WorldWideWeb*. They set up the first website http://info.cern.ch that contained information about the project. 


In 1993 CERN made the web [public domain] (pub lic-domain.md), free for anyone without any licensing requirements. The main reason was to gain advantage over competing systems such as [Gopher] 
(gopher md) that were [proprietary](propr Tetary.md): By 1994 there were Over 500 web servers around the world. Www Consortium ([W3M](w3m.md)) was established to maintain standards for the web. A 
number of new browsers were written such as the text-only [Lynx](lynx.md), but the [proprietary proprietary md) Netscape Navigator ](netscape_navigator.md) would go to become the most popular 
one until [Micro$oft](microsoft)'s [Internet Explorer](internet_explorer.md) (see [browser wars rowser_wars.md) In 1997 [Google](google.md) search engine appeared, as well as [CSS](css.md). 
There was à economic bubble connected to the explosion of the Web called the [dot-comm boom] (dot_com_boom.md) . 
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Between 2000 and 2010 there used to be a mu 


a alternative to the web_called [WAP] (wap -md) a Back then mobile phones. were significantly weaker than PCs so the whole protocol was simplified, e.g. 
it had a special markup language called [WML ](html.md). e el 


le ter 
(wml.md) instead of [HTML üt as t phones got more powerful they simply started to support normal web and WAP disappeared. 


Around 2005, the time when [YouTube (youtube.md), [Twitter](twitter.md), [Facebook](facebook.md) and other shit sites started to ap ear and become popular,,so called [web 2.0](web 20.md), started 
to form. This was a shift in the web's paradigm towards more [shittine$S](shit.md) such as more'[JavaScript](javascript.md), [bloa Bloat maS. interactivity, websites as programs, [Flash] 
(flash.md), [social networks](social_network.md) etc. This would be the beginning of the web's downfall. 


## How It Works 
It's all pretty well known, but in case you're a nub... 


Users browse the Internet using [web browsers | (browser md), programs made specifically for this purpose. Pages on the [Internet] (internet .md) are addressed by their [URL](url.md), a kind of 
textual address such as ^http://www.mysite.org/somefile.html'. This address is entered into the web browser, the browser retrieves it and diSplays it. 


A webpage can contain text pictures, graphics and nowadays even other media like video, audio and even programs that run in the browser. Most importantly webpages are [hypertext] (hypertext.md), 
i.e. théy may contain clickable references to other pages -- clicking a link immediately opens the linked page. 
The 


h page itself is written in [HTML] (html. md), Language {not really a [programming] (programming md), more like a file format), a relatively simple, language that allows s ecifying the structure of 
the text (headings, paragraphs, lists, ...), inserting links, images c. In newer browsers there are additionally two more important languages that are used with websites ( ney, can be embedded 
into the HTML file or come in separate files): [CSS](css.md) which allows specifying the look of the page (e.g. text and font color, background images, position of individual elements etc.) and 
[JavaSeript](gs md) which can be used to embed [scripts](script.md) (small [programs](program.md)) into webpages which will run on the user's computer (in the browser). These languages combined 
make it possible to make websites do almost anything, even display advanced 3D graphics, play movies etc. However, it's all huge [bloat](bloat.md), it's pretty slow and also dangerous, it was 
better when webpages used to be HTML only. 


The webpages are stored on web [servers](server.md), i.e. computers specialized on listening for requests and sending back requested webpages . If someone wants to create a website, he needs a 
server to host it on, so called [hosting](hosting.md). This can be done by setting up one's own server -- so called [self hosting](self hosting.md) -- but nowadays it's more comfortable to buy a 
hosting service from some company, e.g. a [vps I (Vps: md). For running a website you'll also want to buy a web [domain (domain.md) ike "mydomain.com^), i.e. the base part of the textual address 
of your site (there exist free hosting sites that even come with free domains if you're not picky, just search...). 


When a user enters a URL of a page into the browser, the following happens (it's kind of simplified, there are [caches](cache.md) etc.): 


1. The [domain] (domain md) name {epg ^www.mysite.org') is converted into an (EPA Gp mg) address.of the server the site is hosted on. This is done, by asking, a, [DNS dns md) server -- these are 
special servers that hold the database mapping domain names to IP addresses (when you buy a domain, you can edit its record in this database to make it point to whatever address you want). 

2. The browser sends a request for given page.to the IP address of the server, This is done via [HTTP {bttp md (or HTTPEI(https md) in the encrypted.case)_ protocol (that's the "http://' or 
https://' in front of the domain name) -- this protocol is a language via which web servers and clients talk (bésidés websites it can communicate additional data likè passwords entered on the 
site [cookies (cookie: mo) etc.). re the encrypted HTTPS protocol is used, pneryption is performed with [asymmetric cryptography] (asymmetric cryptography md) using the server's public key whose 
digita signature additionally needs to be checked with some certificate authority.) This request is delivered to the server by e mechanisms and lower network layers of the [Internet] 
(internet.md), typically [TCP](tcp.md)/[IP](ip.md). 

3. The server receives the request and sends back the webpage embedded again in an [HTTP ]ChEtp.md) response, along with other data such as the error/success code. 

4. Client browser. receives the page and displays it. If the page contains additional resources that are, needed for displaying the page, such as images, they are automatically retrieved the same 
way (of course things like [caching](cache.md) may be employed so that they same image doesn't have to be readownloaded literally evéry time). 


[Cookies](cookie.md), small files that sites can store in the user's browser, are used on the web to implement stateful behavior (e.g. remembering if the user is signed in on a forum). However 
cookies Can also be abused for tracking users, so they can be turned off. 


Other programming languages sugh as PHE I (php.md) can.also be used on the web, but they are used for server-side programming. i.e 


an. S = D . they don't run in the web browser but on the.server and somehow 
generate ànd modify e Sites for each réquest specifically. This makes it possible to create dynamic pages such às [search engines](se d 


arch engine.md) or [social networks](social network.md). 


## See Also 


Dark Web](dark web.md) 
Dork Web/Smol Internet](smol internet.md) 
teletext](teletext.md) 
et aye 
WAP ] (wap . mi 
Usenet] (usenet .md) 
bop St gopher md 
Sonini] {Gemind md) 
BBS s.m 
peenei mde nO 
IPFS](ipfs.m 
"unas [eu aS 
wan 
.md E 


x86 is a [p ioated] (pLogt md]; (forie [instructio 


i t n set archi 
architecture, used in [Inte intel.md) and [AMD]( ) 


are isa.md) (or rather a family of them) used mostly in the [desktop](desktop.md) computers -- it is the most widely used 
amd.m r 


tecture]( 

[CPU] (cpu.md)s 

It is a [CISC](cisc.md) architecture and boy, comp Lex DENTS o F'* LMAO] (Ua md)" there are instructions like  **PCLMULQDQ**,  **MPSADBW** (amuttipte packed.sums of absolute difference* which does 
y 


something like cross correlation ??? xD) and **PCMPESTRI** (which does like many possible string searches/comparisons On' strings of different data types like subset or substring with man 
different options). Basically if you smash your keyboard chances are you produce a valid x86 instruction xD 


xonotic.md -- 


# Xonotic 


Xonotic is a [free aş in freedom](free software,md) fast multiplayer arena [tirst:person: shooter (fps_game.md) [gang] (game md) similar to e.g. opake] (quake md) , It runs ọn penu] (gnu pd) / T Linux] 
linux.md), [Winshit](windows.md), [BSD] tbsd-mdy ahd other systems. It is one of the best libre games, i.e. games th are completely free by both code and data/content. It is available’ under 
GPLv3](gpl.md) . Its gameplay, graphics and customizability are pretty great, it may well be the best in the AFPS genre, even compared to AAA [proprietary](proprietary.md) games -- this kind of 
quality is very rare among libre/noncommercial games. 


{ I've been playii 


aying Xonotic for years, it's really an excellent game, I've met a lot of nice people there as the players are usually programmers and people, looking for [FOSS](foss.md). The 
gameplay is addicti y hj 


ve and relaxihg and you can have a great chat during the game. Of course it's kind of bloated But Xonotic is a masterpiece. ~drummyfis 


The game builds on old. ideas and mechanics but adds new weapons, mechanics, ideas and modes -- apart from the traditional {deathmatch ] (deathmatch md), team deathmatch, capture the flag, complete 
the Stage (defrag, racing without shooting) and competitive mode (duel), there are a number of new [fun](fun.md) modes such as clan arena (team round-based mode without self-damage and’ items), 
freeze tag, key hunt, last man standing and even Nexball -- [football](football.md) in Xonotic! 


Xonotic was forked from a game called Nexuig](pexyiz md) after a j£ rademark] (trademark md) controversy (basically in 2010 the guy who started the project and abandoned it_later, an ass called 
Lee Vermeulen, came back and secretly sold thé trademark to some shit Company named Illfonic). Nexuiz itself was Created on top of Liberated Quake engine, so Xonotic still bears a lot Quake's 
Legacy, however it masterfully expands on its core principles and makes the gameplay even better. For example rockets shot by rocket launcher can be guided with mouse while holding down the left 
button which adds a new skill element. New types of weapons were added to the classic AFPS weapons (e.g. the infamous electro, a [meme](meme.md) spamming weapon used by noobs for its forgiveness 
of lack of skill). Movement physics was also modified to give better air control and faster movement as a result. 


The genes modified [Quake] (quake md) 1 (YES, 1) engine is, called [Darkplaces | (darkplaces md). It can be highly customized and modded. Just like in other Quake engine, games, there are many 
console commands (e.g. *cvars*) to alter almost anything about the game. Advanced programming can be done uSing [QuakeC](quakec.md). Maps can be created e.g. with [netradiant](netradiant.md). 


Though compared to any mainstream [modern] (modern. md) games Xoņotic_is quițe nicely written (e.g. runs.very fast, doesn't have billions of dependencies and despite not Being 1.0 yet has, fewer 
bugs than today's AAA games at reléase), om a more strict point of view it's still very blóatéd and it's known to contain some shitcode -- for example the engine has framé depehdent physics 
(TODO: cite a specific line in code), uses [floating point](float.md) to represent time, great part of the game is written in a joke language called Pouakec (quake_c.md), its net code is worse 
than e.g. that of OpenArena and some people complain about input lag and other bugs. It could definitely be written MUCH better, but as already mentioned it's still a million times better than 
any new game. 


{ The game runs extremely smooth for me even, on old PC, I have no input lag. When my Internet connection gets bad I am sometimes unable to play Xonotic but still able. to play QpenArena, which 
Says s me thang about the net code, but that happens very rarely. Also on pretty rare occasions I notice bugs such as imperfect culling of players or even projectiles just hanging mid air during 
whole game (which happens after heavy packet loss) etc., but nothing that would really be so frequent as to bother me. ~drummyfish } 


Xonotic is similar to other libre AFPS games such as [QpenArena] (openarena md) and [Red Eclipse] red eclipse.md). Of these Xonotic clearly looks the most professional, it has the best "graphics" 
in the [modern](modern.md) sense but still offers the option to turn all the fancinéss off. OpenArena, based on Quake 3 engine, is simpler, both technologically and in gameplay, and its movement 
is slower and with different physics. While OpenArena just basically clones Quake 3, Xonotic is more of an actually new and original game with new ideas and style. Similar thing could be said 
about Red Eclipse, however it's not as polished and shows some infection with [SJW](sjw.md) poison. 


{ OpenArena is great too. ~drummyfish } 


As of 2022 the game has a small but pretty active communi fy of regular players, centered mostly in fEyrgpe] (europe md) though there is some US] (ysa; md) scene too. There are regulars playing 
every day, pros, noobs, famous spammers, Campers and [trolis](trotl.md). Nice Conversations can be had during games. There are [memes](meme.md) and inside jokes. The community i$ pretty neat. 
Xonotic also has a very dedicated [defrag](defrag.md) ("racing with no shooting") community. There have also been a few small tournament with real cash prizes in Xonotic. 


The [6951] (goat .md) of Xonotic is probably *Dodger*, his skill was just too high even above other pros. The worst player in Xonotic and probably also the biggest idiot on the planet is a player 
name : 


Great news is the development and main servers have,so, far not been infected by the [SJW poison] (tranny software,md) and {as of 2023) **allow a great amount of [free speech] (free_speech.md) ** 
another rarity. Even the game itself contains speech that SJWs would consider “offensive", theré are e.g. voice linés calling other players "pusSies" and "retards". This is great. 


## Tips'N'Tricks 
Here are some [pro](pro.md) tips to git gud, impress your frens and generally have more [fun](fun.md). 


- Read the legendary **beginner guide** at https://xonotic.org/guide/. 
- Point'n'click enemies to win. 

**Do NOT fucking spam electro** -- this will make you instantly hated, and rightfully so. Not only is it lame, annoying, makes you easy to kill (opponent can explode your electro balls) 
enforces more use of electro (electro is countered with electro) and makes the game lag, it can also hurt your teammates; even in no self/team damage modes (as opponents may explode the électro 
you spray around). Use it appropriately. 

- **Learn the weapons.and make binds for each one**: learn what, every weapons does (good mode for this might be clan arena in which you have all the weapons from the start), bind each one around 
the movement keys -- it's essential you can switch weapons quickly aS the game is deSigned to reward combóing (the most basic combo is devastator/vortex/mortar). Also note that almost every 
weapon has a **secondary fire**, for example crylink's primary fire just shoots bouncing balls while the secondary fire shoots a suction ball that can toss enemies out of the map or can be used 
to accelerate yourself. With devastator (rocket launcher) holding left mouse button allows **guiding the rocket**, right mouse button explodes the rocket in air -- learn this! Then you can 
easily kill enemies behind corners or flying in air. 

z **Learn the movement**: movement is essential in Xonotic, firstly you should learn extremely_basic techniques like bunnyhopping, strafe jumping and in-air controls, and secondly you should 
learn using weapons for movement (blaster jumps, rocket jumps, crylinkg for acceleration and Climbing walls, ...). This i$ important not only for quick relocation, taking shortcuts, dodging 
enemy fire and quickly running away from enemies, it also saves you from countless deaths by falling into pits. 


- **Console**: console is extremely useful in Xonotic; not only can it modify almost any aspect of the game, it also allows you to create fun macros (some people even create what could be 4 
considered [cheats](cheating.md) ohly with the console commands). A very important command is ‘search x which will search for other commands and cvars, e.g. if you want to mess with resolution, 
do “search resolution, etc. There is even a small **stack-based minilanguage** in the console that's invoked with the `rpnò command -- this allows for very advanced stuff. Sadly this isn't well 


documented, but the thread at https://forums.xonotic.org/showthread.php?tid-2987 provides some basics. 
- **Make cool binds**, for.example you should modify the standard team messages to something more funny. One of the most basic binds is **taunt** so that you can insult players (e.g. “bind 
KP. SLASH "cmd voice tàunt"'). 
- **Make basic graphics settings**, for example increase FOV (field of view) to at least 100, disable effects such as zoom animation (so that you can zoom quickly) etc. If you want to play 
seriously you should also **turn off music** so that you can hear enemies bétter. You'll also probably want to decrease your mouse sensitivity (something like 20 cm for a 360 degree turn is 
about right). You can also downgrade the graphics so as to make it basically look like Quake 1, either for a cool retro look or to play the game on a [potato](potato.md). 
- **Don't fall for the F11 [troti](troll.md)** -- when you ask how to do something and people respond with "press F11", don't do it, you'll humiliate yourself. 
- **Enable cheats with F11**. 
- **Spin to win**: you can make a cool spinning macro that makes you look like you have a seizure: e.g. “bind b "toggle vid stick mouse; rpn /m pitch 1 $(vid stick mouse] - 0.022 * =;"` 
- Once you have a comfy config, yoy çan remove the write rights to it (‘chmod -w -/.xonotic/data/config.cfg'). This way the game won't be able to modify the config and all settings and 
experiments you make in the gàme will only be temporary, until the game restart, so you can't fuck up your settings. 

**Do NOT camp**, it's retarded and wastes other people's time, especially e.g. in clan arena where dead people have to wait for the end of round. Better lose quickly than win or draw by 
camping. 
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**Explosions (and bullets) go through thin walls** by default, so you can e.g. kill someone hiding in the room above you by shooting the ceiling. Very cool. 
**Don't stand at teleport exits**, so as to not get telefragged. 

If you're not doing well, complain about [lag](lag.md). 

**You can turn off the chat** in case there is some retarded conversation going on (just go to setting and HUD editor). 

shy Lap Opponents to humiliate, them**; the shotgun secondary fire is a melee slap, which is the best way_to kill someone, partly because it's pretty hard to do (there's a delay before the 
bash). Another humiliating way to eliminate opponents is to kill them with Hagar secondary or push them off the map with blaster, crylink or even Mario kill (very rare -- you jump on someone's 
head while he's jumping over a pit which makes him fall down). Don't forget to taunt and tteabag] (teabag.md) . 

- If you see someone running fast while crouching in air, he's probably a [Pro] (pro md): 

-.**For more frags listen to sounds,enemies make** -- if a player is low on health, he makes a distinct sound when hurt. You should listen to these sounds and just quickly hit these players e.g. 
with machine gun to get an easy kill 

-.**For more frags watch for falling players** -- on space maps watch our for players falling off the map and just quickly hit them with machine gun (secondary fire) before they die, the game 
will give frag tO whoever hit him last. 

- «Y¥ebsycho 1, okq PRY 1' etc. ; A SERS P : oat F i caeli ; 3 

- **Slow down enemies wi hn,erylink secondary**: crylink secondary fire shoots a projectile that "sucks in" anyone in near proximity to the hit -- besides exploiting this for accelerating 
yöürself you can also use it to slow down enemies that try to run away from a fight or who just try to move quickly to avoid being hit. This is extremely annoying to the affected player, so do 
1t as often as you can. 

- 'cl handicap: can be used to make yourself weaker by specified multiplier (take more and deal less damage), either to balance the game or provide a challenge. 

- iv flipped 1° flips the rendering so that you see the mirror version of the map, it basically gives you a new map for free and provides a nice challenge. 

- "in pitch min' and ^in pitch max! can remove the limit of looking up and down (set to e.g. -1000 and 1000) -- this way you can turn completely upside down which can be seen by spectators and 
make them think you're a cheater. 

- Typing ^/me^ in chat makes the chat message be output in a different format; instead of “username: message it writes '^*message' and replaces the `/me`ò string with your username -- this can 
create Cool and fancy messages. 

- Piss people off with **troll votes**: study the 'vcall' console command (198 ^vhelp'), it allows for calling votes on.specific things like, switching maps kicking players etc. Some votes allow 
a parameter string so that you can make a tuny message with it, e.g. vcall bots play better than player X . Due to weird code numbers can be specified with almost arbitrary number of leading 
zeros, so you can just call a vote to set fraglimit to 1 with 100 leading zeros to spam people's screen and confuse them. Where enabled, ^"vcall grunt' will try to turn on grunt sound that many 
players hate. If you want to leave, a fancy way to do it is to call a vote to kick yourself. 

- The game outputs chat into terminal, you can filter these messages out and redirect them to [espeak](espeak.md) for a fun experience : 

-.**Electro spammers are easy to kill**: when someone is raping electro and just spraying everything, simply shoot at him with electro primary fire -- this explodes the balls he's spamming and 
hits him AND his teammates with huge damage. Don't forget to téabag and taunt him once he's dead. 

- Standing in front of a nub With Hagar is dangerous. 

Switch left and right hand for a challenge. 

Play drunk and/or high for a challenge. & 

Change your name to some unicode monstrosity like 65 T 2. { [RIP](rip.md) if your reader can't [Unicode](unicode.md) well :) -drummyfish } 

[Doom](doom.md) challenge: disable looking up and down with console. 

If you're slow, strafe](strafe jumping.m ) harder. 

Move to [Europe] europe.md) to actually enjoy the game with good ping. 

H My config is at https://codeberg.org/drummyfish/my text data/src/branch/master/configs/xonotic config.cfg. -drummyfish } 

uy premium account for extra skins and [loo boxes V tootbox md) : Just kidding : 

Don't [ragequit](ragequit.md), you'll give your opponent the ultimate satisfaction. Making someone ragequit is better than just [raping](rape.md) him. 

If someone admits to be playing on [windows] (windows. md), just hardocre bully camp that bastard out of the server. 

If you want to win in a team game and your team is losing, just quickly switch to the winning team before the end. Gotta keep them xonstats high. pe 

Sound is important, firstly you can heàr where enemies are lespedialiy when you turn off music) and secondly you can also spot low HP players by sound (they make a specific hurt sound when low 
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- Just spec good players and do what they do. 

- **ALL americans in. the game are cheaters**, without exception, just like in real life. You spot americans by ping and high score despite playing like pre beginners when you spectate them, 
and by crying like babies when you criticize [capitalism](capitalism.md) and tech consumerism. 
- some nacgePies/strategy Dapitsil: 

- **Chasing low health players is usually a bad idea** and a mistake made by nubs: such player 

- **Unpredictable movement and positioning is key** to avoiding damage: nubs think that when they move fast they won't get hit -- this is only partially true, it is about, just as important to 
move unpredictably and avoid spots that get regularly spammed by enemiés. When you move from point A to B on a map and thé enemy sees you doing so, you should take a randomly long short pause in 
doing so, or maybe even switch direction completely, otherwise he can quite accurately predict when and where you'll appear at the destination and kill you with prefire. It's a great advantage 
if your opponent doesn't know where you are. One sneaky tactical move is "the return" when you pretend you run away from somewhere, then wait 3 seconds ànd return back (the opponent expects you 
to run anywhere but to where you ran away from). 

- When in fight, **don't be an easy target and don't stand near a wall** (this makes you be easily hit with Splash damage). Don't stand in a corner. Try to always have a quick escape path. 

- **Stay together with your.teammates** (if you.want_to win). Fighting alone against multiple enemies is usually just a quick death without dealing much damage, even if you're very good and 
they're mediocre. Especially if you're a nub playing clan arena, stay with your team or else you'll die in 3 second$ and will have to wait until the end of the round. 
- **Higher ground is usually good**. 


if he's not a complete newbie, can jyst spam electro/nades behind himself and easily kill you. 


- When microcamping (camping or a short time with vortex somewhere), the only direction you can be hit from should be the one you're looking in. Nubs sometimes camp in a spot that can be seen 
from multiple directions -- that's just asking to be fragged. 

- **Use machine gun (MG) secondary to finish off low HP enemies**: MG is fhitscan] (hitsean.md), i.e. it hits instantly on a.distance and its easier to hit with than vortex (which fires just 
one strong shot) -- thé sécondary fire has no bullet spread unlike the primary fire, so it's idéal to just deal quick small hit that's enough to finish someone. But watch out, some people bitch 


about using MG this way being too nub, going for slap will entertain the audience better. 
- **Take items**, many new players just walk by mega health without taking taking it, that's pretty stupid. 
It's sometimes good in a fight to be directly above or under the opponent as it's harder for him to aim precisely looking completely up or down, and with many weapons it's generally harder 
a mage . 


to just hit someone in air, espécially for noobs. Noobs mostly don't even see you if you're above their heads (they ve FOV'set to low), it's basically free dai 


## See Also 


- [OpenArena](openarena.md) 
T xxiivv.md ---------- 
# XXIIVV 


{ Still researching this shit etc. -drummyfish } 


"n 


XXIIVV is a website and personal [wiki](wiki.md) (similar concept to [our wiki] (Irs wiki.md)) of a Canadian snana™ ay 4 sg ifi aj meo qt 
fidred rabbits.md) who live on 


David Mondou-Labbe who calls himsélf "Devine Lu Linvega" (lol) who is a part of an artist/pfógrammer group c 
at http://wiki.xxiivv.com/site/home.html. There are some real good and pretty bad things about it. 


EP 


oteric rogrammer/artist/[generalist |(generalism-md) | 
ship. Site is acces$ible 


Firstly let's see the letdowns: **HE LICENSES HIS ART AND SOME OF HIS CODE UNDER [CC-BY-NC-SA](cc. by nc_sa.md) -- retard alert!**. Honestly he can shove this up his ass. He's an [open soars] 
{open Source md) fanboy. At least some of his code is [MIT](mit.md), but he also makes fucking [PRO RIETARY | (proprietary.md) PAID. software (e.g. Verreciel). The guy also seems **égoistic as . 
uck**, invents weird hipster names and "personal pronouns" for himself, has some ugly body modifications, wears cringe rabbit costumes, he thinks his art is so good he has to "protect" it with 
fascist licenses and writes in a cringe pompous/cryptic style probably in hopes to appear smart while just making it shithard to make sense of his texts. The only thing he's missing is a fedora. 
Anyway, that's just a quick sum up of the cancer stuff. 


There are also nice things though, a few of them being: 


- The guy is creating extremely minimalist, small tech from-scratch technolo that's worthy of attention. Some of it includes: 

g g y r y y 
( - fueg: Simple (~100 [LOC](loc.md) of [C](c.md)) [virtual machine](virtual machine.md), similar to a "[fantasy console](fantasy console.md)" but intended more for [portability] 
portability.md). 


- [Tal](tal.md): Simple assembly-like [programming tanguage] programming language.md) for uxn. 
Varvara {Varvara md): A from-scratch computing stack based on uxn. 
lietal](lietal.md): Simple artificial language. / : F - F > 

- The wiki writes on pretty Pinteresting] (interes ing.md) topics, many of which overlap with [our](lrs.md) topics of interest. For example [pen and paper computing](pen and paper.md) that 
includes [games] (game.md). 

- Some of the presented opinions and wisdoms are [based](based.md), e.g. "for writing fast programs use slow computers" etc. 

T2 youtube.md ---------- 

# YouTube 


YouTube (also JewTube) is a huge, [censored](censorship.md) [proprietary] (proprietary md) [capitalist](capitalism md) video, [consuming] (consumerism md) "website"zplatform, since 2006 seized by 
the [Googte] (google md) terrorist organization. It has become the monopoly "video content platform", everyone uploads his videos there and so everyone is forced to use that shitty site from time 
to time to view some tutorial or whatnot. YouTube is based on content consumerism, aggressive predatory marketing, [copyright trolling](copyright_troll.md), propaganda and general abuse of its 
[useds](used.md) -- it is financed from surveillance-powered ads as well as sponsor propaganda inserted into videos. Alternatives to YouTube, such as [bitchute](bitchute.md , the "rightist" 
Youtube, never really caught on very much -- YouTube is sadly synonymous with online videos just as Google is synonymous with searching the web. This is of course extremely, extremely, 
extremely, extremely bad. 


{ https://www.vidlii.com, seems alright though, at least as a curiosity. Anyway if you need to watch YouTube, do not use their website, it's shitty as hell and you will die of ad cancer, rather 
use something like invidious or youtube-dl. -drummyfish } 


A [FOSS] (Foss md) alternative to YouTube is e.g. [Peer Tube] (peer tube. md) a federated video platform, however for intended use it requres [JavaScript] (Javascript .md). and there are other issues 
that make it unusable ([SJW](sjw.md) censorship, videos load extremely Slowly "ME There also exist alternative YouTube [frontends](frontend.md) normally also [Fi SSJ (foss md)), e.g. HookTube 
Invidious or FreeTube -- these let you access YouTube's videos via less [bloated]( loat.md) and more privacy-friendly interface. More hardcore people use [CLI](cli.md) tools such as lyoutube- di 
(youtube dl.md) to directy download the videos and watch them in native players. 


In November. 2021 YouTube removed the dislike count on videos so as to make it impossible to express dislike or disagreement with their propaganda as people naturally started to dislike the. 
exponentially skyrocketing shit and immorality of content [corporations | (cor oration.md) and [SJWs](sjw.md) started to force promote on YouTube (such as that infamous Lord of the Rings series 
with ["afro american"](nigger.md) dwarves that got like a billion dislikes [lmao](lmao.md)). In other words capitalism has made it to the stage of banning disagreement when people started to 
dislike the horse shit they're being force fed. This was met with a wave of universal criticism but of course YouTube told people to shut up and keep consuming that horse excrement -- of course 
[zoomers](zoomer.md) are just brainless zombies dependent on YouTube like a street whore on heroin so they just accepted that recommendation. Orwell would definitely be happy to see this. 


[LMAQ] (Lmao md) as of 2022 YouTube has become the **kingdom of [clickbait](clickbait.md)**. If you're living in the future and haven't seen this, you woutan it believe how ridiculously fucked up 
it is, the pla form is quite literally UNUSABLE (but it's still consumable and addictive to idiots so it [works](just_werks.md)) -- ALL videos, including (and especially) those of the "serious" 
YouTubers (like mr. Veritasium), put absolutely misleading and downright made up lying thumbnails and titles, thé videos have [zero](zero.md) {correlation correlation.md) with how they're 
presented. Additionally the majority of thumbnails has to be occupied by some [femoid](femoid.md)'s breasts, even "educational [science](soyence.md) videos", so as to force children to click it 
and masturbate (YouTube can really be seen as a soft [porn](porn.md) site now). Everyone has to do it because [everyone does it](everyone_does_it.md). In other words capitalism is once again 
working as expected. Yeah and also **ALL videos include sponsored content**, again even the "educational science videos" that children are forced to watch at schools etc. -- this is in addition 
to "normal" ads that randomly play during the videos. 


A typical 2022 YouTube video now looks like this: 


- **title**: *THEY SAID A WOMAN COULDN'T CODE MINECRAFT IN 24 MICROSECONDS SO I PROVED THEM WRONG, ALSO LIFE FOUND ON MARS* 

- **thumbnail**: bikini [MILF](milf.md), nipples half showing, overly excited face as if having a stroke, pointing at aliens playing Minecraft 

- **content**: 10 minutes of pre-video unskippable ads, tranny shows up urging you to buy premium membership on Nord VPN,, 10 minutes of unskippab le ads for tranny, underwear, tranny opens up C# 
[IDE](ide.md) that loads for 30 minutes, clicks the "generate game with AI" bütton, the Computer crashes, "Sorry for clickbait", 10 minutes o ost video ads, "like, comment, give me money on 
patreon, subscribe, click the bell button, go to settings and check I want to see subscriptions I subscribe to, go to advanced setting and click I really really really want to see my 
Subscriptions I really do and will suck your dick", next video loads without asking, volume sets itself to 3009, browser close button disappears 

- **reactions**: trending video, 10 billion likes, dislikes not shown, comments disabled so that people can't warn others it's a waste of time 


YouTube is also a [copyri ht] (copyright md) [dictatorship](dictatorship.md), anyone can take down any video containing even the slightest clip from a video he uploaded, even if such use would 
legally be allowed under iaar use](fair uS$e.md) and even if that user doesn't have any copyright to enforce (YouTube simply Supposes that whoever uploads a video to their site first must have 
created that video as a whole and holds a godlike power over it), i.e. YouTube is [de acth (de facto md) making its own Copyrig t laws which are much more strict that they are in real life 
(which is hard to imagine but they managed to do it). In other words there is a corporation that makes laws which effectively are basically just like normal laws except they don't even pass any 
aw making process, their evaluation doesn't pass through justice system (courts), and the sole purpose of these laws is to rape people for money that gi solely to pay for YouTube CEO's whores 
and private jets. A reader in the future probably won't believe it, t there are even people who say that "this is OK" because, quote, I shit you not, [they're a private company so they can 
do whatever they want](private company cant do whatever it wants.md)""". Yes, such argumen ly implies a negative [IQ](iq.md). 

---------- zero.md ---------- 


s have come out of some lifeform's mouth. That probal 


Zero (0) is a [number](number.md) signifying the absence of a thing we count. Among integers it precedes [1](one.md) and follows -1. 
Some properties of and facts about this number follow: 


- It is [even](even.md). 

- It is neither positive nor negative, it lies exactly on the boundary of positive, and negative numbers. However in some computer numeric encodings (such as [one's complement] 
(ones complement.md)) there exi$t two representations of zero and so we may hear about a positive and negative zero, even though mathematically theré is no such a thing. 

- It is a [whole number](integer.md), a [natural number ](natural_number.md), a [rational number](rational number.md), a [real number](real number.md) and a [complex number ](complex_number .md) . 
It is **NOT** a [prime number](prime.md). 

It is an additive identity, i.e. adding © to anything has no effect. Subtracting © from anything also has no effect. 

Multiplying anything by © gives 0. : 

Its representation in all traditional numeral systems is the same: 0. 

0^*x* (zero to the power of VL for *x* not equal to 0, is always 0. 

*x*AQ (*x* to the power of 0), for *x* not equal to 0, is always 1. 

0^0 (© to the power of 0) is **not defined**! 
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-In programming we start counting from 0 (unlike in real life where we start with 1), so we may encounter the term **zeroth** item. We count from © because we normally express offsets from the 
first itém, i.e. 0 means "O place$ after the first item". 

- It is, along with 1, one of the symbols used in [binary] (binary md) logic and is normally interpreted as the "off"/"false"/"low" value. 

- Its opposite is most often said to be fhe, [infinity | (in inity,md), even though it depends on the angle of view and the kind of infinity we talk about. Other numbers may be seen as its opposite 
as well (e.g. 1 in the context of [probability] (probal ity maj. 

- As it is one of the most commonly used numbers in programming, , computers sometimes deal with it in special ways, for example in [assembly] (assembly mdp. languages there are often special 
instructions for comparing to © (e.g. '"NEZ', not equals zero) which can save memory and also be faster. So as a programmer you may optimize your program by trying to use zeros if possible. 

- In $edfc.nd) and many other languages © represents the [false] (false md) value, .a function returning 0.man times signifies an [error](error,md) during the execution of that function. However 
0 als Ometimes means success, e.g. as a return value from the main function. © is also often used tO signify [infinity](infinity.md), nho limit or lack of value (e.g. [NULL](null.md) pointer 
normally points to address © and means "pointing nowhere"). 

- [Historically] (history md) the concept of number zero seems to have appeared at least 3000 BC and is thought to signify an advanced abstract thinking, though it was first used only as a 
poSitional syml for writing numbers and only later on took the meaning of a number signifying "nothing". 

**Dividing by zero is not defined**, it is a forbidden operation mainly because it breaks equations (allowing dividing by zero would also allow us to make basically any equation hold, even those 
that normally don't). In pro ramming dividing by zero t paca lly causes an error, crash of a program or an fexception] fexteption.md) ; In some programming languages [rising point](float.md) 
division by zero results in [infinity](infinity.md) or n aN](nàn.md). When operating with [limits](limit.md), we can handle divisions by zero in a special way (find out what value an 
[expression](expression.md) approaches if we get infinitely close to dividing by 0). 


## See Also 


infinity](infinity.md) 


- [NULL](null.md) 
Fintinfey TCin 


my_text_data 


A 
bio.txt 
17.11.1989 Velvet Revolution 
1990.08.24 11:45 born in Zlin, 2.95 T 49 cm 
1990.09.29 welcomed as a new citizen in Babice 
1990.10.13 first smile 
1990.10.23 reached 5 kg 
1990.11 first word: "agü" 
1990.12 moved to a flat in Breclav 
1990.12 WWW released 
1991.01 started to eat vegetables 
1991.03 stopped breast-feeding 
1991.04.20 stood up on feet and and said "tata" (daddy) 
1991.06.03 first tooth 
1991.07.12 first step 
1991.09.19 Linux is released 
1991.12.10 said "maminka" (mommy) 
1993.01.01 Czechoslovakia splits into Czech and Slovakia 
1993 fever, went to hospital for a week 
1993.07.16 brothers were born 
1993.12.10 Doom comes out 
1994.02.04 Ace Ventura (1) premiers 
1994.04 grandfather (in law, father's side) died 
1994.06.15 The Lion King premiers 
1994.10.13 Pulp Fiction premiers 
1994 moved to Mařatice flat (stayed with grandparents for a while) 
1995.12 Dračí Historie released 
1995.09.29 Playstation released 
1996.01.29 Duke Nukem 3D released 
1996 Warcraft II released 
1997.07.05 the great flood of Moravia 
1997 holiday in Biograd (Croatia), first time at seaside (house: 43.93840288370077, 15.45129809823071) 
1997 watched the very bright comet Hale-Bopp 
1997 1st PC, dad bought it from work, Windows 3.1 
1997.09.01 started elementary school in Mařatice (1 year postponed) 
1998.01.23 mom has a car accident (will be OK) 
1998.02.05 Titanic premiers in Czech Republic 
1998.09 Google is launched 
1998.12.23 Gameboy Color released in Europe 
1998 went to the cinema to see Titanic (with subtitles) with mom 
1999.05.19 Star Wars (prequel 1) premiers 
1999.08.11 watched the total solar eclipse 
1999.08 moved to a house in SuSice 
1999.09.01 transitioned to elementary school in Babice 
1999.12.02 uake III Arena released 
1999 ??? got first cell phone (Erisccon T10s) 
2000.01.01 00:00 celebrated new millenium at the square in Uherské Hradiště 
2009.06.16 Pokémon Yellow released in Europe 
2000.08 holiday in Caorle (Italy) with family (camp: 45.61554435311908, 12.90369973720829), trip to Venice 
2001.01 Wikipedia is launched 
2001.06 holiday in Novalja (Croatia, Pag island) with family (house: 44.55988049838873, 14.875903659317986), extended 3 das in Privlaka (house: 
44.2572756556983, 15.128398777235212) 
2001.06.22 Gameboy Advance released in Europe 
2001.09.11 9/11 terrorist attacks in the US 
2001.09.24 Windows XP released 
2001.11.02 Pokémon Crystal released in Europe 
2001.11.16 Harry Potter (movie 1) premiers . 
2001.12 Lord of the Rings (movie 1) premiers 
2002.01.11 Advance Wars released in Europe 
2002.05.02 TES Morrowind released in Europe 
2002.05.16 Star Wars (prequel 2) premiers 
2002.07.05 Warcraft III released in Europe 
2002.08 holiday in Gargano Gta) with famil 
2002.08 bought Gameboy Color with Pokémon Yellow 
2002.08.24 went to aunt Andrea's wedding 
2002.08.19 Mafia released 
2002.10.29 GTA Vice City released 
2002.11.15 Harry Potter (movie 2) premiers . 
2002.12 Lord of the Rings (movie 2) premiers 
2003 got a dog: Endy (golden retriever) 
2003.03.07 Václav Klaus becomes the president of Czech Republic 
2003.03.25 Linkin Park release Meteora (album with the song Numb) » 
2003 holiday in Brela (Croatia) with family (house: TRGOVACKI OBRT M B VL. JURICA CAREVIC BRELA) 
2003.06.25 Pokémon Sapphire released in Europe 
2003.10 Nokia 6600 released h 
2003.11 got small dogs: Matýsek (chihuahua) & Čiko (Prague ratler) 
2003.12 Lord of the Rings (movie 3) premiers 
2004.05.01 Czech Republic enters the EU 
2004.05 holiday in Bohemia (Cechy) with family, in Land Rover 
2004.05.31 Harry Potter (movie 3) premiers 
2004.06 holiday in Brela (croatia) with family 
2004 2nd place in school's mathematical competition (Klokánek) 
2004.08.13 Doom 3 released in Europe 
2004.10 attended Invex in Brno with family 
2004.10.26 GTA San Andreas released 
2004.11.16 Half Life 2 is released 
2005.01.21 techer's reprimant (dütka tř. učitele) for neglecting school 
2005.02.11 World od Warcraft released in Europe 
2005.05.15 Star Wars (prequel 3) premiers 
2005 holiday in Brela (Croatia) with family 
2005.11.18 Harry Potter (movie 4) premiers 
2006.01.30 great-grandmother (fron mother's side) dies 
2006.02.11 attended final school ball (Polonéza) 
2006.06.30 ist place in school's mathematical competition (Klokánek) 
2006 got Internet connection at home | 
2006.09.01 started attending high school: SPS Zlín 
2006 written a short story at school, teacher liked it very much 
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2006.09.13 broken right leg during phys. education at school 
2006.09 started p aying World of Warcraft on offic. server (Drummy) 
2006.12.30 great grand mother (father's side) died 
2007.01.16 WoW: TBC released in Europe 
2007.04 holiday in Hurghada, Eg pt , with family (place: 27.260314879580594, 33.82145067695522), 
2007.07.12 Harry Potter (movie y premiers 
2007.07.21 ??? read the first book in English: Harry Potter 7 
2007.08.25 in World of Warcraft took part in raid on Ironforge 
2008.06.17 went to Linkin Park concert in Brno 
2008.07 holiday in Brela (Crotia) with family 
2008.09.01 started officially learning programming at school (Pascal) 
2008.11.13 WoW: WotLK released in Europe 
2008.12.03 GTA IV released 
2009.02.14 attended brothers' final school ball (Polonéza) 
2009.03.08 registered at Facebook 
2009.06 holiday in Brela (Croatia) with family 
2009.06.29 got driver's license 
2009.07.15 Harry Potter (movie 6) premiers 
2009.07.022 Windows 7 is released 
2009.12.10 Avatar premiers 
2010.03.22 accepted by Brno University of Technology 
2010.05.17 accepted by: Masaryk University 
2010.05.01 started dati 1st girlfriend 
2010.05.24 graduated high school (SPS Zlin), commendat. for final work 
2010.08 oliday on Rab island (Croatia) with family 
2010.09.01 started University: FIT BUT (Brno), Bachelor's IT program 
2011.07.22 Norway mass killing by Breivik 
2011.08 holiday in České Švýcarsko with girlfriend and her family (visited Děčín at 2011.08.01) 
2011.08 short summer "job", working for the Babice village 
2011.09.10 took part in "Slavnosti Vina" (folk Testivaly h girlfriend 
2011.10.15 took part in rs (folk festival) with girlfriend 
2011 breakup with girlfriend, mild depression, antidep. 
2011.11.18 Minecraft is released 


trip to Giza (pyramids, 


2007.04.05 10:00) 


published the manifesto Non-Competitive Society 


2013.03.08 Miloš Zeman becomes the new presadent of Czech Republic 
2013.06 holiday in Brela (croatia) with family 
2013.07 colored hair blonde 
2013.09.17 GTA V released 
2013.10 released the game Mage Rage, won the fitst place at itnetwork.cz 
2014.02.07 IQ tested by Mensa (151) 
2014.06.16 Bachelor's degree graduation at FIT BUT 
2014.07 holiday in Brela (Croatia) with family (visited Amfiteatar at 43.5385055957982, 16.474188911763395, 2014.07.10 22:00) 
2014.09.01 started computer graphics Master's program at FIT BUT 
2014.09 took part ina charity run in Brno (Béhem Détem) 
2014.10 took part in game hackaton at FIT BUT 
2015.09 breakdown, depression, psychiatr., antidep., postponed school 
2016.08.01 got job at Code Creator (Brno) but failed to start (anxiety) 
2016.08 iday in Novi Vinodolski (Croatia) with family & cousins 
2016.09.13 went to cousin's wedding as the best man (on scooter) 
2017.06.21 Master's degree graduation at FIT BUT 
2017.07 holiday in Brela (Croatia) with parents, read the book "Free as In Freedom" 
2017.08 applied for a job in Crea Vision (UH, IT), failed (anxiety) 
2017.10 started contri uting to OpenMW 
2017 started a "job" dis ributing leaflets in the village (-7h/week) 
2017.12.11 started the OpenMF (open source Mafia engine) project on GH, would go trending 
2018 transitioned to a "job" distributing newspaper in the morning (-12h/week) 
2018 became vegetarian 
2018.07 bought Arduboy 
2018.08.15 bought Pokitto 
2019.03.18 started a "job" at factory reception (Hamé Babice, part time)2019.09.01 
2019.10 ?? ended the reception "job". 
2019.11.13 went for a stay at psychiatric hospital (FN Brno) 
2020.03.11 COVID-19 pandemic started 
2020.02.26 returned from the psychiatric hospital, diagnosed AVPD 
2020.05.07 admitted invalidity pension (1st degree) for AVPD 
2020.05.11 first real job: cleaner in Fatra Napajedla Part time) 
2020.11.20 released the game Anarch, a bit "successful 
2021.06.16 left the cleaner job (4h/day) 
2021.06.22 11:30 cut long hair (groeing 2* years) 
2021.06.25 holiday in Bre Croatia with mom 
2021.07.12 started a job at a laundry (5h/day) 
2023.05 bought caravan 
TODO: Pokémon Sapphire, mandle psychologist visits start, dog death dates, 
how I got scammed by the celip one people at the bus stop, zampionarka 
NOTES: 
me at "slavnosti vína": https://www.youtube.com/watch?v- Ipvqaj11— 6Q 19:45 


- game "Dablik" I played in Traplice is probably Litil Divil 


genealogy.txt 


Stuff about my family. 
ancestor tree: 


Miloslav Ciz: 24.08.1990 (Zlín) - ??? 
sňatek: 23.07.1988 (Uherské Hradisté 
Miloslav Pšurný ( (612): 25.09.1966 (Uherské Hradiště) - ??? 
Miloslav Pšurný: 1944 - ??? 
Miloslav Pšurný: ??? - 28.08.1988 (Ostrožská Nova Ves) 
sňatek: 13.04. 1921 
Antonin Pšurný: 06.06.1898 (MilokoSt 152) - ??? 
Frantisek PSurny: 28.01.1860 (MilokosSt 77) - ??? 
Jan Pšurný: €tvrtnik v MilokoSti 
Mathias Pšurný: 
Katharina Lorenz: 
Matouš Lorenz: 
Katerina Jochová: 
Johan Joch: 
Anna Weseli: 
Sebastian Weseli: 
Mariana Bubeníková: 16.08.1864 - 26.02.1940 (Ostrozské Predmésti 29) 
Jan Bubeník: Ostrozské Předměstí 
Josef Bubenik: 
Elizabeth Laga: 
Mathias Laga: 
Mariana Ondrackova: Ostrožská Nova Ves 
Antonin Ondracka: Ostrožská Nova Ves 
Anna Jurásek: 
Anton Jurásek: 
Antonie Karlíková: 19.05.1898 (Veselské Predmésti 423) - ??? 
sňatek: 12.11.1890, Predmésti Veselí 356 
František Karlík: 21.03.1866 - ???, topič na dráze 
sňatek: 08.02.1860 
Antonin Karlík: 11.06.1829 - 03.03.1904, domkař ve Veselí 356 
sňatek: 09.02.1813 


Milokost 
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An 
(Ostrozs 


Emilie Vlachynská (Cizova 


An 


padl v 1. 


Tomás Karlík: Veselí 49 
Elizabeth Galárová: 
Marie Kozumplíková: Veselí 56 


Jifí Kozum 


lik: 


Veseli 


Johana SvatoSova: Veseli 


Jakub Svatoš: 


Antonie Fingerova: 
Josef Finger: 
Marie Fojtikova: 


domkaf ve Vese 


Veseli 
23.05.1867 


Veseli 


Josef Fojtik: podsednik ve Veseli 


na GaluSkova: 

ka Nova Ves) 
Matůš Galuška: 
sňatek: 16.08.1862 
Josef Galuška: 
Jakob Galuška: 


Kateřina Widrman: 


07.03.1839 


Ostrozské Předměstí 


Mariana Zalubil: Ostrožská Nova Ves 136 
Jan Zalubil: Ostrožská Nova Ves 


Katerina Lopata: 
Jan Lopata: 
Mariana ???: 
Alzbéta Hüsková: 


Ostrozska Nova Ves 


Bartoloméj Hüsek: 02.11.1859 - ??? 
Vavfinec Hüsek: Ostrozska Nova Ves 


Apoléna Blaha: 
Mariana Koliskova: 


tonin Vlachynsky: 25. 
sňatek: 28.05.1901 


FrantiSek Vlachynsky: 01.07.1878 - 1914 (Opole pobliz Lublina, 


sv. V.) 
sňatek: 09.02.1875 
Jan Vlachynsky 

Frantisek 


Hluk 


di 29.09.1944 - ??? 
8.1907 - 27.09.1989 


ý; 1852 - 2???  — 
Vlachynsky: Podolí 


{Pregmestt Veseli 405) - ??? 


8.10.1922 (Ostrožská Nova Ves 476) - 10.04.1984 
20.09.1882 (Chylice 86) - ??? 


29.06.1887 (Ostrožská Nova Ves 356) 


Polsko, 


Jan Vlachynsky: 1796 - ??? 
sňatek: 1778 
Jan Vlachynsky: 
Marina ???: 
Magdalena ???: 1798 - ??? 
Barbora Vaňková: Popovice 36 
Josef Vanék: 
Rosalie ??? (Vichorcová): 1841 - ???, 
Jan Tvrdon: 
Barbora Hrácková: 
Rozalie PaSkova: 16.03.1875 - 1965 
Jan Paška: ??? - 28.08.1878 (Podolí 98, 
Antonin Paška: Podolí 
Apolónia Vaculinek: ??? - 14.09.1878 (Podolí) 
Mariana Perželková: Podolí 25 
Anežka Mikulcová (y rachynska): 13.12.1918 - 30.12.2006 (Podolí 99) 
sňatek: 16.06.1 
Metoděj Mikulec: 29.01.1885 - ??? 
sňatek: 12.02.1866 
Tomás Mikulec: 09.03.1846 - 09.01.1890 (Vlčnov 160) 
Šimon Mikulec: obecní pastýř ve Vlčnově 
Anna Křapa: ??? - 10.09.1889 (Vlčnov 213) 


Martin Křapa: 
30.03.1850 (Vlčnov 66) - 21.01.1897 


vdova 


objesil se v opilství) 


Anna Pavelčíková: 
Franz Pavelčík: VIENON 
Riana Klabačková: Vlén 
Barbora Kryštofová: 04.12.1883 (Veletiny 42) - ??? 
sňatek: 31.01.1883 
Josef Kryštof: 12.03.1854 - 09.01.1939 (Veletiny 42) 
Josef KryStof: Veletiny 
Katarina HruboS: ??? - 12.01.1862 
Vencl Hrubo$: Veletiny k 
Anna Piáčková: 22.07.1863 (Veletiny 16) - 06.03.1932 (Veletiny 42) 
sňatek: 1861 
Josef Piáček: 13.05.1843 - ??? 
Georg Piáček: Veletiny 
Barbora ???: Havřice 
Magdalena Křivdová: Drslavice 
iří Křivda: Drslavice 
Anna Polášková: Hradčovice 
Josef Polášek: Hradčovice 
Vladimíra Daňková (Čížová): 22.01.1967 (Uherské Hradiště) - ??? 
sňatek: 22.01.1966 (Babice 205) 
Josef Daněk: 14.04.1941 - ??? 
Josef Daněk: 1914 (Kudlovice) - ??? 
sňatek: 02.09.1912 (Spytihněv) 
Josef Daněk: 1881 - ??? 
sňatek: 10.07.1877 
František Daněk: Bařice 19 
Ján Daněk: Lubná 
Jan Daněk: Lubná 
Anna Nedbal: 
Anna Kolouchová: 
Melchior Kolouch: Vrbka : 
Anna Dvoranová: 27.01.1859 (Bařice 20) - ??? 
Josef Dvoran: Barice 
Franz Dvoran: 
Anna Bureš: TéSnovice 
Katerina Rohackova: 
Josef Rohácek: Brest (55) 
Brigita Motalik: 
Johan Motalik: 
Viktoria: 
Marie Janoušková: 
Josef Janoušek: 
Jan Janoušek: 
Cyril Janoušek: 
Anna Hruby: 
Marie Růžičková (Janoušková): 
Terezie Masaříková: Snovítky 
Ondřej Masařík: Snovítky 
Mariana Slampova: Snovítky 
Fabian Slamp: 
Anežka Hofinkova (Daňková): 
Klement Hořínek: 26.11.1885 - 1963 (Sušice 34) 
sňatek: 18.05.1870 
Klement Hořínek: 23.11.1844 - 20.09.1921 (Sušice 34) 
sňatek: 1829 
František Hořínek: Kudlovice 65, kovář 
Františka Jabürková: Jankovice 24 
Martin Jabürek: Jankovice 
Apolónia Skrabálková: 31.12.1848 - 25.10.1931 
František Skrabálek: 10.07.1818 - ??? (Sušice 7) 
Josef Skrabálek: 
Anna Skrabal: 
Johan Skrabal: 
Františka Sebeták: Sušice 
František Sebeták: 
Mariana Miták: 
: Johan Miták: 
Marie BartoSíková (Daňková): 
sňatek: 16.09.1901 (Babice 
Martin Bartošík: 24.11.1910 - 13.09.1987 
Josef Bartošík: 17.03.1863 (Babice 68) - ??? 
sňatek: 15.02.1860 
Josef Bartošík: 1833 - 23.08.1883 
sňatek: 12.02.1830 (Halenkovice) 
Vincenc Bartošík: 19.01.1800 (Babice 68) - ??? 
Tomas Bartošík: ??? - 1829 (Babice) 
??? - 1814 (Babice 86) 
23.02.1812 (Halenkovice 1) - ??? 


1888 - 272 
22? - 08.01.1860 (Snovítky 27) 


18.12.1945 - ??? 


Johana Bičan: 
Anna Juřenová: 
Jan Juřena: 
Barbora Baštinec: 
Johan Baštinec: 
Terezie Janečková: 21.08.1838 - 21.05.1905 (Babice 75) 
Jan Janeček: 1803 (Babice) - 21.10.1890 
Anton Janeček: Babice 
Anna Komárek: 
Viktorin Komárek: 
Františka Býček: 
Franz ByCek: 
Eleonora Janečková: 04.11.1875 (Babice 74) - ??? 
sňatek: 07.02.1866 
Johan Janeček: 1836 - 09.06.1887 (Babice 75) 
Johan Janeček: ??? - 21.10.1890 (Babice) 
Anton Janeček: 
Anna Rozumek: 
Františka ByCek: Babice 
Franz Býček: Babice 
Josefa Lahola: 
Johan Lahola: Spytihněv 
Josefa Pešlová: 16.02.1848 (Traplice 66) - 08.01.1937 (Babice) 
sňatek: 16.02.1841 
Šebestián Pešl: 23.07.1814 - ??? (Traplice 66) 
Johan Pešl: Traplice 
Anna Mikulík: Traplice 
Johan Mikulík: 
Johana Haša: 12.05.1820 - ??? (Traplice 64) 
Johan Haša: Traplice 64 
Barbora Hanák: Traplice 
Lorenz Hanák: 
Jaromíra Skrabalova (Bartošíková): 11.04.1921 - 30.01.2006 
František Škrabal: 01.08.1883 (Babice 79) - 30.11.1940 (Babice) 
sňatek: 02.06.1863 {Panie 651 
Václav Skrabal: 1844 - 1899 (Babice 149) 
sňatek: 1889 (Huštěnovice) 


Jan Škrabal: 1810 - 1853 
sňatek; 1804 (Babice 2 
Franz Škrabal: 1778 

Josef Škrabal: 
Marina ???: 

Matylda Třetiak: 1782 
Anton Třetiak: 
Apolónia ???: 

Anna Bazalová: 1820 (Huš 
Matouš Bazala: 

Tekla Laholík: 
Frant Laholík: 

Matylda Kučerová: 1845 (Ce 
sňatek: 1839 (cerony) 

František Kucera: 1820 - 
Matouš Kučera: 
Barbora Palánková: Huš 

Barbora Obdržálková: 181 
Kaspar Obdržálek: 1786 

Franz Obdržálek: Huš 
Barbara ???: 


Apolónia 0 nik: 1782 


sňatek: 199 (Babice) 


Martin O ejnik: 1753 
sňatek: 1751 (Babi 
Matheus Olej nik? 
Juditha Bartošík: 
Joanis Bartošík: 
Tereza Tomaštíková: 
Joanis Tomaštík: K 
Katarína ???: 
Rudolfína Rožková (Skrabalov 


(Babice) 
sňatek: 26.10.1888 
Cyril Rozek: 09.03.1862 (B 
sňatek: 1860 (Babice 
Franz Rožek: 03.02.1839 
sňatek: 1808 (Spytihnev) 
Johan Rozek: 8.180: 
sňatek: 1794 (Babice 
Anton Rožek: 1780 - 
sňatek: 1776 
Josephus Rožek: 
Josephus Rožek: 
Veronika Švehlák: 
Martin Svehlak: 
Anna ???: 
Apolónia Varmuza: Hu 
Johan Varmuza: 
Anna Snopková (RoZková 


sňatek: 1797 (Kudlov 
Franz Snopek: Spytih 
Apolónia Kamenicek ( 
sňatek: 1775 
Martin Kamenicek: 
Anna Stépaník: ??? 
Jan Stépanik: 
Josefa MokroSova (RoZkov 
Jan Mokro3: 11.11.1813 
sňatek: 1813 (Babice 
Josef Mokroš: 1788 - 
sňatek: 1783 
Šimon Mokroš: 
Jan Mokroš: 
Barbara Rozumek: 
Martin Rozumek: 
sňatek: 1724 ( 
Laurent Rozume 
Václav Rozum 


(Babice) 


Babi 


y open 2) 


- 1820 (Babice 2) 


ténovice 17) - ??? 


rony) - 1914 (Babice 67) 
1865 (Babice 67) 


Huštěnovice 


těnovice 
7 - 22? 


(Uherské Hradiště) - 1831 (Cerony 10) 
ténovice 


(Babice) - 1847 (Cerony 10) 


(Babice) - ??? 
ce) 


1757 (Kudlovice) - ??? 
udlovice 


A): 07.11.1888 (Jalubí) - 08.02.1965 


Jalubi) 


abice 83) - ??? 


- 08.03.1892 (Babice 5) 
v 
4 (Babice 5) - ??? 


1806 (Babice 5) 


1759 (Spytihnév) - ??? 


$ténovice 34 
): 24.09.1813 (Spytihnév) - 12.01.1883 


ice) 
név 21 
Snopková): 1780 (Kudlovice) - ??? 
Kudlovice 

- 1799 


á): 26.04.1838 (Babice 94) - ??? 
ee 08.1866 (Babice 94) 
1825 (Babice 111) 


ce 65 


Babice 
k: 169 
ek: 


Katerina ???: 


Barbara Zuzani 

Anna HaSa: 1738 

sňatek: 1721 ( 
Joanis HaSa: 

„Elizabeta ???: 

Antónia Rozsypálková: 

sňatek: 1776 {Topol 

Franz Rozsypale 


k: 
(Babice) 
Babice) 


1778 (Topolná) - 1840 (Babice) 
lná 30) 
22? - 1817 


Franz Rozsypátek: 


Anna Cechmáne 


Martin Cechmánek: 


Apolónia Adamčíková (M 


Anton Adamčík: 1788 
sňatek: 1780 
Gregor Adamčík: Hu 
Apolónia Machaline 

Bartoloměj Macha 

Katarína Grebeň: ??? 


(Babice) 


Anna Obdržálková (Rožková): 


(Jalubí) 
sňatek: 28.01.1846 Urap 
Josef Obdržálek: 11.01. 
sňatek: 29.01.1817 (Zl 
Jan Obdrzálek: ??? - 1 


sňatek: 1769 (Jalubí) 


Anton Obdržálek: Jal 
Barbora Tomečková (0 
václav Tomeček: Ja 
Kateřina ???: 
Alžběta Vávrová (Obdrz 


sňatek: 1794 (Hustén 

Franz Vávra: 1775 (Z 
Mathias Vávra: ??? 
Elizabeta ???: 

Apolónia Korvasová ( 


sňatek: 1772 (Husté 
Vaclav Korvas: Huš 

Katarína Bazala: 

Bernard Bazala: 
Františka Rožková (Obdrz 

18.04.1899 (rraptitess 

sňatek: 06.02.1817 (Ku 
Josef Rozek: ??? - 15. 
sňatek: 26.01.1785 ( 

Josef Rozek: Jalubí 
Blažej RoZek: 1717 

Jan RoZek: 
Anna ???: 
Marina: 

Barbara Garázija: 17 
sňatek: 1759 
Izidor Garázija: T 

Jakub Garázija: 
Alžběta ???: 
Barbora Grebei: 
sňatek: 1730 
Josef Greben: 
Katarina Obdrzal 


(Jalubi) 


(Zlechov) 


Anna Snopková (RoZková): 


Franz Snopek: ??? - 
Barbara Plundrák (Sn 
Johan Plundrák: 
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okroSova): 
(Huštěnovice 85) - 1847 (Huštěnovice) 


$ténovice 85 
k: HuSténovice 
inek: 
- 1824 
16.08. 


Huštěnovice) 
865 (Jalubí 80) - 21.03.1904 


ice) 
1824 (Jalubí 80) - 17.01.1892 (Jalubí) 
echov) 

862 (Jalubí) 


ubí 80 
bdr2álková) : 01.03.1740 (Jalubí) - ??? 
ubí 


álková): 


ovice) 
echov) - ??? 
- 1799 (Zlechov 26) 


Vávrová): 1776 (HuSténovice 18) - 1856 


énovice 89) 
ténovice 


álková): 07.08.1828 (Traplice 3) 


dlovice) 
03.1871 (Traplice 3) 
Traplice) 


- 1769 (Jalubí) 


61 (Traplice) - 1813 (Traplice) 


raptem 


ek: 

1789 (Kudlovice) - 1858 (Kudlovice) 
1838 (Kudlovice 48 
opková): Kudlovice 9 


1815 (Huštěnovice) - 26.01.1867 


28.06.1797 (Zlechov) - 26.10.1867 


my. writings 


sunbirds song.txt 
WIP 


# The Sunbirds' Song 
v 0.1 


In the animal kingdom, of Africa, there lived together many animals. Some of them were big, like the elephant, some of them were, small, like the. meerkat, some, were 
fast, like the chéetah, and some were very, very slow, like the ever sniffing snake. The animals all lived together, and even though they sometimes fought, they 
could all have good fun most of the time. The small played with the big, the fast played with the slow, and they enjoyed their time under the Africa's hot sun. 


There were also very cute animals like the sunbirds. What? Haven't you heard of the sunbirds?! They are tiny, tiny birds who flap their small wings really fast, 
and drink nectar trom T towers with their long beaks, just like you drink juice with a straw! They are just like hummingbirds, but hummingbirds don't Live here in 
rica, only sunbirds do. 


Sunbirds aren't very strong, they are very small, so small that you might not even notice one if it flew right under your nose! 


One day a Sunbird named Sam was playing with other animals, and he noticed he wasn't as fast as the cheetah who ran like the wind. He couldn't win against him in 
a race. And he also noticed he wasn't às strong as the elephant, who could break trees that stood in his way! And he noticed he couldn't hold his bréath under the 
water as long as his friend hippo could. And so Sam became sad, and a little bit jealous. 


Sam went, back. home and talked to the other sunbirds..He told them: "Sunbirds, my friends, we aren't as strong and fast as the other_animals. Every time we p ay 
games, they win. Wouldn't it be fair if the other animals let us win sometimes?" And the other sunbirds imme ately replied: "Yes! The other animals should let us 
win sometimes, it is only fair!" And they went to the cheetahs, and to the elephants, and to the hippos, and all the other animals, and told them that next time 
they would play games, they must let the sunbirds win at least once every day! And the animals, seeing the sunbirds were very tiny, weak and that they had big 
cute eyes and squeaky voices, told them "well then, from now on we will let you win at least once every day." And so they did. 


Some time passeg in the animal kingdom and.then, one day, Sam the, sunbird.noticed, again that the other, animals had a, lot of good food to eat -- more than he had, 
The lions have hunted all day and had a fridge full of meat for their families. ihe giraffe could reach high up to the top of the tallest trees and could eat ali 
the delicious leaves all day. And the baboons, after working all day, have collected a lot of fruit up in their homes in the trees. And Sam again became a little 
bit jealous, he couldn't hunt and eat meat, he couldn't eat leaves and he couldn't even lift any fruit, let alone collect them! 


And so he went back to his fellow sunbirds again and told them: "Sunbirds, my friends, we are very small and weak and we cannot collect as much delicious food as 
the other animals. The other animals should give us a little bit of their food." And the sunbirds immediately replied: "Yes, they should give us a little bit of. 
their food, that's only fair!". And so they went to the lions, and to the giraffes and to the baboons and other animals, and asked if they could take a little bit 
of their delicious meat, leaves and fruit every single day. And the animals, seeing the poor tiny sunbirds with their big eyes and cute straw-like beaks told 
them: "Alright, sunbirds, you are our friends and so we will give you some of our food every day!" And so they did. 


Some time passed again and one sunny day Sam noticed again something, that he thought wasn't fair. The other animals had better homes. The lions had a big cave 
that was very cool and pretty comfortable when it was Very hot, and the meerkats had dug long tunnels under the ground, in which they lived, and in thesé tunnels 
there was nice cool shade and safety. And a lot of room for p aying hide and seek too! Sunbirds cannot dig under the ground, nor build big houses, they can only 
ever create very small nests that aren't spacey at all and aren't very safe. 


And with this Sam went back to his fellow sunbirds and told them: "Sunbirds, my friends, we are very weak and small and we can't build big houses. Our small nests 
are uncomfortable while other animals live in luxury. They let us live like this, wouldn't it be fair if we exchanged our houses with them for a while?" And the 
sunbirds immediately replied: "Yes, that would only be fair!" And they went and started to sing a song: 


"Sunbirds are small, hear our words, everyone has to be nice to sunbirds!" 


And, they went to the lions and, told them: "Lions, you let us live in, tiny.homes while you were enjoying your_nice big.caye, let us live here for now." And as, the 
sunbirds' song echoed through the jungle, the lion$ became scared, they didn't want to be bad to Sunbirds, all the animals were now sin ing "everyone has to be 
thel 


nice to sunbirds!" And so the lions left their cave and let the sunbirds live in it. And then the sunbirds went to the meerkats and tol m "Meerkats, you have 
lived in your fine underground tunnels and let us, sunbirds, ive in poor tiny homes, let us live in your tunnels for now." And as all the animals in the jungle 
were singing the song "everyone has to be nice to sunbirds!", the meerkats couldn't but leave their home and let the sunbirds live there. 


And the time passed and every new week, the sunbirds noticed something else that wasn't fair. The elephants had their long handy trunks and the sunbirds didn't, so 
the elephants had to tie their trunks like a tie and not use them for anything! That would make the sunbirds sad. The zebras had very nice iooking stripes and the 
sunbirds didn't, so the zebras had to paint their stripes over so that they looked like horses! And the lions had to trim their manes because sunbirds didn't have 
ones. 


In the African kingdom, all animals were now sad -- all except the sunbirds who lived in their big lion cave, who had to win all the games with other animals and 

who were now telling other animals what they couta and couldn't do and even what they could and couldn't say! Sunbirds told other animals that no one would be 

allowed to Sing any other song than the sunbi 
e 


d to t rd song: "everyone has to be nice to sunbirds!" And everyone was afraid to not obey the sunbirds now, and so everyone 
kept singing t sunbirds' song. 


Well, that is except for one small impala named Isabel. Isabel was yery smart and saw that the sunbirds evil rule was gnly possible if all animals were afraid of 
the sunbirds, and So she went and told this to the elephants, the cheetahs, the snakes, the giraffes and the hippos and all the other animals. And together they 
went to the sunbirds' cave and told them: "Sunbirds, we will no longer be singing your song. It is now only hurting everyone, everyone has to serve only you. I 

is true that your sunbirds, are smaller and weaker than most of us other animals and that we should take care of you, but it has gotten too far, everyone is now 
unhappy. You have become only focused on yourself, the sunbirds, and you have forgotten that other animals can feel bad too. And So we will no onger be afraid of 
you, we will allow elephants to use their trunks again and we will all be signing songs that we like, not just your one song." 


And out of the cave came Sam the sunbird. He saw that what Isabel was gaying was true, he suddenly felt ashamed and told her "Oh Isabel, it is true, now I can see 
all of you here and I see you are sad because of us, sunbirds. At first we Only wanted to be as good as you stronger animals, but then we couldn't stop wanting 
more. Now I see everyone is good at something and that it's bad to be only focused on ourselves and not others. I am sorry, Isabel. We will go back to our nests 
and if you animals forgive us, we can play just like before." 


And with this, Isabel and Sam hugged. All other sunbirds came out of the cave and the meerkat underground tunnels and they all together started to sign a new 
song, a song that every animal liked: 


"Big or small we're all the same, let's always play a friendly game." 


And they all went and played together just like before, And from that time on. the stronger animals shared the food with the sunbirds and other small animals too. 
They invited them to their housés regularly, and sometimes even let them win in games. Not because they had to or because they were afraid of them, but simply 
because they were all good friends. 
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